Synup
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. Die Synchronisierung beginnt etwa 15 Minuten nach der letzten Änderung am Standort, sodass mehrere kurz aufeinanderfolgende Änderungen gemeinsam als ein Update übertragen werden.

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 bzw. Ihre Referenz für diesen Standort. Ein leerer String entfernt ihn, auch bei Google.
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.
openStatusstring (OPEN | CLOSED_TEMPORARILY | CLOSED_PERMANENTLY)optional
Whether the business is open: OPEN, CLOSED_TEMPORARILY or CLOSED_PERMANENTLY. Send null to clear it.
openingDatestringoptional
When the business opened or will open, as YYYY-MM-DD. Send null to clear it.
googleAdsPhonestringoptional
The phone number Google Ads call extensions use for this location. Send null to clear it.
relationshipDataobjectoptional
Chain membership and parent or child links as Google models them: parentChain (chains/{id} or null), parentLocation (a placeId and relationType) and childrenLocations (a list of the same). It replaces the stored value; send null to clear it.
businessEmailstringoptional
Eine öffentliche Kontakt-E-Mail für das Unternehmen.
categoryIdstringoptional
ID der allgemeinen Kategorie, aus GET /api/v1/locations/categories. Ein Standort braucht eine Kategorie: Senden Sie dies, categoryName oder publisherCategories.google.
categoryNamestringoptional
Anzeigename der allgemeinen Kategorie. Ein Standort braucht eine Kategorie: Senden Sie dies, categoryId oder publisherCategories.google. Ein Name, der nicht im Katalog steht, wird als Anzeigekategorie übernommen.
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
serviceAreaobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
publisherServiceAreasobjectoptional
Ein eigenes Einzugsgebiet für Google, Facebook, Apple oder Bing, jeweils in derselben Form wie serviceArea, gespeichert als eigener Wert dieses Publishers. Senden Sie null für einen Publisher, um seinen eigenen Wert zu entfernen, sodass er wieder serviceArea verwendet. Zusammen mit serviceArea gesendet, setzt es Master und Publisher in einem Aufruf. Nicht mit applyToPublishers kombinierbar.
googleobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
facebookobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
appleobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
bingobjectoptional
Einstellungen für das Einzugsgebiet im Master, für ein Unternehmen, das Kunden an deren Standort bedient. Setzen Sie businessType auf CUSTOMER_LOCATION_ONLY, um die Straßenadresse auszublenden: Kein Publisher erhält eine Straße, die er anzeigen würde, auch wenn eine gespeichert ist. Senden Sie null, um die Einstellung zu entfernen. Um es nur für einzelne Publisher festzulegen, verwenden Sie publisherServiceAreas oder applyToPublishers.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
namestringerforderlich
placeIdstringoptional
Google-Place-ID des Gebiets. Google akzeptiert nur Orte mit einer solchen ID, daher wird ein Ort ohne sie gespeichert, aber nicht an Google gesendet.
placeTypestring (country | administrativeArea | locality | postalCode)optional
socialLinksobjectoptional
URLs von Social-Media-Profilen: facebook, instagram, twitter, linkedin, youtube, tiktok, pinterest. Beim Aktualisieren ändern sich nur die gesendeten Schlüssel; null entfernt einen. Wird bei Google als dessen url_*-Attribute sowie an Bing und Apple veröffentlicht.
facebookstringoptional
instagramstringoptional
twitterstringoptional
linkedinstringoptional
youtubestringoptional
tiktokstringoptional
pintereststringoptional
paymentMethodsarray of stringoptional
Akzeptierte Zahlungsarten, z. B. „Visa", „American Express", „Cash only". Ersetzt die gesamte Liste; eine leere Liste oder null entfernt sie. Wird bei Google als dessen pay_*-Attribute sowie an Apple und Bing veröffentlicht.
attributesobjectoptional
Attribute des Google-Unternehmensprofils als Map von Attribut-ID zu Wert (z. B. { "attributes/wi_fi": "free" }). ERSETZT die gesamte Menge, einschließlich url_*-Links wie Termin- oder Händler-Links. Lesen Sie daher die aktuellen über GET /api/v1/locations/{id} und übergeben Sie alles zurück, was erhalten bleiben soll. IDs, die Google für die Kategorie des Standorts nicht anbietet, werden nicht gespeichert und in rejectedAttributes zurückgemeldet; der Rest der Aktualisierung wird trotzdem übernommen. Social-, Menü- und Zahlungs-IDs (url_facebook, url_menu, pay_* …) werden dort ebenfalls zurückgemeldet: Legen Sie diese über socialLinks, menuUrl und paymentMethods fest.
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. Jeder aufgeführte Publisher veröffentlicht seinen eigenen Wert; die anderen verwenden weiter den Hauptwert. Wird auch gespeichert, solange ein Publisher nicht verbunden ist, und veröffentlicht, sobald er verbunden ist. Mit clearPublisherOverrides wieder entfernen.
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.
socialLinksobjectoptional
URLs von Social-Media-Profilen nach Netzwerk oder null.
paymentMethodsarray of stringoptional
Akzeptierte Zahlungsarten als Anzeigenamen.
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.
serviceAreaobjectoptional
Einstellungen für das Einzugsgebiet im Master oder null für ein reines Ladengeschäft.
businessTypestring (CUSTOMER_LOCATION_ONLY | CUSTOMER_AND_BUSINESS_LOCATION)erforderlich
CUSTOMER_LOCATION_ONLY blendet die Adresse aus (nur Einzugsgebiet). CUSTOMER_AND_BUSINESS_LOCATION zeigt die Adresse und die bedienten Gebiete.
placesarray of objectoptional
Bediente Gebiete, höchstens 20. Jedes ist { name, placeId?, placeType? }. Google und Bing veröffentlichen sie. Facebook und Apple haben keine Liste von Einzugsgebieten, dort gilt nur die ausgeblendete Straße.
publisherOverridesobjectoptional
Publisher-spezifische Werte, die vom Master abweichen, geschlüsselt nach google, facebook, apple oder bing. Jeder Publisher veröffentlicht diese Werte; ein Publisher ohne Eintrag für ein Feld verwendet den Master-Wert. Bleiben erhalten, ob der Publisher verbunden ist oder nicht.
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": []
  }
}

Anleitungen, die diesen Endpunkt verwenden