ChannelBanners: insert

將頻道橫幅圖片上傳至 YouTube。這種方法包含三個步驟的更新步驟，用來更新頻道橫幅圖片：

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

這個方法支援媒體上傳。上傳檔案必須符合下列限制：

  • 檔案大小上限：6MB
  • 系統接受的媒體 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 要求和回應。