Method: albums.batchAddMediaItems

Fügt ein oder mehrere Medienelemente aus der Google Fotos-Galerie eines Nutzers einem Album 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.

Nur Medienelemente, die sich in der Mediathek des Nutzers befinden, können einem Album hinzugefügt werden. Bei geteilten Alben muss das Album entweder dem Nutzer gehören oder der Nutzer muss dem Album als Mitbearbeiter beigetreten sein.

Teilweise erfolgreiche Aktionen werden nicht unterstützt. Die gesamte Anfrage schlägt fehl, wenn ein ungültiges Medienelement oder ein ungültiges 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. ID von Album, dem 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
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing