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 |
Erforderlich. Die ID der |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "mediaItemIds": [ string ] } |
Felder | |
---|---|
mediaItemIds[] |
Erforderlich. IDs der hinzuzufügenden |
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