channelBanner リソースには、新しくアップロードした画像をチャンネルのバナー画像として設定するために使用する URL が含まれています。
メソッド
この 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 に設定します。
リソース表現
次の JSON 構造は、channelBanners リソースの形式を示しています。
{
"kind": "youtube#channelBannerResource",
"etag": etag,
"url": string
}プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
| プロパティ | |
|---|---|
kind |
stringAPI リソースのタイプを識別します。値は youtube#channelBannerResource になります。 |
etag |
etagこのリソースの Etag。 |
url |
stringバナー画像の URL。 channelBanners.insert メソッドを呼び出した後、この値を API レスポンスから抽出します。次に、channels.update メソッドを呼び出し、URL を brandingSettings.image.bannerExternalUrl プロパティの値として設定して、チャンネルのバナー画像を設定します。 |