Synup
Schlüssel erstellen
v1Ressourcen/Locations/postStandort erstellen

Standort erstellen

Erstellt einen neuen Standort für einen bestehenden Kunden und reicht ihn zur Veröffentlichung ein.

post/api/v1/locations
locations:write
Anfragetext
clientIdstringerforderlich
ID des Kunden, unter dem dieser Standort erstellt werden soll. Nachschlagen mit GET /api/v1/clients.
namestringerforderlich
Der Firmenname des Standorts.
countryIsostringerforderlich
ISO-Ländercode, z. B. US.
streetstringoptional
Straßenadresse.
street1stringoptional
Straßenadresse, Zeile 2.
citystringoptional
Stadt.
stateIsostringoptional
Code für Bundesland oder Region.
postalCodestringoptional
Postleitzahl.
phonestringoptional
Telefonnummer.
additionalPhonesarray of stringoptional
Weitere Telefonnummern zusätzlich zur primären.
websitestringoptional
Website-URL.
categoryIdstringoptional
Allgemeine Kategorie-ID — mit GET /api/v1/locations/categories nachschlagen.
categoryNamestringoptional
Anzeigename der allgemeinen Kategorie.
publisherCategoriesobjectoptional
Publisherspezifische Kategorien, eine je Publisher, jeweils ein über GET /api/v1/locations/publisher-categories nachgeschlagenes { id, name }.
googleobjectoptional
idstringoptional
namestringoptional
facebookobjectoptional
idstringoptional
namestringoptional
appleobjectoptional
idstringoptional
namestringoptional
bingobjectoptional
idstringoptional
namestringoptional
additionalCategoriesarray of objectoptional
Bis zu 9 zusätzliche Kategorien, jeweils ein { id?, name }. Ein reiner Name wird akzeptiert, und seine id wird aus dem Kategoriekatalog aufgelöst, sofern eine Übereinstimmung existiert. IDs selbst nachschlagen mit GET /api/v1/locations/categories.
idstringoptional
namestringoptional
descriptionstringoptional
Eine kurze Beschreibung des Unternehmens.
tagsarray of stringoptional
Interne Tags für Ihre eigene Organisation — nicht öffentlich sichtbar.
latitudenumberoptional
Breitengrad, in Dezimalgrad. Wird automatisch aus der Adresse abgeleitet, wenn weggelassen.
longitudenumberoptional
Längengrad, in Dezimalgrad. Wird automatisch aus der Adresse abgeleitet, wenn weggelassen.
customFieldsobjectoptional
Werte benutzerdefinierter Felder, die für diesen Standort gesetzt werden sollen, geschlüsselt nach Feld-ID.
Antwort
dataobjectoptional
locationIdstringoptional
ID des neu erstellten Standorts.
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
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "locationId": "loc_456"
  }
}

Anleitungen, die diesen Endpunkt verwenden