Method: albums.batchAddMediaItems

Aggiunge uno o più elementi multimediali nella raccolta di Google Foto di un utente a un album. 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 specificati 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 o l'utente deve aver partecipato all'album come collaboratore.

Il successo parziale non è supportato. L'intera richiesta non andrà a buon fine se viene specificato un elemento multimediale o un album non valido.

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