Method: albums.batchAddMediaItems

Fügt einem Album ein oder mehrere Medienelemente aus der Google Fotos-Galerie eines Nutzers hinzu. Die Medienelemente und Alben müssen vom Entwickler über die API erstellt worden sein.

Medienelemente werden am Ende des Albums hinzugefügt. Sind mehrere Medienelemente angegeben, werden sie in der in diesem Aufruf angegebenen Reihenfolge hinzugefügt.

Jedes Album kann bis zu 20.000 Medienelemente enthalten.

Einem Album können nur Medienelemente hinzugefügt werden, die sich in der Mediathek des Nutzers befinden. Bei geteilten Alben muss der Nutzer entweder der Eigentümer des Albums sein oder dem Album als Mitbearbeiter beigetreten sein.

Teilweiser Erfolg wird nicht unterstützt. Die gesamte Anforderung schlägt fehl, wenn ein ungültiges Medienelement oder Album angegeben wird.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
albumId

string

Erforderlich. Die ID der Album, der die Medienelemente hinzugefügt werden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "mediaItemIds": [
    string
  ]
}
Felder
mediaItemIds[]

string

Erforderlich. IDs der hinzuzufügenden MediaItem. Pro Anruf können maximal 50 Medienelemente hinzugefügt werden.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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