Method: albums.batchRemoveMediaItems

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

Bei geteilten Alben wird diese Aktion nur für Medienelemente unterstützt, die dem Album von diesem Nutzer hinzugefügt wurden, oder für alle Medienelemente, wenn das Album von diesem Nutzer erstellt wurde.

Teilweise erfolgreiche Aktionen werden nicht unterstützt. Wenn ein ungültiges Medienelement oder Album angegeben wird, schlägt die gesamte Anfrage fehl und es wird keine Aktion auf das Album angewendet.

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 Kennung 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 MediaItem.

Darf keine wiederholten IDs enthalten und darf nicht leer sein. Die maximale Anzahl der Medienelemente, die in einem Aufruf entfernt 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.edit.appcreateddata