Method: albums.batchAddMediaItems

Agrega uno o más elementos multimedia creados por la app en la biblioteca de Google Fotos de un usuario a un álbum creado por la app. El desarrollador debe haber creado los elementos multimedia y los álbumes a través de la API.

Los elementos multimedia se agregan al final del álbum. Si se proporcionan varios elementos multimedia, se agregan en el orden especificado en esta llamada.

Cada álbum puede contener hasta 20,000 elementos multimedia.

No se admite el éxito parcial. Si se especifica un elemento multimedia o un álbum no válido, fallará toda la solicitud.

Solicitud HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
albumId

string

Obligatorio. Es el identificador del Album al que se agregan los elementos multimedia.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "mediaItemIds": [
    string
  ]
}
Campos
mediaItemIds[]

string

Obligatorio. Son los identificadores de los MediaItem que se agregarán. La cantidad máxima de elementos multimedia que se pueden agregar en una llamada es de 50.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata