Method: albums.batchAddMediaItems

Aggiunge a un album uno o più elementi multimediali presenti nella raccolta di Google Foto di un utente. Gli elementi multimediali e gli album devono essere stati creati dallo sviluppatore tramite l'API.

Gli elementi multimediali vengono aggiunti alla fine dell'album. Se vengono forniti più elementi multimediali, questi vengono aggiunti nell'ordine specificato in questa chiamata.

Ogni album può contenere fino a 20.000 elementi multimediali.

Solo gli elementi multimediali presenti nella raccolta dell'utente possono essere aggiunti a un album. Per gli album condivisi, l'album deve essere di proprietà dell'utente oppure l'utente deve essersi unito all'album come collaboratore.

L'esito positivo parziale non è supportato. Se viene specificato un elemento multimediale o un album non valido, l'intera richiesta avrà esito negativo.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
albumId

string

Obbligatorio. Identificatore di Album a cui vengono aggiunti gli elementi multimediali.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "mediaItemIds": [
    string
  ]
}
Campi
mediaItemIds[]

string

Obbligatorio. Identificatori dei MediaItem da aggiungere. Il numero massimo di elementi multimediali che è possibile aggiungere in una chiamata è 50.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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