Le 1er avril 2025, certains champs d'application de l'API Library ont été supprimés.
En savoir plus
Gérer les éléments multimédias
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
En plus d'accéder et de récupérer les éléments multimédias après les avoir importés, vous pouvez également modifier leurs descriptions.
Champ d'application de l'autorisation requis
La modification des descriptions des contenus créés par l'application nécessite le champ d'application photoslibrary.edit.appcreateddata. Pour en savoir plus sur les champs d'application, consultez la section Champs d'application d'autorisation.
Pour modifier la description d'un élément multimédia, créez un media items update
call avec l'identifiant de l'élément multimédia, puis incluez la nouvelle description dans la requête.
Pour modifier la description d'un élément multimédia, votre application doit l'avoir importé et l'utilisateur actuellement authentifié doit en être le propriétaire. Les descriptions ne peuvent pas comporter plus de 1 000 caractères.
REST
Voici un en-tête de requête PATCH permettant de modifier la description d'un élément multimédia :
PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description
Cette requête détermine les propriétés mises à jour en incluant un masque de champ, indiqué par le paramètre updateMask dans l'URL.
Incluez la nouvelle description dans le corps de la requête :
{
"description": "new-media-item-description"
}
Si l'opération réussit, la réponse renvoie l'élément multimédia mis à jour :
{
"id": "media-item-id",
"description": "new-media-item-description",
"productUrl": "media-item-product-url",
"baseUrl": "media-items-in-album",
"mimeType": "mime-type-of-media",
"mediaMetadata": {
...
},
"contributorInfo": {
...
},
"fileName": "item-filename"
}
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 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eAfter uploading media items to Google Photos, you can change their descriptions using the Google Photos API.\u003c/p\u003e\n"],["\u003cp\u003eModifying descriptions of app-created content requires the \u003ccode\u003ephotoslibrary.edit.appcreateddata\u003c/code\u003e scope and ownership by the authenticated user.\u003c/p\u003e\n"],["\u003cp\u003eTo update a description, use the \u003ccode\u003emediaItems/patch\u003c/code\u003e endpoint with the item's ID and a request body containing the new description.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eupdateMask\u003c/code\u003e parameter in the request URL specifies that only the description is being modified.\u003c/p\u003e\n"],["\u003cp\u003eThe response to a successful update request will return the complete updated media item object.\u003c/p\u003e\n"]]],["To modify a media item's description, use a `media items update call` with a PATCH request, specifying the item's ID and the `updateMask` parameter. Include the new description in the request body, ensuring it's under 1,000 characters. This requires the `photoslibrary.edit.appcreateddata` scope, with the app having uploaded the media, and the authenticated user must be the owner. A successful request returns the updated media item details, including the new description.\n"],null,["# Manage media items\n\nIn addition to [accessing and\nretrieving](/photos/library/guides/access-media-items) media items after you\n[upload](/photos/library/guides/upload-media) them, you can also change their\ndescriptions.\n\nRequired authorization scope\n----------------------------\n\nChanging descriptions of app-created content requires the\n`photoslibrary.edit.appcreateddata` scope. For more information on scopes, see\n[Authorization scopes](/photos/overview/authorization).\n\nChanging media item descriptions\n--------------------------------\n\nTo change a media item's description, make a [`media items update\ncall`](/photos/library/reference/rest/v1/mediaItems/patch) with the identifier\nof the media item, and include the new description in the request.\n\nTo change a media item's description, your app must have uploaded the media\nitem, and the currently authenticated user must be the owner. Descriptions can\nbe no more than 1,000 characters in length. \n\n### REST\n\nHere's a PATCH request header to update a media item description: \n\n```\nPATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description\n```\n\nThis request determines what properties are being updated by including a\nfield mask, indicated by the `updateMask` parameter in the URL.\n\nInclude the new description in the body of the request: \n\n```restructuredtext\n{\n \"description\": \"new-media-item-description\"\n}\n```\n\nIf successful, the response returns the updated media item: \n\n```restructuredtext\n{\n \"id\": \"media-item-id\",\n \"description\": \"\u003cvar translate=\"no\"\u003enew-media-item-description\u003c/var\u003e\",\n \"productUrl\": \"media-item-product-url\",\n \"baseUrl\": \"media-items-in-album\",\n \"mimeType\": \"mime-type-of-media\",\n \"mediaMetadata\": {\n ...\n },\n \"contributorInfo\": {\n ...\n },\n \"fileName\": \"\u003cvar translate=\"no\"\u003eitem-filename\u003c/var\u003e\"\n}\n```"]]
