Method: albums.batchRemoveMediaItems

Entfernt ein oder mehrere Medienelemente aus dem angegebenen Album. Die Medienelemente und das Album müssen vom Entwickler über die API erstellt worden sein.

Bei geteilten Alben wird diese Aktion nur bei Medienelementen unterstützt, die dem Album von diesem Nutzer hinzugefügt wurden, oder bei allen Medienelementen, die von diesem Nutzer erstellt wurden.

Teilweiser Erfolg wird nicht unterstützt. Die gesamte Anforderung schlägt fehl und es wird keine Aktion für das Album ausgeführt, wenn ein ungültiges Medienelement oder Album angegeben wird.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
albumId

string

Erforderlich. Die ID der Album, aus der die Medienelemente entfernt werden sollen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string

Erforderlich. IDs der zu entfernenden MediaItems.

Darf keine wiederholten Kennzeichnungen enthalten und darf nicht leer sein. Pro Aufruf können maximal 50 Medienelemente entfernt werden.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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