PlaylistImages: update
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Modifie l'image d'une playlist.
Impact sur le quota:un appel à cette méthode a un coût de quota de 50 unités.
Requête
Requête HTTP
PUT https://www.googleapis.com/youtube/v3/playlistImages
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
| Champ d'application |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Paramètres
Le tableau suivant répertorie les paramètres compatibles avec cette requête. Tous les paramètres listés sont des paramètres de requête.
| Paramètres |
| Paramètres obligatoires |
part |
string
Le paramètre part spécifie
liste d'une ou plusieurs ressources playlistImage séparées par une virgule
que la réponse de l'API inclue.
Si le paramètre
identifie une propriété qui contient les propriétés enfants, les propriétés enfants
sera incluse dans la réponse.
|
| Paramètres facultatifs |
onBehalfOfContentOwner |
string
Remarque:Le paramètre onBehalfOfContentOwner est destiné exclusivement aux partenaires de contenu YouTube. Il ne peut être utilisé que dans le cadre d'une demande autorisée correctement.
Il est conçu pour les partenaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Il permet aux utilisateurs affiliés au propriétaire de contenu de s'authentifier une fois, puis de consulter et de gérer toutes les données vidéo et de chaîne du propriétaire de contenu, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne.
Lorsque ce paramètre est présent, sa valeur identifie un propriétaire de contenu, et les identifiants d'autorisation de la demande identifient un utilisateur YouTube autorisé à agir en son nom. Le compte avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu spécifié dans les paramètres de YouTube Creator Studio. |
Corps de la requête
Fournissez une ressource "playlistImages" dans le corps de la requête.
Pour cette ressource:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/16 (UTC).
[null,null,["Dernière mise à jour le 2024/08/16 (UTC)."],[[["\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."]]
