跳转到主要内容
當你以自訂 thumbNail 發佈 YouTube 影片時,影片可能發佈成功,但縮圖套用失敗。此時該貼文最外層的 status 仍為 "success"(影片已上線),但 YouTube 結果會帶有描述縮圖失敗的 warnings 陣列:

症狀

你的 YouTube 影片會出現在頻道上,但你所提供的自訂縮圖遺失 — YouTube 改用自動產生的畫格。API 回應會回傳 status: "success",並在 warnings 中有縮圖項目(feature: "thumbnail"code: 307)。

最常見原因:未驗證的頻道

YouTube 縮圖 403 失敗最主要的原因是頻道未驗證。YouTube 必須先完成頻道(電話)驗證,才能接受自訂縮圖上傳。

修復方式:驗證你的頻道

  1. 前往 https://www.youtube.com/verify 為該頻道完成電話驗證
  2. 或在 YouTube Studio 前往 Settings → Channel,選擇 Feature Eligibility,並啟用 Features that require phone verification
  3. YouTube 在驗證後最多可能需要 24 小時才會啟用自訂縮圖。「已啟用」電話驗證並不保證 YouTube 一定會允許縮圖上傳 — 最終仍由 YouTube 決定資格。
  4. 確認你可以在 YouTube Studio 手動上傳縮圖。若你無法手動上傳,API 也無法。

次要原因:OAuth 權限

若你的頻道已驗證但縮圖仍以 403 失敗,連結的 YouTube 帳戶可能缺少必要權限。請嘗試在 Social Accounts取消連結並重新連結 YouTube 帳戶,並在重新連結時授予所有請求的權限。 對於 Brand / Content Owner 帳戶(常用於企業或組織頻道),請確保連結的帳戶擁有必要權限 — 建議使用「Owner」權限。

發佈前的縮圖要求

Ayrshare 會在發佈前盡可能驗證 thumbNail。若要避免 307 縮圖失敗,請確保縮圖符合下列要求:
  • 格式: PNG 或 JPG/JPEG。副檔名必須為 pngjpgjpeg
  • 大小: 2MB 以下。
  • 可存取的 URL: thumbNail URL 必須公開可存取,Ayrshare 才能抓取。
縮圖問題絕對不會導致貼文失敗。若縮圖已確定無效(副檔名錯誤、確定超過 2MB 或無法存取),Ayrshare 會在影片上傳前跳過縮圖,仍會發佈影片,並在 warnings 中回報原因。若失敗只能在影片上傳後才判定,影片會維持上線,並透過前述的 warnings 陣列回報失敗。無論如何,影片都會發佈,且 status 仍會維持為 "success"

相關資料