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
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-16 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-08-16 (世界標準時間)。"],[[["This method allows modification of a playlist image via the YouTube API."],["Utilizing this method incurs a quota cost of 50 units per call."],["Authorization is required, with scopes such as `https://www.googleapis.com/auth/youtubepartner`, `https://www.googleapis.com/auth/youtube`, or `https://www.googleapis.com/auth/youtube.force-ssl` being necessary."],["The `part` parameter is required, while `onBehalfOfContentOwner` is an optional parameter intended for YouTube content partners."],["The request body must contain a `playlistImages` resource with specified values for `snippet.playlistId` and `snippet.type`, and can optionally include `snippet.width` and `snippet.height`."]]],["This outlines how to modify a playlist image via the YouTube API. A `PUT` request is sent to `playlistImages`, costing 50 quota units. Authorization is required, utilizing scopes like `youtubepartner`. The request needs the `part` parameter and can optionally include `onBehalfOfContentOwner`. The request body requires `snippet.playlistId` and `snippet.type` properties and can optionally have `snippet.width` and `snippet.height` set. A successful request returns a `playlistItem` resource.\n"]]