En plus d'accessing aux éléments multimédias après les avoir importés, vous pouvez également modifier leur description.
Champ d'application des autorisations requis
Pour modifier les descriptions des éléments multimédias après leur création, utilisez le champ d'application photoslibrary.edit.appcreateddata
.
Modifier les descriptions des éléments multimédias
Pour modifier la description d'un élément multimédia, créez une media items update call
avec l'identifiant de l'élément multimédia et 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 doivent pas dépasser 1 000 caractères.
REST
Voici un en-tête de requête PATCH permettant de mettre à jour 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 en cours de mise à 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 la requête aboutit, 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" }
Java
try { // Update the description of the media item. // The new description must not be null. MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description"); } catch (ApiException e) { // Handle error }
PHP
try { // ID of the media item to update. $mediaItemId = "MEDIA_ITEM_ID"; // New description of the media item. $newDescription = "new-media-item-description"; // Update the description of the media item identified. $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription); } catch (\Google\ApiCore\ApiException $e) { // Handle error }