REST Resource: accounts.locations

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 (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Felder
name

string

Google-ID für diesen Standort im Format locations/{locationId}.
languageCode

string

Nicht veränderbar. Die Sprache des Standorts. Wird während der Erstellung festgelegt und kann nicht aktualisiert werden.
storeCode

string

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

string

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. Address, Categories). Füge deinem Namen keine unnötigen Informationen hinzu (z. B. „Google“ statt „Google Inc. – Mountain View Corporate Headquarters“). Es dürfen keine Marketingslogans, Geschäftscodes, Sonderzeichen, Öffnungszeiten oder den Status „Geschlossen/geöffnet“, Telefonnummern, Website-URLs, Dienstleistungs-/Produktinformationen, Standort/Adresse oder Wegbeschreibungen oder Eingrenzungsinformationen (z. B. „Geldautomat in Duane Reade“) enthalten sein.
phoneNumbers

object (PhoneNumbers)

Optional. Die verschiedenen Telefonnummern, unter denen Kunden das Unternehmen kontaktieren können.
categories

object (Categories)

Optional. Die verschiedenen Kategorien, die das Unternehmen beschreiben.
storefrontAddress

object (PostalAddress)

Optional. Eine genaue Adresse zur Beschreibung Ihres Unternehmensstandorts. Postfächer an entfernten Standorten sind nicht zulässig. Derzeit können Sie maximal fünf addressLines-Werte in der Adresse angeben. Dieses Feld sollte nur für Unternehmen mit Ladengeschäft verwendet werden. Dieses Feld sollte nicht für Standorte vom Typ CUSTOMER_LOCATION_ONLY festgelegt werden. Wenn es jedoch festgelegt ist, werden alle angegebenen Werte verworfen.
websiteUri

string

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

object (BusinessHours)

Optional. Die Öffnungszeiten des Unternehmens.
specialHours

object (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

object (ServiceAreaBusiness)

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[]

string

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

object (AdWordsLocationExtensions)

Optional. Zusätzliche Informationen, die in AdWords angezeigt werden
latlng

object (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 latlng-Wert beim Erstellen akzeptiert oder der latlng-Wert über die Google Unternehmensprofil-Website aktualisiert wurde. Dieses Feld kann nur von genehmigten Kunden aktualisiert werden.
openInfo

object (OpenInfo)

Optional. Eine Markierung, die angibt, ob der Standort derzeit geöffnet ist.
metadata

object (Metadata)

Nur Ausgabe Zusätzliche Informationen, die nicht vom Nutzer bearbeitet werden können.
profile

object (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

object (RelationshipData)

Optional. Alle zu diesem Standort gehörenden Standorte und Ketten.
moreHours[]

object (MoreHours)

Optional. Weitere Öffnungszeiten für verschiedene Abteilungen eines Unternehmens oder bestimmte Kunden
serviceItems[]

object (ServiceItem)

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

string

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[]

string

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 (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Felder
primaryCategory

object (Category)

Erforderlich. Kategorie, die das Kerngeschäft, das an diesem Standort tätig ist, am besten beschreibt.
additionalCategories[]

object (Category)

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 (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Felder
name

string

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

string

Nur Ausgabe Der visuell lesbare Name der Kategorie. Diese wird beim Lesen des Standorts festgelegt. Beim Ändern des Standorts muss category_id festgelegt werden.
serviceTypes[]

object (ServiceType)

Nur Ausgabe Eine Liste aller Dienstleistungsarten, die für diese Unternehmenskategorie verfügbar sind.
moreHoursTypes[]

object (MoreHoursType)

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

string

Nur Ausgabe Eine gleichbleibende, von Google bereitgestellte ID für diesen Diensttyp.
displayName

string

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

string

Nur Ausgabe Eine gleichbleibende ID, die von Google für diesen Öffnungszeitentyp zur Verfügung gestellt wird.
displayName

string

Nur Ausgabe Der für Menschen lesbare englische Anzeigename für den Öffnungszeitentyp.
localizedDisplayName

string

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

integer

Die Schemaversion von PostalAddress. Die Einstellung muss 0 lauten, was der aktuellen Überarbeitung entspricht.

Alle neuen Überarbeitungen müssen abwärtskompatibel zu alten Überarbeitungen sein.
regionCode

string

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

string

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

string

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

string

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

string

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

string

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

string

Optional. Unterlokalität der Adresse. Dies können beispielsweise Stadtviertel, Stadtteile und Bezirke sein.
addressLines[]

string

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[]

string

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

string

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 (TimePeriod)
    }
  ]
}
Felder
periods[]

object (TimePeriod)

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 (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Felder
openDay

enum (DayOfWeek)

Erforderlich. Gibt die day of the week an, an der dieser Zeitraum beginnt.
openTime

object (TimeOfDay)

Erforderlich. Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tagesfelds steht.
closeDay

enum (DayOfWeek)

Erforderlich. Gibt die day of the week an, an der dieser Zeitraum endet
closeTime

object (TimeOfDay)

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

integer

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

integer

Minuten der Zeitangabe. Muss zwischen 0 und 59 liegen.
seconds

integer

Sekunden der Zeitangabe. Muss normalerweise zwischen 0 und 59 liegen. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

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 (SpecialHourPeriod)
    }
  ]
}
Felder
specialHourPeriods[]

