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.
Modifier les descriptions des éléments multimédias
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"
}