このページは Cloud Translation API によって翻訳されました。

ChannelBanners: insert

YouTube にチャンネルバナー画像をアップロードします。このメソッドは、チャンネル用のバナー画像を更新する 3 ステップのプロセスのうち、最初の 2 つのステップを示したものです。

channelBanners.insert メソッドを呼び出して、バイナリ画像データを YouTube にアップロードします。画像のアスペクト比は 16:9 で、2048 x 1152 ピクセル以上である必要があります。2,560×1,440 ピクセルの画像をアップロードすることをおすすめします。
ステップ 1 で API が返すレスポンスから url プロパティの値を抽出します。
channels.update メソッドを呼び出して、チャンネルのブランディング設定を更新します。brandingSettings.image.bannerExternalUrl プロパティの値を、手順 2 で取得した URL に設定します。

このメソッドはメディアアップロードをサポートしています。アップロードするファイルには、以下の制約が適用されます。

割り当てへの影響: このメソッドの呼び出しでは、50 ユニットの割り当て費用が発生します。

リクエスト

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。認証と承認の詳細については、OAuth 2.0 承認の実装をご覧ください。

範囲
`https://www.googleapis.com/auth/youtube.upload`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリパラメータです。

パラメータ
オプションパラメータ
`onBehalfOfContentOwner`	`string` このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは YouTube コンテンツパートナー専用です。 `onBehalfOfContentOwner` パラメータは、リクエストの認証情報で、パラメータ値で指定されたコンテンツ所有者の代理で行動している YouTube CMS ユーザーを識別することを示します。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツパートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネルデータにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。

このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。

成功すると、このメソッドはレスポンスの本文で channelBanner リソースを返します。

次の表に、このメソッドの呼び出しに対する応答として API から返される可能性のあるエラーメッセージを示します。詳細については、YouTube Data API - エラーをご覧ください。

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`bannerAlbumFull`	YouTube チャンネルアートアルバムに画像が多すぎます。この問題を解決するには、Google フォトに移動し、アルバムページに移動して、そのアルバムから一部の画像を削除します。
`badRequest (400)`	`mediaBodyRequired`	リクエストに画像コンテンツが含まれていません。

APIs Explorer を使用してこの API を呼び出し、API リクエストとレスポンスを確認します。