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 資源。