Learn about the new Picker API and important Library API changes.
Details here.
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 2024/11/09 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/11/09 (UTC)."],[[["After uploading media items to Google Photos, you can change their descriptions using the Google Photos API."],["Modifying descriptions of app-created content requires the `photoslibrary.edit.appcreateddata` scope and ownership by the authenticated user."],["To update a description, use the `mediaItems/patch` endpoint with the item's ID and a request body containing the new description."],["The `updateMask` parameter in the request URL specifies that only the description is being modified."],["The response to a successful update request will return the complete updated media item object."]]],["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"]]
