Nous mettons à jour l'API Data pour qu'elle corresponde à la façon dont YouTube comptabilise les vues des Shorts.
En savoir plus
PlaylistImages: insert
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ajoute une image à une playlist.
Cette méthode est compatible avec l'importation de contenus multimédias. Les fichiers importés doivent respecter les contraintes suivantes:
- Taille maximale des fichiers:2 Mo
- Format accepté:1:1 (carré)
- Types MIME de médias acceptés:
image/jpeg, image/png
Impact sur le quota:un appel à cette méthode a un coût de quota de 50 unités.
Requête
Requête HTTP
POST 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
Ce paramètre ne peut être utilisé que dans une demande correctement autorisée. Remarque:Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube.
Le paramètre onBehalfOfContentOwner indique que les identifiants d'autorisation de la demande identifient un utilisateur du CMS YouTube agissant pour le compte du propriétaire de contenu spécifié dans la valeur du paramètre. Ce paramètre est destiné aux partenaires de contenu YouTube qui possèdent et gèrent de nombreuses chaînes YouTube différentes. Elle permet aux propriétaires de contenu de s'authentifier une fois et d'accéder à toutes les données de leurs vidéos et de leur chaîne, sans avoir à fournir d'identifiants d'authentification pour chaque chaîne. Le compte CMS avec lequel l'utilisateur s'authentifie doit être associé au propriétaire de contenu YouTube spécifié. |
onBehalfOfContentOwnerChannel |
string
Ce paramètre ne peut être utilisé que dans une demande correctement autorisée. Remarque:Ce paramètre est destiné exclusivement aux partenaires de contenu YouTube.
Les
Paramètre onBehalfOfContentOwnerChannel
spécifie l'ID de la chaîne YouTube sur laquelle la vidéo est diffusée.
ajouté. Ce paramètre est obligatoire lorsqu'une requête spécifie une valeur pour le paramètre
onBehalfOfContentOwner, qui ne peut être utilisé que dans
conjointement avec ce paramètre. De plus, la demande doit être
autorisé à l'aide d'un compte CMS associé au propriétaire de contenu
spécifie le paramètre onBehalfOfContentOwner. Enfin, la fonction
canal auquel la valeur du paramètre onBehalfOfContentOwnerChannel a été définie
spécifie doit être associée au propriétaire de contenu
onBehalfOfContentOwner est spécifié.
Ce paramètre
est destiné aux partenaires de contenu YouTube qui possèdent et gèrent
différentes chaînes YouTube. Il permet aux propriétaires de contenu
de s'authentifier une fois
et effectuer des actions pour le compte de la chaîne spécifiée dans le paramètre
sans avoir à fournir d'identifiants d'authentification pour chaque
canal distinct. |
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 API method adds an image to a playlist, supporting media uploads with a maximum file size of 2MB and a 1:1 aspect ratio, and only accepts \u003ccode\u003eimage/jpeg\u003c/code\u003e and \u003ccode\u003eimage/png\u003c/code\u003e MIME types.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method requires authorization 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.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epart\u003c/code\u003e parameter is required to specify the \u003ccode\u003eplaylistImage\u003c/code\u003e resource properties to be included in the API response.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e and \u003ccode\u003eonBehalfOfContentOwnerChannel\u003c/code\u003e parameters are available for YouTube content partners managing multiple channels to authenticate once and access data across all channels.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a \u003ccode\u003eplaylistImages\u003c/code\u003e resource with \u003ccode\u003esnippet.playlistId\u003c/code\u003e and \u003ccode\u003esnippet.type\u003c/code\u003e, and it can include optional \u003ccode\u003esnippet.width\u003c/code\u003e and \u003ccode\u003esnippet.height\u003c/code\u003e properties.\u003c/p\u003e\n"]]],["To add an image to a playlist, send a POST request to `https://www.googleapis.com/youtube/v3/playlistImages`, ensuring authorization with appropriate scopes. Uploaded images must be square (1:1 aspect ratio), under 2MB, and be either JPEG or PNG. The request requires the `part` parameter, and the request body must include `snippet.playlistId` and `snippet.type`. Optional parameters include `onBehalfOfContentOwner` and `onBehalfOfContentOwnerChannel`. A successful call returns a `playlistImages` resource and has a quota cost of 50 units.\n"],null,["# PlaylistImages: insert\n\nAdds an image to a playlist.\n\nThis method supports media upload. Uploaded files must conform to these constraints:\n\n- **Maximum file size:** 2MB\n- **Accepted aspect ratio:** 1:1 (square)\n- **Accepted Media MIME types:** `image/jpeg`, `image/png`\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```\nPOST 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` This parameter can only be used in a properly [authorized request](/youtube/v3/guides/authentication). **Note:** This parameter is intended exclusively for YouTube content partners. The **onBehalfOfContentOwner** parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner. |\n| `onBehalfOfContentOwnerChannel` | `string` This parameter can only be used in a properly [authorized request](/youtube/v3/guides/authentication). **Note:** This parameter is intended exclusively for YouTube content partners. \u003cbr /\u003e The **onBehalfOfContentOwnerChannel** parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the `onBehalfOfContentOwner` parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the `onBehalfOfContentOwner` parameter specifies. Finally, the channel that the `onBehalfOfContentOwnerChannel` parameter value specifies must be linked to the content owner that the `onBehalfOfContentOwner` parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel. |\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 [playlistImages resource](/youtube/v3/docs/playlistImages#resource) in the response body."]]
