Administra los elementos multimedia

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

Alcance de autorización obligatorio

Para cambiar las descripciones del contenido creado por la app, se requiere el permiso photoslibrary.edit.appcreateddata. Para obtener más información sobre los alcances, consulta Alcances de autorización.

Cambia las descripciones de los elementos multimedia

Para cambiar la descripción de un elemento multimedia, crea un 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 haberlo subido, y el usuario autenticado actualmente debe ser el propietario. Las descripciones no pueden tener más de 1,000 caracteres.

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 qué propiedades se actualizan, ya que incluye una máscara de campo, que se indica con 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 realiza 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"
}