> ## 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"`，并附带一个 thumbnail 的 `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 Post API —— 缩略图](/apis/post/social-networks/youtube#youtube-thumbnails)
* [YouTube 媒体指南](/media-guidelines/youtube#thumbnails)
* [错误码 —— Code 307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)