我們正在更新 Data API，以符合 YouTube 計算 Shorts 觀看次數的方式。
瞭解詳情
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.playlistIdsnippet.type
-
您可以設定這些屬性的值：
snippet.widthsnippet.height
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-08-16 (世界標準時間)。
[null,null,["上次更新時間：2024-08-16 (世界標準時間)。"],[[["\u003cp\u003eThis method allows modification of a playlist image via the YouTube API.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing this method incurs a quota cost of 50 units per call.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required, with scopes such as \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e, \u003ccode\u003ehttps://www.googleapis.com/auth/youtube\u003c/code\u003e, or \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.force-ssl\u003c/code\u003e being necessary.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter is required, while \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e is an optional parameter intended for YouTube content partners.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a \u003ccode\u003eplaylistImages\u003c/code\u003e resource with specified values for \u003ccode\u003esnippet.playlistId\u003c/code\u003e and \u003ccode\u003esnippet.type\u003c/code\u003e, and can optionally include \u003ccode\u003esnippet.width\u003c/code\u003e and \u003ccode\u003esnippet.height\u003c/code\u003e.\u003c/p\u003e\n"]]],["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"],null,["# PlaylistImages: update\n\nModifies a playlist image.\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 50 units.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/youtube/v3/playlistImages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/guides/authentication)).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter specifies a comma-separated list of one or more `playlistImage` resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. |\n| **Optional parameters** |||\n| `onBehalfOfContentOwner` | `string` **Note:** The **onBehalfOfContentOwner** parameter is intended exclusively for YouTube content partners and can only be used in a properly [authorized request](/youtube/v3/guides/authentication). This parameter is designed for YouTube content partners that own and manage many different YouTube channels. It enables users affiliated with the content owner to authenticate once and then be able to access and manage all of the content owner's video and channel data, without having to provide authentication credentials for each individual channel. When the parameter is present, its value identifies a content owner, and the request's authorization credentials identify a YouTube user who is authorized to act on behalf of that content owner. The account that the user authenticates with must be [linked to the specified content owner](https://support.google.com/youtube/answer/4524878) in the YouTube Creator Studio settings. |\n\n### Request body\n\nProvide a [playlistImages resource](/youtube/v3/docs/playlistImages#resource) in the request body.\n\nFor that resource:\n\n- You must specify a value for these properties:\n\n - `snippet.playlistId`\n - `snippet.type`\n- You can set values for these properties:\n\n - `snippet.width`\n - `snippet.height`\n\nResponse\n--------\n\nIf successful, this method returns a [playlistItem resource](/youtube/v3/docs/playlistImages#resource) in the response body."]]
