ChannelBanners

channelBanner 資源包含網址，可用於將新上傳的圖片設為頻道的橫幅圖片。

方法

這個 API 支援 channelBanners 資源的下列方法：

插入
將頻道橫幅圖片上傳至 YouTube。這個方法代表更新頻道橫幅圖片的三步驟程序中前兩個步驟：
  1. 呼叫 channelBanners.insert 方法，將二進位圖片資料上傳至 YouTube。圖片的長寬比必須為 16:9，且尺寸至少為 2048 x 1152 像素。建議上傳 2560 x 1440 像素的圖片。
  2. 從 API 為步驟 1 傳回的回應中，擷取 url 屬性的值。
  3. 呼叫 channels.update 方法，更新頻道的品牌宣傳元素設定。將 brandingSettings.image.bannerExternalUrl 屬性的值設為在步驟 2 中取得的網址。

資源表示法

以下 JSON 結構顯示 channelBanners 資源的格式：

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

屬性

下表定義了這個資源中顯示的屬性：

屬性
kind string
識別 API 資源的類型。值為 youtube#channelBannerResource。
etag etag
這項資源的 Etag。
url string
橫幅圖片的網址。呼叫 channelBanners.insert 方法後，請從 API 回應中擷取這個值。接著呼叫 channels.update 方法，並將網址設為 brandingSettings.image.bannerExternalUrl 屬性的值，以設定頻道的橫幅圖片。