Method: albums.batchAddMediaItems

Agrega uno o más elementos multimedia de la biblioteca de Google Fotos de un usuario a un álbum. 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.

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, el usuario debe ser el propietario o debe haberse unido al álbum como colaborador.

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
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata