Method: albums.batchAddMediaItems

Fügen Sie einem Album mindestens ein Medienelement aus 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.

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

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