Gérer les éléments multimédias

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
}