Method: albums.batchAddMediaItems

Aggiunge a un album uno o più elementi multimediali della raccolta 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. Gli album condivisi devono essere di proprietà dell'utente oppure quest'ultimo deve aver partecipato all'album come collaboratore.

L'operazione riuscita parziale non è supportata. Se viene specificato un album o un elemento multimediale 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 del 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