object (SpecialHourPeriod)

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 (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Felder
startDate

object (Date)

Erforderlich. Das Kalenderdatum, an dem dieser Zeitraum für spezielle Öffnungszeiten beginnt.
openTime

object (TimeOfDay)

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 closed „false“ ist.
endDate

object (Date)

Optional. Das Kalenderdatum, an dem dieser Zeitraum für spezielle Öffnungszeiten endet Wenn das Feld endDate nicht festgelegt ist, wird standardmäßig das in startDate angegebene Datum verwendet. Wenn dieses Feld festgelegt ist, darf es maximal 1 Tag nach startDate liegen.
closeTime

object (TimeOfDay)

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 „false“ ist.
closed

boolean

Optional. Bei „true“ werden endDate, openTime und closeTime ignoriert. Das in startDate angegebene Datum wird dann als der Ort behandelt, der den ganzen Tag lang geschlossen ist.

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:

JSON-Darstellung 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen, oder 0, um ein Datum ohne Jahr anzugeben.
month

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen, oder 0, um ein Jahr ohne Monat und Tag anzugeben.
day

integer

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 (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Felder
businessType

enum (BusinessType)

Erforderlich. Gibt den [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] des Unternehmens mit Einzugsgebiet an.
places

object (Places)

Das Gebiet, in dem dieses Unternehmen tätig ist, definiert durch mehrere Orte.
regionCode

string

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 (PlaceInfo)
    }
  ]
}
Felder
placeInfos[]

object (PlaceInfo)

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

string

Erforderlich. Der lokalisierte Name des Orts. Beispiel: Scottsdale, AZ.
placeId

string

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

string

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

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

number

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 (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Felder
status

enum (OpenForBusiness)

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

boolean

Nur Ausgabe Gibt an, ob das Unternehmen wieder eröffnet werden kann.
openingDate

object (Date)

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

boolean

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 getGoogleUpdated aufrufen, um Informationen nachzuschlagen, die verifiziert werden müssen.
hasPendingEdits

boolean

Nur Ausgabe Gibt an, ob eine der Eigenschaften dieses Standorts den Status „Bearbeitung ausstehend“ hat.
canDelete

boolean

Nur Ausgabe Gibt an, ob der Standort mithilfe der API gelöscht werden kann.
canOperateLocalPost

boolean

Nur Ausgabe Gibt an, ob für den Eintrag lokale Beiträge verwaltet werden können.
canModifyServiceList

boolean

Nur Ausgabe Gibt an, ob die Liste der Dienste durch den Eintrag geändert werden kann.
canHaveFoodMenus

boolean

Nur Ausgabe Gibt an, ob der Eintrag für die Speisekarte infrage kommt.
canOperateHealthData

boolean

Nur Ausgabe Gibt an, ob für den Standort Gesundheitsdaten verarbeitet werden können.
canOperateLodgingData

boolean

Nur Ausgabe Gibt an, ob der Standort mit Unterkunftsdaten verarbeitet werden kann.
placeId

string

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

string

Nur Ausgabe Die Standortressource, die von diesem Standort dupliziert wird.
mapsUri

string

Nur Ausgabe Ein Link zum Standort auf Google Maps.
newReviewUri

string

Nur Ausgabe Ein Link zu der Seite in der Google Suche, auf der ein Kunde eine Rezension für den Standort schreiben kann.
canHaveBusinessCalls

boolean

Nur Ausgabe Gibt an, ob der Eintrag für geschäftliche Anrufe infrage kommt.
hasVoiceOfMerchant

boolean

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

string

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 (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Felder
parentLocation

object (RelevantLocation)

Der übergeordnete Standort, mit dem dieser Standort verbunden ist.
childrenLocations[]

object (RelevantLocation)

Die Liste der untergeordneten Standorte, mit denen dieser Standort in Verbindung steht.
parentChain

string

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 (RelationType)
}
Felder
placeId

string

Erforderlich. Geben Sie den Standort auf der anderen Seite der Beziehung anhand seiner „placeID“ an.
relationType

enum (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 (TimePeriod)
    }
  ]
}
Felder
hoursTypeId

string

Erforderlich. Art der Öffnungszeiten. Kunden sollten {#link businessCategories:BatchGet} anrufen, um unterstützte Öffnungszeiten für die Kategorien ihrer Standorte zu erhalten.
periods[]

object (TimePeriod)

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 (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
Felder
price

object (Money)

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

object (StructuredServiceItem)

Optional. In diesem Feld wird die Groß-/Kleinschreibung von strukturierten Dienstdaten festgelegt.
freeFormServiceItem

object (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

string

Erforderlich. Das Feld „serviceTypeId“ ist eine von Google bereitgestellte eindeutige ID, die in ServiceType zu finden ist. Diese Informationen werden vom RPC-Dienst categories.batchGet bereitgestellt.
description

string

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 (Label)
  }
}
Felder
category

string

Erforderlich. Dieses Feld steht für den Kategorienamen, also die gleichbleibende ID der Kategorie. category und serviceTypeId sollten mit den möglichen Kombinationen in der Category-Meldung übereinstimmen.
label

object (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

string

Erforderlich. Anzeigename für die Preisliste, den Abschnitt oder den Artikel
description

string

Optional. Beschreibung der Preisliste, des Bereichs oder des Artikels.
languageCode

string

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

string

Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217.
units

string (int64 format)

Die ganzen Einheiten des Betrags. Beispiel: Wenn currencyCode den Wert "USD" hat, entspricht eine Einheit 1 US-Dollar.
nanos

integer

Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn units positiv ist, muss nanos positiv oder null sein. Wenn units null ist, kann nanos positiv, null oder negativ sein. Wenn units negativ ist, muss nanos negativ oder null sein. Beispiel: -1,75 € wird mit units = −1 und nanos=-750.000.000 dargestellt.

Methoden

create

 Erstellt einen neuen Standort, der dem angemeldeten Nutzer gehört.

list

 Listet die Standorte für das angegebene Konto auf.