channelBanner
リソースには、新しくアップロードされた画像をチャンネルのバナー画像として設定するために使用する URL が含まれています。
Methods
API は、channelBanners
リソースについて次のメソッドをサポートしています。
- 挿入
- チャンネル バナー画像を YouTube にアップロードします。このメソッドは、チャンネル用のバナー画像を更新する 3 ステップのプロセスのうち、最初の 2 つのステップを示したものです。
channelBanners.insert
メソッドを呼び出して、バイナリ画像データを YouTube にアップロードします。画像のアスペクト比は 16:9 で、2,048 x 1,152 ピクセル以上にする必要があります。2,560 x 1,440 ピクセルの画像をアップロードすることをおすすめします。- ステップ 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 プロパティの値として設定し、チャンネルのバナー画像を設定します。 |