Synupv1
Schlüssel erstellen
v1Ressourcen/Locations/patchStandort aktualisieren

Standort aktualisieren

Bearbeitet die Unternehmensdetails eines bestehenden Standorts — Adresse, Kategorien, Google-Unternehmensprofil-Attribute, Dienstleistungen und Öffnungszeiten. Übergeben Sie nur die Felder, die Sie ändern möchten; ein übergebenes Feld ersetzt seinen aktuellen Wert vollständig (ein leerer String löscht ein Textfeld, eine vollständige neue Liste ersetzt eine bestehende). Das Land kann nach der Erstellung nicht mehr geändert werden. Gespeicherte Änderungen werden automatisch zur Synchronisierung mit den verbundenen Verzeichnissen und Listings eingereiht.

patch/api/v1/locations/{id}
locations:write
Query-Parameter
idstringerforderlich
Der zu aktualisierende Standort.
Anfragetext
namestringoptional
Der Firmenname des Standorts.
descriptionstringoptional
Eine kurze Beschreibung des Unternehmens.
taglinestringoptional
Ein kurzer Slogan für das Unternehmen.
storeCodestringoptional
Ihr interner Filialcode / Referenz für diesen Standort.
logoUrlstringoptional
URL des Logobilds des Standorts.
languageCodestringoptional
Die primäre Sprache des Listings, als Code (z. B. „en“).
streetstringoptional
Straßenadresse.
street1stringoptional
Straßenadresse, Zeile 2.
citystringoptional
Stadt.
stateIsostringoptional
Bundesland oder Region, als ISO-Code (z. B. „CA“).
postalCodestringoptional
Postleitzahl.
latitudenumberoptional
Breitengrad. Wenn Sie die Adresse ändern, ohne dies ebenfalls zu setzen, wird er automatisch neu abgeleitet.
longitudenumberoptional
Längengrad. Wenn Sie die Adresse ändern, ohne dies ebenfalls zu setzen, wird er automatisch neu abgeleitet.
phonestringoptional
Telefonnummer.
additionalPhonesarray of stringoptional
Weitere Telefonnummern zusätzlich zur primären.
websitestringoptional
Website-URL.
businessEmailstringoptional
Eine öffentliche Kontakt-E-Mail für das Unternehmen.
categoryIdstringoptional
Allgemeine Kategorie-ID — mit GET /api/v1/locations/categories nachschlagen.
categoryNamestringoptional
Anzeigename der allgemeinen Kategorie.
publisherCategoriesobjectoptional
Publisherspezifische PRIMÄRKATEGORIE — derzeit wird hier nur google unterstützt (sowohl id als auch name sind erforderlich; die alleinige Übergabe von einem der beiden würde die Kategorie löschen). Facebook/Apple/Bing können nur im Standort-Editor geändert werden. Das id/name-Paar für google nachschlagen mit GET /api/v1/locations/publisher-categories.
googleobjectoptional
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
attributesobjectoptional
Google-Unternehmensprofil-Attribute, als Map von Attribut-ID zu Wert (z. B. { "attributes/wi_fi": "free" }) — ERSETZT die gesamte Menge, lesen Sie daher die aktuellen über GET /api/v1/locations/{id} und übergeben Sie alles zurück, was erhalten bleiben soll. Eine id ohne gültige Google-Darstellung für die Kategorie dieses Standorts wird verworfen und in rejectedAttributes zurückgemeldet, statt die gesamte Anfrage scheitern zu lassen. Es gibt keinen Endpunkt, der auflistet, welche Attribut-IDs für eine Kategorie gültig sind — das ist Googles eigene Business-Profile-Attributreferenz, nicht die von Synup.
servicesarray of objectoptional
Die Dienstleistungen oder Produkte, die dieser Standort anbietet — ersetzt die bestehende Liste.
namestringoptional
descriptionstringoptional
pricenumberoptional
currencystringoptional
googleServiceTypeIdstringoptional
ownerNamestringoptional
Der Name des Inhabers.
menuUrlstringoptional
URL der Speisekarte des Unternehmens.
yearEstablishednumberoptional
Das Jahr, in dem das Unternehmen gegründet wurde (z. B. 2012).
tagsarray of stringoptional
Interne Tags für Ihre eigene Organisation — nicht öffentlich sichtbar. Ersetzt die bestehende Liste.
labelsarray of stringoptional
Interne Labels für diesen Standort. Ersetzt die bestehende Liste.
regularHoursarray of objectoptional
Der wöchentliche Standard-Öffnungszeitenplan — ersetzt den bestehenden Plan vollständig. Ein Eintrag je Wochentag.
daystring (MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY)optional
closedbooleanoptional
periodsarray of objectoptional
openstringoptional
closestringoptional
moreHoursarray of objectoptional
Zusätzliche Öffnungszeitentypen über die regulären hinaus (Lieferung, Abholung, Happy Hour usw.), ersetzt die bestehende Liste.
specialHoursarray of objectoptional
Einmalige Datumsüberschreibungen — Feiertagsschließungen oder Sonderöffnungszeiten für einen einzelnen Tag — ersetzt die bestehende Liste. Jedes Kalenderdatum funktioniert, nicht nur benannte Feiertage.
applyToPublishersarray of string (google | facebook | apple | bing)optional
Diese Werte nur für bestimmte Publisher ändern, statt für den gemeinsamen Standardwert, den jeder Publisher erbt.
Antwort
dataobjectoptional
locationobjectoptional
Das vollständige Unternehmensprofil für einen Standort: Adresse, Öffnungszeiten, Kategorien, Attribute, Dienstleistungen, Medien und Status — alles, was update_location ändern kann, plus das, was create zurückgegeben hat.
idstringoptional
Eindeutige Kennung des Standorts.
namestringoptional
Der Firmenname des Standorts.
descriptionstringoptional
Eine Beschreibung des Unternehmens, oder null.
taglinestringoptional
Ein kurzer Slogan für das Unternehmen, oder null.
storeCodestringoptional
Ihr interner Filialcode / Referenz für diesen Standort, oder null.
logoUrlstringoptional
URL des Logobilds des Standorts, oder null.
streetstringoptional
Straßenadresse, Zeile 1, oder null.
street1stringoptional
Straßenadresse, Zeile 2, oder null.
citystringoptional
Stadt.
statestringoptional
Bundesland oder Region.
postalCodestringoptional
Postleitzahl, oder null.
countrystringoptional
Land, als ISO-3166-1-Alpha-2-Code, oder null.
latitudenumberoptional
Breitengrad, oder null.
longitudenumberoptional
Längengrad, oder null.
phonestringoptional
Primäre Telefonnummer, oder null.
additionalPhonesarray of stringoptional
Weitere Telefonnummern zusätzlich zur primären.
websitestringoptional
Die Website-URL des Standorts, oder null.
businessEmailstringoptional
Eine öffentliche Kontakt-E-Mail für das Unternehmen, oder null.
categoryNamestringoptional
Der Anzeigename der allgemeinen Kategorie, oder null.
primaryCategoryDisplaystringoptional
Der Anzeigename der effektiven Primärkategorie — publisherspezifisch (Google), falls gesetzt, sonst allgemein — oder null.
primaryCategoryGooglestringoptional
Die primäre Google-Kategorie-ID des Standorts (gcid), oder null.
additionalCategoriesarray of objectoptional
Bis zu 9 zusätzliche Kategorien, jeweils mit einer id (wenn aufgelöst) und einem Anzeigenamen.
idstringoptional
namestringoptional
attributesarray of objectoptional
Google-Unternehmensprofil-Attribute, als gespeicherte { id, value }-Liste.
idstringoptional
valueobjectoptional
Der Wert des Attributs — ein Boolean für Ja/Nein-Attribute, ein String für Einzelauswahl-Attribute, oder ein Objekt mit setValues/unsetValues für Mehrfachauswahl.
servicesarray of objectoptional
Die Dienstleistungen oder Produkte, die dieser Standort anbietet.
namestringoptional
descriptionstringoptional
pricenumberoptional
currencystringoptional
googleServiceTypeIdstringoptional
ownerNamestringoptional
Der Name des Inhabers, oder null.
menuUrlstringoptional
URL der Speisekarte des Unternehmens, oder null.
yearEstablishednumberoptional
Das Jahr, in dem das Unternehmen gegründet wurde, oder null.
tagsarray of stringoptional
Interne Tags für Ihre eigene Organisation — nicht öffentlich sichtbar.
labelsarray of stringoptional
Interne Labels für diesen Standort.
regularHoursarray of objectoptional
Der wöchentliche Standard-Öffnungszeitenplan, oder null.
daystring (MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY)optional
closedbooleanoptional
periodsarray of objectoptional
moreHoursarray of objectoptional
Zusätzliche Öffnungszeitentypen über die regulären hinaus (Lieferung, Abholung usw.), oder null.
specialHoursarray of objectoptional
Einmalige Datumsüberschreibungen — Feiertagsschließungen oder Sonderöffnungszeiten für einen einzelnen Tag — oder null.
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.
clientIdstringoptional
ID des Kunden, zu dem dieser Standort gehört, oder null.
archivedbooleanoptional
Ob der Standort archiviert ist.
scheduledArchiveAtstringoptional
Zeitpunkt, zu dem die Archivierung angefordert wurde (zugleich das Token, auf das cancel-archive abgleicht), als ISO-8601-Zeitstempel, oder null, wenn keine ausstehend ist.
verificationStatusstring (verified | pending | unverified | unknown)optional
Google-Verifizierungsstatus: verified, pending, unverified oder unknown, oder null.
rejectedAttributesarray of stringoptional
Attribut-IDs aus der Anfrage, die NICHT geschrieben wurden — entweder haben sie ein eigenes dediziertes Feld, oder ihr Wert hatte keine gültige Google-Darstellung. Nur vorhanden, wenn mindestens eine abgelehnt wurde.
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.
patch/api/v1/locations/{id}
Ihr API-Schlüssel
id *
Anfragetext
{
  "data": {
    "location": {
      "id": "loc_456",
      "name": "Acme Dental — Downtown",
      "tagline": "Gentle care, on time",
      "city": "Austin",
      "state": "TX",
      "clientId": "cli_123"
    },
    "rejectedAttributes": []
  }
}