Method: albums.batchAddMediaItems

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

Se agregan elementos multimedia al final del álbum. Si se proporcionan varios elementos multimedia, se agregarán en el orden que se especifique en esta llamada.

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

Solo se pueden agregar a un álbum los elementos multimedia que se encuentran en la biblioteca del usuario. En el caso de los álbumes compartidos, estos deben ser propiedad del usuario o este debe haberse unido al álbum como colaborador.

No se admite el resultado parcial. Si se especifica un álbum o elemento multimedia 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 de 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. Se deben agregar 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.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing