ChannelBanners

channelBanner リソースには、新しくアップロードされた画像をチャンネルのバナー画像として設定する URL が含まれています。

Methods

API は、channelBanners リソースに対して次のメソッドをサポートしています。

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

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

リソース表現

次の JSON 構造は、channelBanners リソースの形式を示しています。

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。

プロパティ
kind string
API リソースのタイプを識別します。値は youtube#channelBannerResource です。
etag etag
このリソースの Etag。
url string
バナー画像の URL。channelBanners.insert メソッドを呼び出した後、API レスポンスからこの値を抽出します。次に、channels.update メソッドを呼び出し、URL を brandingSettings.image.bannerExternalUrl プロパティの値として設定して、チャンネルのバナー画像を設定します。