channelBanner
リソースには、チャンネル用のバナー画像として新しくアップロードされた画像を設定するために使用する URL が含まれています。
メソッド
この API では、channelBanners
リソースについて以下のメソッドがサポートされています。
- insert
- YouTube にチャンネル バナー画像をアップロードします。このメソッドは、チャンネル用のバナー画像を更新する 3 ステップのプロセスのうち、最初の 2 つのステップを示したものです。
channelBanners.insert
メソッドを呼び出し、バイナリ画像データを YouTube にアップロードします。画像は 16:9 のアスペクト比で、少なくとも 2120 x 1192 ピクセル必要です。- ステップ 1 で API が返す応答から
url
プロパティ値を抽出します。 - チャンネルのブランディング設定を更新する
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 プロパティの値として設定して、チャンネルのバナー画像を設定します。 |