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 von diesem Nutzer dem Album hinzugefügt wurden, oder für alle Medienelemente, wenn das Album von diesem Nutzer erstellt wurde.

Teilweiser Erfolg wird nicht unterstützt. Die gesamte Anforderung schlägt fehl und es werden keine Aktionen bezüglich des Albums durchgeführt, wenn ein ungültiges Medienelement oder ein ungültiges 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 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 MediaItems.

Darf keine wiederholten Kennungen enthalten und darf nicht leer sein. Die maximale Anzahl der Medienelemente, die in einem Anruf 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