ChannelBanners: insert

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

  1. 呼叫 channelBanners.insert 方法，將二進位圖片資料上傳至 YouTube。圖片的長寬比必須為 16:9，尺寸至少 2048x1152 像素。建議上傳 2560 x 1440 像素的圖片。
  2. 從 API 針對步驟 1 傳回的回應中擷取 url 屬性值。
  3. 呼叫 channels.update 方法，更新頻道的品牌宣傳設定。將 brandingSettings.image.bannerExternalUrl 屬性的值設為步驟 2 中取得的網址。

這個方法支援媒體上傳功能。上傳的檔案必須符合下列條件：

  • 檔案大小上限：6 MB
  • 接受的媒體 MIME 類型： image/jpeg、image/png、application/octet-stream

配額影響：呼叫這個方法的配額費用為 50 個單位。

要求

HTTP 要求

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

授權

這項要求需要至少下列其中一個範圍的授權 (進一步瞭解驗證和授權)。

內容範圍
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

參數

下表列出此查詢支援的參數。這裡列出的參數全都是查詢參數。

參數
選用參數
onBehalfOfContentOwner string
這個參數只能在正確的授權要求中使用。注意：這個參數僅適用於 YouTube 內容合作夥伴。

onBehalfOfContentOwner 參數代表透過要求的授權憑證，代表 YouTube CMS 使用者，代表在參數值中指定的內容擁有者擔任代理人。這個參數適用於擁有及管理多個不同 YouTube 頻道的 YouTube 內容合作夥伴。內容擁有者只要通過一次驗證，即可存取所有影片和頻道資料，不必分別提供各個頻道的驗證憑證。用於驗證的 CMS 帳戶，必須連結至指定的 YouTube 內容擁有者。

要求主體

呼叫此方法時，不要提供要求主體。

回應

成功的話，這個方法會在回應主體中傳回 channelBanner 資源。

錯誤

下表列出 API 回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息的說明文件。

錯誤類型 錯誤詳細資料 說明
badRequest (400) bannerAlbumFull 您的 YouTube 頻道圖片相簿有太多圖片，請前往 http://photos.google.com，前往相簿頁面，然後從該相簿中移除部分圖片。
badRequest (400) mediaBodyRequired 這項要求不包含圖片內容。

試試看！

使用 APIs Explorer 呼叫這個 API 並查看 API 要求和回應。