- Ressource: Location
- JSON-Darstellung
- PhoneNumbers
- Kategorien
- Kategorie
- ServiceType
- MoreHoursType:
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- Datum
- ServiceAreaBusiness
- BusinessType
- Orte
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- Metadaten
- Profil
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Label
- Geld
- Methoden
Ressource: Location
Ein Standort. Eine ausführliche Beschreibung dieser Felder finden Sie in diesem Hilfeartikel. Unter Kategorieendpunkt finden Sie eine Liste gültiger Unternehmenskategorien.
JSON-Darstellung |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
Felder | |
---|---|
name |
Google-ID für diesen Standort im Format |
languageCode |
Nicht veränderbar. Die Sprache des Standorts. Wird während der Erstellung festgelegt und kann nicht aktualisiert werden. |
storeCode |
Optional. Externe Kennung für diesen Standort, die innerhalb eines Kontos eindeutig sein muss. Dies ist eine Möglichkeit, den Standort mit Ihren eigenen Datensätzen zu verknüpfen. |
title |
Erforderlich. Der Standortname sollte mit dem tatsächlichen Namen Ihres Unternehmens übereinstimmen, so wie er auch für Ihr Ladengeschäft, Ihre Website, Ihr Briefpapier und gegenüber Kunden gebräuchlich ist. Gegebenenfalls können zusätzliche Informationen in andere Felder der Ressource eingefügt werden (z. B. |
phoneNumbers |
Optional. Die verschiedenen Telefonnummern, unter denen Kunden das Unternehmen kontaktieren können. |
categories |
Optional. Die verschiedenen Kategorien, die das Unternehmen beschreiben. |
storefrontAddress |
Optional. Eine genaue Adresse zur Beschreibung Ihres Unternehmensstandorts. Postfächer an entfernten Standorten sind nicht zulässig. Derzeit können Sie maximal fünf |
websiteUri |
Optional. Eine URL für dieses Unternehmen. Verwenden Sie nach Möglichkeit eine URL, die für diesen individuellen Unternehmensstandort steht, anstatt eine allgemeine Website/URL, die alle Standorte oder die Marke repräsentiert. |
regularHours |
Optional. Die Öffnungszeiten des Unternehmens. |
specialHours |
Optional. Spezielle Öffnungszeiten für das Unternehmen. Dazu zählen in der Regel Öffnungszeiten an Feiertagen und andere Zeiten außerhalb der regulären Öffnungszeiten. Diese überschreiben die regulären Öffnungszeiten. Dieses Feld kann nicht ohne die regulären Öffnungszeiten festgelegt werden. |
serviceArea |
Optional. Unternehmen ohne festen Standort in einem Einzugsgebiet bieten ihre Dienstleistungen am Standort des Kunden an. Wenn es sich bei diesem Unternehmen um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt, beschreibt dieses Feld die Einzugsgebiete, in denen das Unternehmen tätig ist. |
labels[] |
Optional. Eine Sammlung frei definierbarer Strings, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind NICHT für Nutzer sichtbar, sondern nur für Sie sichtbar. Muss zwischen 1 und 255 Zeichen pro Label lang sein. |
adWordsLocationExtensions |
Optional. Zusätzliche Informationen, die in AdWords angezeigt werden |
latlng |
Optional. Vom Nutzer angegebener Breiten- und Längengrad. Beim Erstellen eines Standorts wird dieses Feld ignoriert, wenn die angegebene Adresse erfolgreich geocodiert wurde. Dieses Feld wird nur bei GET-Anfragen zurückgegeben, wenn der vom Nutzer angegebene |
openInfo |
Optional. Eine Markierung, die angibt, ob der Standort derzeit geöffnet ist. |
metadata |
Nur Ausgabe Zusätzliche Informationen, die nicht vom Nutzer bearbeitet werden können. |
profile |
Optional. Sie beschreibt Ihr Unternehmen mit Ihren eigenen Worten und vermittelt Nutzern die einzigartige Geschichte Ihres Unternehmens und Ihres Angebots. Dieses Feld ist für alle Kategorien mit Ausnahme von Unterkunftskategorien erforderlich (z.B. Hotels, Motels, Gasthäuser). |
relationshipData |
Optional. Alle zu diesem Standort gehörenden Standorte und Ketten. |
moreHours[] |
Optional. Weitere Öffnungszeiten für verschiedene Abteilungen eines Unternehmens oder bestimmte Kunden |
serviceItems[] |
Optional. Liste der von Händlern unterstützten Dienstleistungen. Das kann zum Beispiel das Haareschneiden oder die Installation von Warmwasserbereitern sein. Doppelte Dienstleistungsgegenstände werden automatisch entfernt. |
PhoneNumbers
Eine Sammlung von Telefonnummern für das Unternehmen. Bei Updates müssen beide Felder festgelegt werden. Kunden können nicht nur die primäre oder zusätzliche Telefonnummern mithilfe der Aktualisierungsmaske aktualisieren. Internationale Telefonnummern werden bevorzugt, z. B. "+49 415 555 0132". Weitere Informationen finden Sie unter https://developers.google.com/style/phone-numbers#international-phone-numbers).
JSON-Darstellung |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
Felder | |
---|---|
primaryPhone |
Erforderlich. Eine Telefonnummer, unter der der jeweilige Unternehmensstandort möglichst direkt erreichbar ist. Anstelle eines Callcenters oder einer Hotline sollten Sie nach Möglichkeit immer eine örtliche Telefonnummer angeben. |
additionalPhones[] |
Optional. Bis zu zwei weitere Mobilfunk- oder Festnetztelefonnummern, unter denen Ihr Unternehmen zu erreichen ist. Faxnummern sind nicht zulässig. |
Kategorien
Eine Sammlung von Kategorien, die das Unternehmen beschreibt. Bei Updates müssen beide Felder festgelegt werden. Clients dürfen die primäre oder zusätzliche Kategorie nicht einzeln mithilfe der Aktualisierungsmaske aktualisieren.
JSON-Darstellung |
---|
{ "primaryCategory": { object ( |
Felder | |
---|---|
primaryCategory |
Erforderlich. Kategorie, die das Kerngeschäft, das an diesem Standort tätig ist, am besten beschreibt. |
additionalCategories[] |
Optional. Zusätzliche Kategorien zur Beschreibung Ihres Unternehmens. Mithilfe von Kategorien können Ihre Kunden präzise und spezifische Ergebnisse für Dienstleistungen finden, für die sie sich interessieren. Damit die Informationen zu Ihrem Unternehmen immer aktuell und korrekt sind, verwenden Sie möglichst wenige Kategorien zur Beschreibung Ihres Kerngeschäfts. Wählen Sie möglichst spezifische Kategorien aus, die Ihrem Kerngeschäft entsprechen. |
Kategorie
Eine Kategorie, die beschreibt, was dieses Unternehmen ist (nicht, was es tut). Eine Liste der gültigen Kategorie-IDs und der Zuordnungen zu ihren visuell lesbaren Namen finden Sie unter categories.list
.
JSON-Darstellung |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
Felder | |
---|---|
name |
Erforderlich. Eine gleichbleibende, von Google bereitgestellte ID für diese Kategorie. Der Wert muss angegeben werden, wenn die Kategorie geändert wird (beim Erstellen oder Aktualisieren eines Standorts). |
displayName |
Nur Ausgabe Der visuell lesbare Name der Kategorie. Diese wird beim Lesen des Standorts festgelegt. Beim Ändern des Standorts muss |
serviceTypes[] |
Nur Ausgabe Eine Liste aller Dienstleistungsarten, die für diese Unternehmenskategorie verfügbar sind. |
moreHoursTypes[] |
Nur Ausgabe Weitere Öffnungszeiten, die für diese Unternehmenskategorie verfügbar sind. |
ServiceType
Eine Nachricht, die eine Dienstleistungsart beschreibt, die das Unternehmen anbietet.
JSON-Darstellung |
---|
{ "serviceTypeId": string, "displayName": string } |
Felder | |
---|---|
serviceTypeId |
Nur Ausgabe Eine gleichbleibende, von Google bereitgestellte ID für diesen Diensttyp. |
displayName |
Nur Ausgabe Der für Menschen lesbare Anzeigename des Diensttyps. |
MoreHoursType
Weitere Öffnungszeiten, die ein Unternehmen zusätzlich zu den normalen Öffnungszeiten anbieten kann.
JSON-Darstellung |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
Felder | |
---|---|
hoursTypeId |
Nur Ausgabe Eine gleichbleibende ID, die von Google für diesen Öffnungszeitentyp zur Verfügung gestellt wird. |
displayName |
Nur Ausgabe Der für Menschen lesbare englische Anzeigename für den Öffnungszeitentyp. |
localizedDisplayName |
Nur Ausgabe Der für Menschen lesbare lokalisierte Anzeigename für den Typ der Öffnungszeiten. |
PostalAddress
Stellt eine Postadresse dar, z. B. für Postzustellungs- oder Zahlungsadressen. Mit einer Postadresse kann ein Postdienst Artikel an eine Einrichtung, ein Postfach oder eine andere Adresse liefern. Sie stellt kein Modell eines geografischen Standorts (Straßen, Städte, Berge) dar.
Normalerweise wird eine Adresse je nach Prozesstyp durch eine Nutzereingabe oder den Import vorhandener Daten erstellt.
Hinweise zur Adresseingabe/-bearbeitung: Verwenden Sie ein zur Internationalisierung bereites Adress-Widget wie https://github.com/google/libaddressinput. Nutzer sollten außerhalb der Länder, in denen dieses Feld verwendet wird, keine UI-Elemente für die Eingabe oder Bearbeitung von Feldern sehen.
Weitere Informationen zur Verwendung dieses Schemas finden Sie unter https://support.google.com/business/answer/6397478.
JSON-Darstellung |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Felder | |
---|---|
revision |
Die Schemaversion von Alle neuen Überarbeitungen müssen abwärtskompatibel zu alten Überarbeitungen sein. |
regionCode |
Erforderlich. CLDR-Regionscode des Landes bzw. der Region der Adresse. Er wird nie abgeleitet. Der Nutzer muss sicherstellen, dass der Wert richtig ist. Weitere Informationen finden Sie unter https://cldr.unicode.org/ und https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz. |
languageCode |
Optional. BCP-47-Sprachencode des Inhalts dieser Adresse, falls bekannt. Dies ist oft die Sprache der UI des Eingabeformulars oder die Sprache, die mit einer der verwendeten Sprachen des Landes bzw. der Region mit der Adresse oder der entsprechenden Transliteration übereinstimmt. In bestimmten Ländern hat dies Auswirkungen auf die Formatierung. Es ist jedoch nicht entscheidend für die Richtigkeit der Daten und hat niemals Auswirkungen auf Validierungen oder andere nicht formatierungsbezogene Vorgänge. Wenn dieser Wert nicht bekannt ist, sollte er weggelassen werden. Das ist besser, als einen möglicherweise falschen Wert anzugeben. Beispiele: "zh-Hant", "ja", "ja-Latn", "en" |
postalCode |
Optional. Postleitzahl der Adresse. Postleitzahlen werden nicht in allen Ländern verwendet oder benötigt. Dort, wo sie verwendet werden, können sie weitere Validierungsvorgänge für andere Adressteile nach sich ziehen, z. B. die Validierung von Bundesstaat/Postleitzahl in den USA. |
sortingCode |
Optional. Zusätzlicher länderspezifischer Sortiercode. Dieser wird nur für wenige Regionen genutzt. Wenn er verwendet wird, ist der Wert entweder ein String wie "CEDEX", optional gefolgt von einer Ziffer (z. B. "CEDEX 7"), oder nur eine Ziffer für den Sektorcode (Jamaika), den Zustellbereichsindikator (Malawi) oder den Postamtindikator (z. B. Elfenbeinküste). |
administrativeArea |
Optional. Höchste administrative Untergliederung, die für Postadressen eines Landes oder einer Region verwendet wird. Dies kann beispielsweise ein Bundesland, eine Provinz, eine Oblast oder eine Präfektur sein. In Spanien ist dies beispielsweise die Provinz und nicht das autonome Gebiet, also z. B. "Barcelona" und nicht "Katalonien". In vielen Ländern werden in der Postadresse keine Verwaltungsgebiete verwendet. Für die Schweiz etwa sollte dieses Feld leer gelassen werden. |
locality |
Optional. Bezieht sich in der Regel auf die Stadt-/Ortsangabe der Adresse. Beispiele: Stadt in den USA, italienische Gemeinde, Post Town in Großbritannien. Lassen Sie in Regionen der Welt, in denen Lokalitäten nicht hinreichend definiert sind oder nicht dieser Struktur entsprechen, diese Angabe leer und verwenden Sie stattdessen "addressLines". |
sublocality |
Optional. Unterlokalität der Adresse. Dies können beispielsweise Stadtviertel, Stadtteile und Bezirke sein. |
addressLines[] |
Offene Adresszeilen, mit denen nachgeordnete Bereiche einer Adresse beschrieben werden können. Da die Werte in "addressLines" keine Typinformationen beinhalten und manchmal mehrere Werte in einem einzigen Feld enthalten sind, z. B. "Austin, TX", muss die Zeilenreihenfolge deutlich erkennbar sein. Die Reihenfolge der Adresszeilen sollte der Adresse auf einem Briefumschlag für das Land bzw. die Region entsprechen. An Orten, an denen es keine einheitliche Reihenfolge gibt, z. B. in Japan, wird "address_language" verwendet, um dies klar zu machen (z. B. "ja" für die Reihenfolge groß zu klein und "ja-Latn" oder "en" für die Reihenfolge klein zu groß). Auf diese Weise kann die spezifischste Zeile einer Adresse sprachabhängig ausgewählt werden. Die Mindestangabe für eine zulässige strukturierte Darstellung einer Adresse besteht aus einem "regionCode" und allen verbleibenden Informationen in "addressLines". Eine solche Adresse kann weitgehend angenähert ohne Geocodierung formatiert werden. Es wäre jedoch erst dann eine semantische Argumentation zu einer der Adresskomponenten möglich, wenn diese zumindest teilweise aufgelöst wird. Es empfiehlt sich, für vollständig unstrukturierte Adressen eine Adresse mit einem "regionCode" und "adressLines" zu erstellen und danach eine Geocodierung dafür durchzuführen. So muss nicht geraten werden, welche Teile der Adresse Orte oder administrative Gebiete darstellen. |
recipients[] |
Optional. Der Empfänger an der Adresse. Dieses Feld kann in bestimmten Fällen mehrere Zeilen lange Informationen enthalten. Beispielsweise kann es Informationen der Art "wohnhaft bei" enthalten. |
organization |
Optional. Der Name der Organisation an der Adresse. |
BusinessHours
Die Zeiträume, in denen dieser Standort geöffnet ist Enthält eine Sammlung von [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod]-Instanzen.
JSON-Darstellung |
---|
{
"periods": [
{
object ( |
Felder | |
---|---|
periods[] |
Erforderlich. Eine Sammlung von Uhrzeiten, zu denen dieser Standort geöffnet ist. Jeder Zeitraum steht für einen Zeitraum, in dem der Standort in der Woche geöffnet ist. |
TimePeriod
Stellt einen Zeitraum dar, in dem das Unternehmen geöffnet ist, beginnend am angegebenen Tag bzw. zur angegebenen Uhrzeit bis zum angegebenen Geschäftsschluss. Der Geschäftsschluss muss nach dem Geschäftsbeginn liegen, beispielsweise später am selben Tag oder an einem darauffolgenden Tag.
JSON-Darstellung |
---|
{ "openDay": enum ( |
Felder | |
---|---|
openDay |
Erforderlich. Gibt die |
openTime |
Erforderlich. Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tagesfelds steht. |
closeDay |
Erforderlich. Gibt die |
closeTime |
Erforderlich. Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tagesfelds steht. |
DayOfWeek
Steht für einen Wochentag.
Enums | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Der Wochentag ist nicht angegeben. |
MONDAY |
Montag |
TUESDAY |
Dienstag |
WEDNESDAY |
Mittwoch |
THURSDAY |
Donnerstag |
FRIDAY |
Freitag |
SATURDAY |
Samstag |
SUNDAY |
Sonntag |
TimeOfDay
Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date
und google.protobuf.Timestamp
.
JSON-Darstellung |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Felder | |
---|---|
hours |
Stunden im 24-Stunden-Format. Sollte zwischen 0 und 23 liegen. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen. |
minutes |
Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen. |
seconds |
Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt. |
nanos |
Sekundenbruchteile in Nanosekunden. Muss zwischen 0 und 999.999.999 liegen. |
SpecialHours
Stellt eine Reihe von Zeiträumen dar, in denen die Öffnungszeiten eines Standorts von den normalen Öffnungszeiten abweichen.
JSON-Darstellung |
---|
{
"specialHourPeriods": [
{
object ( |
Felder | |
---|---|
specialHourPeriods[] |
Erforderlich. Eine Liste mit Ausnahmen von den regulären Öffnungszeiten des Unternehmens. |
SpecialHourPeriod
Stellt einen einzelnen Zeitraum dar, in dem die Öffnungszeiten eines Standorts von den normalen Öffnungszeiten abweichen. Ein spezieller Stundenzeitraum muss einen Bereich von weniger als 24 Stunden darstellen. openTime
und startDate
müssen vor closeTime
und endDate
liegen. closeTime
und endDate
können sich bis 11:59 Uhr am Tag nach dem angegebenen startDate
erstrecken. Die folgenden Eingaben sind beispielsweise gültig:
startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59
Die folgenden Eingaben sind ungültig:
startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON-Darstellung |
---|
{ "startDate": { object ( |
Felder | |
---|---|
startDate |
Erforderlich. Das Kalenderdatum, an dem dieser Zeitraum für spezielle Öffnungszeiten beginnt. |
openTime |
Optional. Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tages steht. Muss angegeben werden, wenn |
endDate |
Optional. Das Kalenderdatum, an dem dieser Zeitraum für spezielle Öffnungszeiten endet Wenn das Feld |
closeTime |
Optional. Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tagesfelds steht. Muss angegeben werden, wenn |
closed |
Optional. Bei „true“ werden |
Datum
Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Tageszeit und Zeitzone werden entweder an anderer Stelle angegeben oder sind unbedeutend. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes bedeuten:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
- Monat und Tag mit einem Jahr 0 (z. B. ein Jahrestag)
- Ein Jahr für sich allein, mit einem Monat 0 und einem Tag 0.
- Ein Jahr und ein Monat mit einem Tag null (z. B. das Ablaufdatum einer Kreditkarte).
Ähnliche Typen:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben. |
month |
Monat eines Jahres. Muss zwischen 1 und 12 liegen, oder 0, um ein Jahr ohne Monat und Tag anzugeben. |
day |
Tag eines Monats Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Mit 0 können Sie ein Jahr allein oder ein Jahr und einen Monat angeben, bei dem der Tag nicht von Bedeutung ist. |
ServiceAreaBusiness
Unternehmen ohne festen Standort in einem Einzugsgebiet bieten ihre Dienstleistungen am Standort des Kunden an (z. B. Schlüsseldienst oder Klempner).
JSON-Darstellung |
---|
{ "businessType": enum ( |
Felder | |
---|---|
businessType |
Erforderlich. Gibt den [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] des Unternehmens mit Einzugsgebiet an. |
places |
Das Gebiet, in dem dieses Unternehmen tätig ist, definiert durch mehrere Orte. |
regionCode |
Nicht veränderbar. CLDR-Regionscode des Landes/der Region, in der dieses Unternehmen ohne festen Standort in einem Einzugsgebiet ansässig ist. Weitere Informationen finden Sie unter http://cldr.unicode.org/ und http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz. Dieses Feld ist für CUSTOMER_LOCATION_ONLY-Unternehmen erforderlich und wird ansonsten ignoriert. Die hier angegebene Region kann sich von den Regionen für die Gebiete unterscheiden, in denen das Unternehmen tätig ist (z.B. Unternehmen ohne festen Standort in einem Einzugsgebiet, die Dienstleistungen in anderen Regionen als der Region anbieten, in der sie ansässig sind). Ist für diesen Standort eine Bestätigung nach dem Erstellen erforderlich, muss sich die zur Bestätigung angegebene Adresse in dieser Region befinden. Außerdem muss der Geschäftsinhaber oder sein bevollmächtigter Vertreter in der Lage sein, unter der angegebenen Bestätigungsadresse Post zu empfangen. |
BusinessType
Gibt an, ob das Unternehmen seine Dienstleistungen nur am Kundenstandort (z. B. bei einem Abschleppwagen) oder sowohl an einer Adresse als auch vor Ort (z. B. eine Pizzeria mit Essbereich, die auch Kunden liefert) anbietet.
Enums | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Nur Ausgabe Nicht angegeben. |
CUSTOMER_LOCATION_ONLY |
Der Dienst wird nur in der näheren Umgebung und nicht an der Geschäftsadresse angeboten. Wenn ein Unternehmen von CUSTOMER_AND_BUSINESS_LOCATION auf CUSTOMER_LOCATION_ONLY aktualisiert wird, muss die Standortaktualisierung die Feldmaske „storefrontAddress “ enthalten und das Feld auf leer setzen. |
CUSTOMER_AND_BUSINESS_LOCATION |
Der Dienst wird an der Geschäftsadresse und in der Umgebung angeboten. |
Places
Definiert die Gesamtheit von Gebieten, die durch mehrere Orte dargestellt werden.
JSON-Darstellung |
---|
{
"placeInfos": [
{
object ( |
Felder | |
---|---|
placeInfos[] |
Die Bereiche, die durch Orts-IDs dargestellt werden. Es sind auf maximal 20 Orte beschränkt. |
PlaceInfo
Definiert einen Bereich, der durch eine Orts-ID dargestellt wird.
JSON-Darstellung |
---|
{ "placeName": string, "placeId": string } |
Felder | |
---|---|
placeName |
Erforderlich. Der lokalisierte Name des Orts. Beispiel: |
placeId |
Erforderlich. Die ID des Orts. Muss einer Region entsprechen. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
Zusätzliche Informationen, die in AdWords angezeigt werden
JSON-Darstellung |
---|
{ "adPhone": string } |
Felder | |
---|---|
adPhone |
Erforderlich. Eine alternative Telefonnummer, die in den AdWords-Standorterweiterungen anstelle der primären Telefonnummer des Standorts angezeigt wird. |
LatLng
Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Dies wird als Paar von Double-Werten zur Darstellung von Breiten- und Längengraden ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.
JSON-Darstellung |
---|
{ "latitude": number, "longitude": number } |
Felder | |
---|---|
latitude |
Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen. |
longitude |
Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen. |
OpenInfo
Informationen zum Eröffnungsstatus des Unternehmens.
JSON-Darstellung |
---|
{ "status": enum ( |
Felder | |
---|---|
status |
Erforderlich. Gibt an, ob der Standort derzeit geöffnet ist. Alle Standorte sind standardmäßig geöffnet, sofern sie nicht auf „geschlossen“ aktualisiert werden. |
canReopen |
Nur Ausgabe Gibt an, ob das Unternehmen wieder eröffnet werden kann. |
openingDate |
Optional. Das Datum, an dem der Standort erstmals geöffnet wurde. Wenn der genaue Tag nicht bekannt ist, können nur Monat und Jahr angegeben werden. Das Datum muss in der Vergangenheit liegen oder darf nicht mehr als ein Jahr in der Zukunft liegen. |
OpenForBusiness
Zeigt den Status eines Standorts an.
Enums | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
Nicht angegeben. |
OPEN |
Gibt an, dass der Standort geöffnet ist. |
CLOSED_PERMANENTLY |
Gibt an, dass der Standort dauerhaft geschlossen ist. |
CLOSED_TEMPORARILY |
Gibt an, dass der Standort vorübergehend geschlossen ist. |
Metadaten
Zusätzliche Informationen zum Standort, die nicht vom Nutzer bearbeitet werden können.
JSON-Darstellung |
---|
{ "hasGoogleUpdated": boolean, "hasPendingEdits": boolean, "canDelete": boolean, "canOperateLocalPost": boolean, "canModifyServiceList": boolean, "canHaveFoodMenus": boolean, "canOperateHealthData": boolean, "canOperateLodgingData": boolean, "placeId": string, "duplicateLocation": string, "mapsUri": string, "newReviewUri": string, "canHaveBusinessCalls": boolean, "hasVoiceOfMerchant": boolean } |
Felder | |
---|---|
hasGoogleUpdated |
Nur Ausgabe Gibt an, ob für die mit diesem Standort verknüpfte Orts-ID Aktualisierungen vorhanden sind, die vom Client aktualisiert oder abgelehnt werden müssen. Wenn dieser boolesche Wert festgelegt ist, sollten Sie die Methode |
hasPendingEdits |
Nur Ausgabe Gibt an, ob eine der Eigenschaften dieses Standorts den Status „Bearbeitung ausstehend“ hat. |
canDelete |
Nur Ausgabe Gibt an, ob der Standort mithilfe der API gelöscht werden kann. |
canOperateLocalPost |
Nur Ausgabe Gibt an, ob für den Eintrag lokale Beiträge verwaltet werden können. |
canModifyServiceList |
Nur Ausgabe Gibt an, ob die Liste der Dienste durch den Eintrag geändert werden kann. |
canHaveFoodMenus |
Nur Ausgabe Gibt an, ob der Eintrag für die Speisekarte infrage kommt. |
canOperateHealthData |
Nur Ausgabe Gibt an, ob für den Standort Gesundheitsdaten verarbeitet werden können. |
canOperateLodgingData |
Nur Ausgabe Gibt an, ob der Standort mit Unterkunftsdaten verarbeitet werden kann. |
placeId |
Nur Ausgabe Wenn dieser Standort in Google Maps erscheint, wird dieses Feld mit der Orts-ID des Standorts gefüllt. Diese ID kann in verschiedenen Places APIs verwendet werden. Dieses Feld kann während „Create“-Aufrufen festgelegt werden, aber nicht für „Update“. |
duplicateLocation |
Nur Ausgabe Die Standortressource, die von diesem Standort dupliziert wird. |
mapsUri |
Nur Ausgabe Ein Link zum Standort auf Google Maps. |
newReviewUri |
Nur Ausgabe Ein Link zu der Seite in der Google Suche, auf der ein Kunde eine Rezension für den Standort schreiben kann. |
canHaveBusinessCalls |
Nur Ausgabe Gibt an, ob der Eintrag für geschäftliche Anrufe infrage kommt. |
hasVoiceOfMerchant |
Nur Ausgabe Gibt an, ob der Eintrag die Stimme des Händlers enthält. Wenn dieser boolesche Wert „false“ ist, sollten Sie die locations.getVoiceOfMerchantState API aufrufen, um Details dazu zu erhalten, warum Voice of Merchant nicht vorhanden ist. |
Profil
Alle Informationen zum Profil des Standorts.
JSON-Darstellung |
---|
{ "description": string } |
Felder | |
---|---|
description |
Erforderlich. Beschreibung des Orts, die von anderen nicht bearbeitet werden kann. |
RelationshipData
Informationen zu allen übergeordneten und untergeordneten Standorten, die sich auf diesen Standort beziehen.
JSON-Darstellung |
---|
{ "parentLocation": { object ( |
Felder | |
---|---|
parentLocation |
Der übergeordnete Standort, mit dem dieser Standort verbunden ist. |
childrenLocations[] |
Die Liste der untergeordneten Standorte, mit denen dieser Standort in Verbindung steht. |
parentChain |
Der Ressourcenname der Kette, der dieser Standort angehört. [Ketten-ID finden] [Locations.SearchChains] |
RelevantLocation
Informationen zu einem anderen Standort, der mit dem aktuellen Standort in Zusammenhang steht. Die Beziehung kann DEPARTMENT_OF oder INDEPENDENT_ESTABLISHMENT_OF sein. Der hier angegebene Standort kann sich auf jeder Seite (über- oder untergeordnet) des Standorts befinden.
JSON-Darstellung |
---|
{
"placeId": string,
"relationType": enum ( |
Felder | |
---|---|
placeId |
Erforderlich. Geben Sie den Standort auf der anderen Seite der Beziehung anhand seiner „placeID“ an. |
relationType |
Erforderlich. Der Typ der Beziehung. |
RelationType
Die Typbeziehungen, die angegeben werden sollen.
Enums | |
---|---|
RELATION_TYPE_UNSPECIFIED |
Der Typ ist nicht angegeben. |
DEPARTMENT_OF |
Dies stellt eine Beziehung zwischen zwei Standorten dar, die sich einen physischen Bereich, dieselbe Marke, dasselbe Management oder dieselbe Organisation, aber unterschiedliche wichtige Attribute wie Öffnungszeiten oder Telefonnummern haben. Beispielsweise ist Costco Pharmacy eine Abteilung des Großhandels von Costco. |
INDEPENDENT_ESTABLISHMENT_IN |
Das sind Fälle, in denen sich zwei Standorte am selben Standort befinden, jedoch von unterschiedlichen Unternehmen stammen (z.B. Starbucks in einem Safeway, Geschäfte in einem Einkaufszentrum). |
MoreHours
Die Zeiträume, in denen ein Standort für bestimmte Geschäftsarten geöffnet ist.
JSON-Darstellung |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Felder | |
---|---|
hoursTypeId |
Erforderlich. Art der Öffnungszeiten. Kunden sollten {#link businessCategories:BatchGet} anrufen, um unterstützte Öffnungszeiten für die Kategorien ihrer Standorte zu erhalten. |
periods[] |
Erforderlich. Eine Sammlung von Uhrzeiten, zu denen dieser Standort geöffnet ist. Jeder Zeitraum steht für einen Zeitraum, in dem der Standort in der Woche geöffnet ist. |
ServiceItem
Eine Nachricht, die eine einzelne Dienstleistung beschreibt. Damit wird die Art der Dienstleistung beschrieben, die der Händler anbietet. Zum Beispiel kann der Haarschnitt eine Dienstleistung sein.
JSON-Darstellung |
---|
{ "price": { object ( |
Felder | |
---|---|
price |
Optional. Der Geldpreis der Dienstleistung. Wir empfehlen, beim Einbinden eines Preises "currencyCode" und "Einheiten" festzulegen. Dies wird als Festpreis für die Dienstleistung betrachtet. |
Union-Feld service_item_info . Eines der folgenden Felder sollte immer festgelegt werden. Für service_item_info ist nur einer der folgenden Werte zulässig: |
|
structuredServiceItem |
Optional. In diesem Feld wird die Groß-/Kleinschreibung von strukturierten Dienstdaten festgelegt. |
freeFormServiceItem |
Optional. Für dieses Feld wird die Groß-/Kleinschreibung für Dienstdaten im freien Format festgelegt. |
StructuredServiceItem
Stellt eine strukturierte Dienstleistung dar, die vom Händler angeboten wird. Beispiel: Toiletteninstallation.
JSON-Darstellung |
---|
{ "serviceTypeId": string, "description": string } |
Felder | |
---|---|
serviceTypeId |
Erforderlich. Das Feld „ |
description |
Optional. Beschreibung des strukturierten Dienstleistungsartikels. Die maximale Zeichenanzahl beträgt 300. |
FreeFormServiceItem
Eine Dienstleistung in freiem Format, die vom Händler angeboten wird. Dies sind Dienste, die nicht als Teil unserer strukturierten Dienstdaten verfügbar gemacht werden. Der Händler gibt die Namen dieser Dienstleistungen manuell über eine GeoHändleroberfläche ein.
JSON-Darstellung |
---|
{
"category": string,
"label": {
object ( |
Felder | |
---|---|
category |
Erforderlich. Dieses Feld steht für den Kategorienamen, also die gleichbleibende ID der Kategorie. |
label |
Erforderlich. Labels mit Sprach-Tags für das Element. Wir empfehlen, dass Elementnamen maximal 140 Zeichen und Beschreibungen maximal 250 Zeichen lang sein sollten. Dieses Feld sollte nur festgelegt werden, wenn die Eingabe ein benutzerdefiniertes Dienstleistungselement ist. Standardisierte Diensttypen sollten über „serviceTypeId“ aktualisiert werden. |
Label
Label, das beim Anzeigen der Preisliste, des Bereichs oder des Artikels verwendet werden soll.
JSON-Darstellung |
---|
{ "displayName": string, "description": string, "languageCode": string } |
Felder | |
---|---|
displayName |
Erforderlich. Anzeigename für die Preisliste, den Abschnitt oder den Artikel |
description |
Optional. Beschreibung der Preisliste, des Bereichs oder des Artikels. |
languageCode |
Optional. Der BCP-47-Sprachcode, für den diese Strings gelten. Pro Sprache kann nur ein Satz Labels festgelegt werden. |
Geldbetrag
Stellt einen Geldbetrag mit Währungstyp dar.
JSON-Darstellung |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Felder | |
---|---|
currencyCode |
Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217. |
units |
Die ganzen Einheiten des Betrags. Beispiel: Wenn |
nanos |
Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn |
Methoden |
|
---|---|
|
Erstellt einen neuen Standort, der dem angemeldeten Nutzer gehört. |
|
Listet die Standorte für das angegebene Konto auf. |