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 屬性的值，以設定頻道的橫幅圖片。