> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube 縮圖未套用（未驗證頻道）

> 你的 YouTube 影片成功發佈，但自訂縮圖遺失。最常見的原因是 YouTube 頻道尚未驗證。

當你以自訂 `thumbNail` 發佈 YouTube 影片時，影片可能發佈成功，但縮圖套用失敗。此時該貼文最外層的 `status` 仍為 `"success"`（影片已上線），但 YouTube 結果會帶有描述縮圖失敗的 `warnings` 陣列:

```json theme={"system"}
{
  "status": "success",
  "id": "<videoId>",
  "thumbnail": {
    "action": "post",
    "status": "error",
    "code": 307,
    "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
    "details": "<upstream message>"
  },
  "warnings": [
    {
      "feature": "thumbnail",
      "code": 307,
      "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
      "details": "<upstream message>"
    }
  ]
}
```

## 症狀

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

## 最常見原因：未驗證的頻道

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

### 修復方式：驗證你的頻道

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

## 次要原因：OAuth 權限

若你的頻道**已驗證**但縮圖仍以 `403` 失敗，連結的 YouTube 帳戶可能缺少必要權限。請嘗試在 [Social Accounts](https://app.ayrshare.com/social-accounts) 中**取消連結並重新連結** YouTube 帳戶，並在重新連結時授予所有請求的權限。

對於 Brand / Content Owner 帳戶（常用於企業或組織頻道），請確保連結的帳戶擁有必要權限 — 建議使用「Owner」權限。

## 發佈前的縮圖要求

Ayrshare 會在發佈前盡可能驗證 `thumbNail`。若要避免 `307` 縮圖失敗，請確保縮圖符合下列要求:

<ul class="custom-bullets">
  <li>**格式：** PNG 或 JPG/JPEG。副檔名必須為 <code>png</code>、<code>jpg</code> 或 <code>jpeg</code>。</li>
  <li>**大小：** 2MB 以下。</li>
  <li>**可存取的 URL：** <code>thumbNail</code> URL 必須公開可存取，Ayrshare 才能抓取。</li>
</ul>

縮圖問題絕對不會導致貼文失敗。若縮圖已確定無效（副檔名錯誤、確定超過 2MB 或無法存取），Ayrshare 會在影片上傳前跳過縮圖，仍會發佈影片，並在 `warnings` 中回報原因。若失敗只能在影片上傳後才判定，影片會維持上線，並透過前述的 `warnings` 陣列回報失敗。無論如何，影片都會發佈，且 `status` 仍會維持為 `"success"`。

## 相關資料

* [YouTube 發文 API — 縮圖](/apis/post/social-networks/youtube#youtube-thumbnails)
* [YouTube 媒體規範](/media-guidelines/youtube#thumbnails)
* [錯誤代碼 — 代碼 307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)