Administra los elementos multimedia

Además de accessing a los elementos multimedia después de subirlos, también puedes cambiar sus descripciones.

Alcance de la autorización requerido

Para cambiar las descripciones de los elementos multimedia después de su creación, usa el alcance photoslibrary.edit.appcreateddata.

Cómo cambiar las descripciones de los elementos multimedia

Para cambiar la descripción de un elemento multimedia, crea una media items update call con el identificador del elemento multimedia y, luego, incluye la descripción nueva en la solicitud.

Para cambiar la descripción de un elemento multimedia, tu app debe haber subido ese elemento, y el usuario autenticado actualmente debe ser el propietario. Las descripciones no pueden tener más de 1,000 caracteres de longitud.

REST

A continuación, se muestra un encabezado de solicitud PATCH para actualizar la descripción de un elemento multimedia:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

Esta solicitud determina qué propiedades se actualizan mediante la inclusión de una máscara de campo, indicada por el parámetro updateMask en la URL.

Incluye la descripción nueva en el cuerpo de la solicitud:

{
  "description": "new-media-item-description"
}

Si se ejecuta correctamente, la respuesta mostrará el elemento multimedia actualizado:

{
  "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
}