PlaylistImages: update

修改播放清單圖片。

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

要求

HTTP 要求

PUT 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
注意:onBehalfOfContentOwner 參數僅適用於 YouTube 內容合作夥伴,且只能在適當的授權要求中使用。

這個參數適用於擁有及管理多個不同 YouTube 頻道的 YouTube 內容合作夥伴。與內容擁有者結盟的使用者只要進行驗證一次,就能存取及管理該內容擁有者的所有影片和頻道資料,而不需要分別提供各頻道的驗證憑證。

透過參數設定參數時,其值可用來識別內容擁有者,而要求的授權憑證則可識別有權代表該內容擁有者的 YouTube 使用者。使用者驗證的帳戶必須在 YouTube 創作者工作室設定中連結到指定內容擁有者

要求主體

在要求主體中提供 playlistImages 資源

針對該資源:

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

    • snippet.playlistId
    • snippet.type
  • 您可以設定這些屬性的值:

    • snippet.width
    • snippet.height

回應

如果成功,這個方法會在回應內文中傳回 playlistItem 資源