> ## 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チャンネル**です。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:** Ayrshareが取得できるように、<code>thumbNail</code>のURLは公開アクセス可能である必要があります。</li>
</ul>

サムネイルの問題は投稿を失敗させることはありません。サムネイルが明確に無効な場合(誤った拡張子、確認済みの2MB超過、またはアクセス不能)、Ayrshareは動画をアップロードする前にスキップし、動画は引き続き公開され、理由は`warnings`で報告されます。動画のアップロード後にのみ失敗が判明する場合、動画は公開されたままで、失敗は上記の同じ`warnings`配列を介して表示されます。いずれの場合も、動画は公開され、`status`は`"success"`のままです。

## 関連情報

* [YouTube Post API — サムネイル](/apis/post/social-networks/youtube#youtube-thumbnails)
* [YouTubeメディアガイドライン](/media-guidelines/youtube#thumbnails)
* [エラーコード — コード307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)