ChannelBanners

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

方法

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

插入
將頻道橫幅圖片上傳到 YouTube。這個方法代表在三個步驟中更新頻道橫幅圖片的前兩個步驟：

  1. 呼叫 channelBanners.insert 方法，將二進位圖片資料上傳至 YouTube。圖片的長寬比必須為 16:9，尺寸至少 2048x1152 像素。建議上傳 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 屬性的值，以便設定頻道的橫幅圖片。