Administra los elementos multimedia

Además de acceder al contenido multimedia Después de subirlos, puedes también cambian sus descripciones.

Alcance de autorización requerido

Para cambiar las descripciones de los elementos multimedia luego de su creación, usa el Permiso de photoslibrary.edit.appcreateddata.

Cambia 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 nueva descripción en el para cada solicitud.

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

REST

Este es 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 las propiedades que se actualizan al incluir un máscara de campo, indicada por el parámetro updateMask en la URL.

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

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

Si se ejecuta correctamente, la respuesta muestra 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
}