Gérer les éléments multimédias

En plus d'accéder aux contenus multimédias articles après les avoir importés, vous pouvez modifier également leurs descriptions.

Champ d'application de l'autorisation requis

Pour modifier la description des éléments multimédias après leur création, utilisez les photoslibrary.edit.appcreateddata.

Modifier les descriptions des éléments multimédias

Pour modifier la description d'un élément multimédia, media items update call par l'identifiant de l'élément multimédia et inclure la nouvelle description dans le champ requête.

Pour que vous puissiez 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 peuvent ne 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 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
}