Synupv1
Schlüssel erstellen
v1Ressourcen/Locations/postFotos zu einem Standort hochladen

Fotos zu einem Standort hochladen

Fügt einem Standort ein oder mehrere Fotos in einer bestimmten Kategorie hinzu. Geben Sie jedes Bild als öffentliche https-URL (wird abgerufen und neu gehostet) oder als Base64-Bytes an. Es werden nur Bilder unterstützt (jpeg, png, gif, webp), je maximal 5 MB. Die Kategorie LOGO enthält ein einziges Logo — ein Upload zu LOGO ersetzt das aktuelle. Jede andere Kategorie wird ergänzt. Gespeicherte Fotos werden automatisch zur Veröffentlichung auf Google eingereiht.

post/api/v1/locations/{id}/media
locations:write
Query-Parameter
idstringerforderlich
Der Standort, dem Fotos hinzugefügt werden sollen.
Anfragetext
categorystring (COVER | PROFILE | LOGO | EXTERIOR | INTERIOR | PRODUCT | FOOD_AND_DRINK | MENU | AT_WORK | TEAMS | ROOMS | COMMON_AREA | ADDITIONAL)erforderlich
Die Fotokategorie, zu der hinzugefügt werden soll. LOGO ersetzt das aktuelle Logo; jede andere Kategorie wird ergänzt.
imagesarray of objecterforderlich
Ein oder mehrere hinzuzufügende Bilder. Jedes benötigt eine url oder base64.
urlstringoptional
Eine öffentliche https-URL zum Bild — sie wird abgerufen und neu gehostet.
base64stringoptional
Die Bild-Bytes als Base64 (ein data:-URL-Präfix wird akzeptiert). Verwenden Sie dies statt url, wenn Sie die Bytes vorliegen haben.
labelstringoptional
Optionale Bildunterschrift/Beschriftung für das Foto.
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.
addedarray of objectoptional
Die tatsächlich hinzugefügten Fotos, jeweils mit der Kategorie, in der es gelandet ist, und seiner gehosteten URL.
categorystringoptional
urlstringoptional
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.
post/api/v1/locations/{id}/media
Ihr API-Schlüssel
id *
Anfragetext*
{
  "data": {
    "mediaByCategory": {
      "EXTERIOR": [
        {
          "url": "https://cdn.synup.com/media/1.jpg",
          "source": "agent_upload"
        }
      ]
    },
    "added": [
      {
        "category": "EXTERIOR",
        "url": "https://cdn.synup.com/media/1.jpg"
      }
    ]
  }
}