thumbNail 發佈 YouTube 影片時,影片可能發佈成功,但縮圖套用失敗。此時該貼文最外層的 status 仍為 "success"(影片已上線),但 YouTube 結果會帶有描述縮圖失敗的 warnings 陣列:
症狀
你的 YouTube 影片會出現在頻道上,但你所提供的自訂縮圖遺失 — YouTube 改用自動產生的畫格。API 回應會回傳status: "success",並在 warnings 中有縮圖項目(feature: "thumbnail",code: 307)。
最常見原因:未驗證的頻道
YouTube 縮圖403 失敗最主要的原因是頻道未驗證。YouTube 必須先完成頻道(電話)驗證,才能接受自訂縮圖上傳。
修復方式:驗證你的頻道
- 前往 https://www.youtube.com/verify 為該頻道完成電話驗證。
- 或在 YouTube Studio 前往 Settings → Channel,選擇 Feature Eligibility,並啟用 Features that require phone verification。
- YouTube 在驗證後最多可能需要 24 小時才會啟用自訂縮圖。「已啟用」電話驗證並不保證 YouTube 一定會允許縮圖上傳 — 最終仍由 YouTube 決定資格。
- 確認你可以在 YouTube Studio 手動上傳縮圖。若你無法手動上傳,API 也無法。
次要原因:OAuth 權限
若你的頻道已驗證但縮圖仍以403 失敗,連結的 YouTube 帳戶可能缺少必要權限。請嘗試在 Social Accounts 中取消連結並重新連結 YouTube 帳戶,並在重新連結時授予所有請求的權限。
對於 Brand / Content Owner 帳戶(常用於企業或組織頻道),請確保連結的帳戶擁有必要權限 — 建議使用「Owner」權限。
發佈前的縮圖要求
Ayrshare 會在發佈前盡可能驗證thumbNail。若要避免 307 縮圖失敗,請確保縮圖符合下列要求:
- 格式: PNG 或 JPG/JPEG。副檔名必須為
png、jpg或jpeg。 - 大小: 2MB 以下。
- 可存取的 URL:
thumbNailURL 必須公開可存取,Ayrshare 才能抓取。
warnings 中回報原因。若失敗只能在影片上傳後才判定,影片會維持上線,並透過前述的 warnings 陣列回報失敗。無論如何,影片都會發佈,且 status 仍會維持為 "success"。