thumbNailを使用してYouTube動画を投稿すると、動画は正常に公開されるものの、サムネイルの適用に失敗する場合があります。この場合、投稿のトップレベルのstatusは"success"のまま(動画は公開されています)で、YouTubeの結果にはサムネイルの失敗を説明するwarnings配列が含まれます:
症状
YouTube動画はチャンネルに表示されますが、指定したカスタムサムネイルがなく、YouTubeが代わりに自動生成のフレームを使用します。APIレスポンスはstatus: "success"とサムネイルのwarningsエントリ(feature: "thumbnail"、code: 307)を返します。
最も一般的な原因: 認証されていないチャンネル
YouTubeサムネイルの403失敗の主な原因は、認証されていないYouTubeチャンネルです。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: Ayrshareが取得できるように、
thumbNailのURLは公開アクセス可能である必要があります。
warningsで報告されます。動画のアップロード後にのみ失敗が判明する場合、動画は公開されたままで、失敗は上記の同じwarnings配列を介して表示されます。いずれの場合も、動画は公開され、statusは"success"のままです。
