- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
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 |
Obligatorio. Es el identificador de |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "mediaItemIds": [ string ] } |
Campos | |
---|---|
mediaItemIds[] |
Obligatorio. Se deben agregar los identificadores de los |
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