Synupv1
Schlüssel erstellen
v1Ressourcen/Locations/deleteFotos eines Standorts löschen

Fotos eines Standorts löschen

Entfernt Fotos von einem Standort. Übergeben Sie urls, um bestimmte Fotos zu löschen, oder category, um eine ganze Kategorie zu leeren. Das Logo kann über diesen Endpunkt niemals gelöscht werden — weder per url noch per category — laden Sie stattdessen ein neues LOGO-Bild hoch, um es zu ersetzen. Dies entfernt die Fotos in der App; es löscht sie nicht von Google.

delete/api/v1/locations/{id}/media
locations:write
Query-Parameter
idstringerforderlich
Der Standort, von dem Fotos entfernt werden sollen.
Anfragetext
urlsarray of stringoptional
Bestimmte zu entfernende Foto-URLs (aus dem mediaByCategory eines Standorts).
categorystring (COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | FOOD_AND_DRINK | MENU | AT_WORK | TEAMS | ROOMS | COMMON_AREA | ADDITIONAL)optional
Jedes Foto in dieser Kategorie löschen. LOGO ist kein zulässiger Wert — das Logo kann nicht gelöscht werden.
Antwort
dataobjectoptional
mediaByCategoryobjectoptional
Medienelemente gruppiert nach Kategorie (z. B. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Jedes Element hat eine url und optional ein label, ein kind (PHOTO oder VIDEO), eine source, ein starred-Flag und einen assetKey.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
delete/api/v1/locations/{id}/media
Ihr API-Schlüssel
id *
Anfragetext
{
  "data": {
    "mediaByCategory": {
      "EXTERIOR": []
    },
    "removed": [
      "https://cdn.synup.com/media/1.jpg"
    ]
  }
}