メインコンテンツへスキップ
カスタムthumbNailを使用してYouTube動画を投稿すると、動画は正常に公開されるものの、サムネイルの適用に失敗する場合があります。この場合、投稿のトップレベルのstatus"success"のまま(動画は公開されています)で、YouTubeの結果にはサムネイルの失敗を説明するwarnings配列が含まれます:

症状

YouTube動画はチャンネルに表示されますが、指定したカスタムサムネイルがなく、YouTubeが代わりに自動生成のフレームを使用します。APIレスポンスはstatus: "success"とサムネイルのwarningsエントリ(feature: "thumbnail"code: 307)を返します。

最も一般的な原因: 認証されていないチャンネル

YouTubeサムネイルの403失敗の主な原因は、認証されていないYouTubeチャンネルです。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。ファイル拡張子はpngjpg、またはjpegで終わる必要があります。
  • サイズ: 2MB以下。
  • アクセス可能なURL: Ayrshareが取得できるように、thumbNailのURLは公開アクセス可能である必要があります。
サムネイルの問題は投稿を失敗させることはありません。サムネイルが明確に無効な場合(誤った拡張子、確認済みの2MB超過、またはアクセス不能)、Ayrshareは動画をアップロードする前にスキップし、動画は引き続き公開され、理由はwarningsで報告されます。動画のアップロード後にのみ失敗が判明する場合、動画は公開されたままで、失敗は上記の同じwarnings配列を介して表示されます。いずれの場合も、動画は公開され、status"success"のままです。

関連情報