Listings APIListings API
Anmelden
POST/api/v4/locations/photos/remove

Fotos von einem Standort entfernen

Entfernt die Zuordnung einer oder mehrerer Mediendateien zu einem Standort anhand ihrer Medien-IDs.

Erfordert einen API-Schlüssel. Format des Headers und Schlüsselrotation finden Sie unter Authentifizierung.

Parameter

Body

NameTypErforderlichBeschreibung
input.locationIdstringerforderlichThe location's Base64-encoded Relay ID the photos belong to.
input.photoIdsarray of stringserforderlichMedia file IDs to detach from the location (as returned by the get-photos or upload endpoints).

Beispielanfrage

Body zum direkten Einfügen. Ersetzen Sie Platzhalter-IDs und -Werte durch Ihre eigenen.

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "photoIds": [      "TWVkaWFGaWxlOjU4Nzg5MzI="    ]  }}

Antworten

200Photos removed. `removedCount` reports how many media files were detached.
Response
{  "data": {    "removeLocationPhotos": {      "clientMutationId": null,      "removedCount": 1,      "errors": null    }  }}
401Unauthenticated, missing or invalid API key.

Entfernt die Zuordnung von Medien zu einem Standort. Geben Sie die zu entfernenden Dateien über photoIds an (die IDs, die von den get-photos- oder Upload-Endpunkten zurückgegeben werden). Der Wert von removedCount in der Antwort gibt an, für wie viele Dateien die Zuordnung tatsächlich entfernt wurde, sodass Sie IDs erkennen können, deren Zuordnung bereits entfernt war.

Anwendungsfall: veraltete Fotos der Ladenfront entfernen. Rufen Sie nach einem Umbau die Fotos des Standorts ab, wählen Sie die veralteten zusätzlichen Bilder aus und übergeben Sie deren IDs in photoIds, um sie mit einem einzigen Aufruf plattformübergreifend zu entfernen.

Anwendungsfall: einen fehlerhaften Massenupload rückgängig machen. Wenn ein automatisierter Import die falschen Dateien zugeordnet hat, erfassen Sie die betreffenden Medien-IDs aus der Upload-Antwort und entfernen Sie deren Zuordnung sofort. Laden Sie anschließend die richtigen Dateien erneut hoch.

Besonderheiten.

  • Nur Fotos der Kategorie ADDITIONAL können über die API entfernt werden. Bilder der Kategorien LOGO und COVER können hier nicht gelöscht werden; ersetzen Sie sie stattdessen über den Upload-Endpunkt.
  • Beim Entfernen von Medien wird deren Zuordnung zum Standort aufgehoben; die Datei wird dabei nicht unbedingt aus der Medienbibliothek des Kontos gelöscht.
  • Ein Wert von 0 für removedCount zusammen mit errors: null bedeutet, dass keine der angegebenen IDs diesem Standort zugeordnet war.
Request
curl -X POST 'https://listingsapi.com/api/v4/locations/photos/remove' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "photoIds": [        "TWVkaWFGaWxlOjU4Nzg5MzI="      ]    }  }'
Run in playground