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 |
Erforderlich. Die Kennung der |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "mediaItemIds": [ string ] } |
Felder | |
---|---|
mediaItemIds[] |
Erforderlich. IDs der zu entfernenden 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