Method: albums.batchAddMediaItems

Fügen Sie einem von einer App erstellten Album ein oder mehrere von einer App erstellte Medienelemente in der Google Fotos-Mediathek 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. Wenn mehrere Medienelemente angegeben sind, werden sie in der in diesem Aufruf angegebenen Reihenfolge hinzugefügt.

Jedes Album kann bis zu 20.000 Medienelemente enthalten.

Teilweise erfolgreiche Aktionen werden nicht unterstützt. Wenn ein ungültiges Medienelement oder Album angegeben wird, schlägt die gesamte Anfrage fehl.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
albumId

string

Erforderlich. Kennung 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 MediaItems. Die maximale Anzahl von Medienelementen, die in einem Aufruf hinzugefügt werden können, beträgt 50.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata