PlaylistImages: insert

將圖片加入播放清單。

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

  • 檔案大小上限：2MB
  • 接受的長寬比：1:1 (正方形)
  • 接受的媒體 MIME 類型： image/jpeg、image/png

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

要求

HTTP 要求

POST https://www.googleapis.com/youtube/v3/playlistImages

授權

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

範圍
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

參數

下表列出這個查詢支援的參數。這裡列出的所有參數都是查詢參數。

參數
必要參數
part string

part 參數會指定 包含一或多項 playlistImage 資源的清單 (以半形逗號分隔) API 回應包含的屬性。

如果參數 會識別內含子屬性的屬性，也就是子屬性 。
選用參數
onBehalfOfContentOwner string
這個參數只能用於正確的授權請求。注意：這個參數僅適用於 YouTube 內容合作夥伴。

onBehalfOfContentOwner 參數代表要求的授權憑證可識別 YouTube CMS 使用者，這些使用者是代表參數值中指定的內容擁有者。這個參數適用於擁有並管理許多不同 YouTube 頻道的 YouTube 內容合作夥伴。內容擁有者只要進行驗證一次，就能存取所有的影片和頻道資料，不必分別提供各個頻道的驗證憑證。使用者驗證的 CMS 帳戶必須連結至指定的 YouTube 內容擁有者。
onBehalfOfContentOwnerChannel string
這個參數只能用於正確的授權請求。注意：這個參數僅適用於 YouTube 內容合作夥伴。

onBehalfOfContentOwnerChannel 參數 指明影片所屬頻道的 YouTube 頻道 ID 已新增。要求指定 onBehalfOfContentOwner 參數，且只能用於 傳送給該參數此外，請求 授權的內容管理系統 (CMS 帳戶) 已連結至 onBehalfOfContentOwner 參數會指定。最後， onBehalfOfContentOwnerChannel 參數值的管道 指明必須連結至該內容擁有者的 onBehalfOfContentOwner 參數會指定。

這是 參數適用於擁有並管理的 YouTube 內容合作夥伴 不同的 YouTube 頻道內容擁有者可透過一次驗證 並代表參數中指定的管道 值，而無須為每個應用程式提供驗證憑證 。

要求主體

在要求主體中提供 playlistImages 資源。

針對該資源：

  • 您必須指定這些屬性的值：

    • snippet.playlistId
    • snippet.type

  • 您可以設定這些屬性的值：

    • snippet.width
    • snippet.height

回應

如果成功的話，這個方法會在回應內文中傳回 playlistImages 資源。