channelBanner
資源包含網址,您可以將新上傳的圖片設為頻道的橫幅圖片。
方法
這個 API 支援下列 channelBanners
資源的方法:
- 插入
- 將頻道橫幅圖片上傳至 YouTube。這種方法包含三個步驟的更新步驟,用來更新頻道橫幅圖片:
- 呼叫
channelBanners.insert
方法,將二進位圖片資料上傳至 YouTube。圖片的長寬比必須為 16:9,且大小至少為 2048x1152 像素。建議您上傳 2560 x 1440 像素的圖片。 - 從 API 為步驟 1 傳回的回應擷取
url
屬性值。 - 呼叫
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 屬性的值,以設定頻道的橫幅圖片。 |