REST Resource: accounts.locations

Ressource: Location

Einen Standort. Eine detaillierte Beschreibung dieser Felder finden Sie im Hilfeartikel. Eine Liste gültiger Unternehmenskategorien finden Sie unter Kategorieendpunkt.

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 bestimmten Kontos eindeutig sein muss. So verknüpfen Sie den Standort mit Ihren eigenen Einträgen.
title

string

Erforderlich. Der Standortname sollte den realen Namen Ihres Unternehmens widerspiegeln, wie er einheitlich auf Ihrem Schaufenster, Ihrer Website, Ihrem Briefpapier und auch bei Kunden verwendet wird. Gegebenenfalls können in anderen Feldern der Ressource weitere Informationen angegeben werden, z. B. Address oder Categories. Fügen Sie Ihrem Namen keine unnötigen Informationen hinzu (z. B. „Google“ statt „Google Inc. – Mountain View Corporate Headquarters“). Verwenden Sie keine Marketingslogans, Geschäftscodes, Sonderzeichen, Öffnungszeiten, Öffnungszeiten, Telefonnummern, Website-URLs, Service- oder Produktinformationen, Standort/Adresse, Wegbeschreibungen oder Begrenzungsinformationen (z. B. „Chase ATM in Duane Reade“).
phoneNumbers

object (PhoneNumbers)

Optional. Die verschiedenen Telefonnummern, über die Kunden das Unternehmen kontaktieren können
categories

object (Categories)

Optional. Die verschiedenen Kategorien, die das Unternehmen beschreiben
storefrontAddress

object (PostalAddress)

Optional. Eine genaue und korrekte Adresse, um Ihren Unternehmensstandort zu beschreiben. Postfächer an entlegenen 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 festgelegt werden. Dieses Feld sollte nicht für Standorte vom Typ CUSTOMER_LOCATION_ONLY festgelegt werden. Wenn es aber konfiguriert ist, werden alle angegebenen Werte verworfen.
websiteUri

string

Optional. Eine URL für dieses Unternehmen. Verwenden Sie nach Möglichkeit eine URL, die diesen einzelnen Unternehmensstandort darstellt, anstelle einer allgemeinen Website/URL, die alle Standorte oder die Marke repräsentiert.
regularHours

object (BusinessHours)

Optional. Die Öffnungszeiten des Unternehmens.
specialHours

object (SpecialHours)

Optional. Spezielle Öffnungszeiten des Unternehmens Dazu gehören in der Regel Öffnungszeiten an Feiertagen und andere Zeiten außerhalb der normalen Öffnungszeiten. Diese überschreiben die regulären Öffnungszeiten. Dieses Feld kann nicht ohne reguläre Öffnungszeiten festgelegt werden.
serviceArea

object (ServiceAreaBusiness)

Optional. Unternehmen ohne festen Standort in einem Einzugsgebiet stellen ihre Dienstleistungen am Standort des Kunden bereit. Wenn es sich bei diesem Unternehmen um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt, beschreibt dieses Feld das Einzugsgebiet, in dem es bedient wird.
labels[]

string

Optional. Eine Sammlung von Strings im freien Format, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind NICHT für den Nutzer sichtbar. und nur du kannst sie sehen. Muss zwischen 1 und 255 Zeichen pro Label enthalten.
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 wird. Dieses Feld wird nur bei GET-Anfragen zurückgegeben, wenn der vom Nutzer bereitgestellte 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. Ihr Unternehmen mit Ihren eigenen Worten beschreiben und Nutzern mitteilen, wodurch sich Ihr Unternehmen und sein Angebot von anderen abhebt.

Dieses Feld muss für alle Kategorien außer Unterkunftskategorien ausgefüllt werden (z.B. Hotels, Motels, Gasthäuser).
relationshipData

object (RelationshipData)

Optional. Alle zugehörigen Standorte und Ketten.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

Optional. Liste der von Händlern unterstützten Dienstleistungen. Das kann z. B. der Friseur oder die Installation von Warmwasserbereitern sein. Doppelte Dienstleistungsgegenstände werden automatisch entfernt.

PhoneNumbers

Eine Sammlung von Telefonnummern des Unternehmens. Während der Aktualisierung müssen beide Felder festgelegt werden. Kunden dürfen mithilfe der Aktualisierungsmaske nicht nur die primäre Telefonnummer oder zusätzliche Telefonnummern aktualisieren. Wir bevorzugen internationale Telefonnummern, wie z. B. „+1 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 beschreiben. Während der Aktualisierung müssen beide Felder festgelegt werden. Kunden 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 des Standorts am besten beschreibt.
additionalCategories[]

object (Category)

Optional. Weitere Kategorien zur Beschreibung Ihres Unternehmens. Mithilfe von Kategorien können Nutzer genaue Ergebnisse für die Dienstleistungen finden, an denen sie interessiert sind. Damit Ihre Unternehmensinformationen immer korrekt und aktuell sind, verwenden Sie möglichst wenige Kategorien, um Ihr Kerngeschäft insgesamt zu beschreiben. Wählen Sie möglichst präzise Kategorien aus, die Ihrem Kerngeschäft entsprechen.

Kategorie

Eine Kategorie, die die Art des Unternehmens beschreibt (nicht das, was es tut). Eine Liste gültiger 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 von Google bereitgestellte unveränderliche ID für diese Kategorie. Der Wert muss beim Ändern der Kategorie (beim Erstellen oder Aktualisieren eines Standorts) angegeben werden.
displayName

string

Nur Ausgabe. Der visuell lesbare Name der Kategorie. 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 für diese Unternehmenskategorie.

ServiceType

Eine Nachricht, die einen vom Unternehmen angebotenen Diensttyp beschreibt.

JSON-Darstellung 
{
  "serviceTypeId": string,
  "displayName": string
}
Felder
serviceTypeId

string

Nur Ausgabe. Eine von Google bereitgestellte unveränderliche ID für diesen Diensttyp.
displayName

string

Nur Ausgabe. Der visuell 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 von Google bereitgestellte unveränderliche ID für diesen Öffnungszeitentyp.
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 Öffnungszeitentyp.

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 Eingabe / Bearbeitung von Adressen: – Verwenden Sie ein für die Internationalisierung geeignetes Adress-Widget wie https://github.com/google/libaddressinput. Nutzern sollten außerhalb der Länder, in denen dieses Feld verwendet wird, keine UI-Elemente zur Eingabe oder Bearbeitung von Feldern angezeigt werden.

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 der Zeiten, in denen dieser Standort geöffnet ist. Jeder Zeitraum steht für einen Zeitraum, in dem der Standort während der Woche geöffnet ist.

TimePeriod

Stellt den Zeitraum dar, in dem das Unternehmen geöffnet ist, beginnend am angegebenen Tag und zur angegebenen Uhrzeit des Geschäftsbetriebs und zum Ende am angegebenen Tag bzw. zu der angegebenen Uhrzeit. Der Schließzeitpunkt muss nach der Öffnungszeit liegen, z. B. später am selben Tag oder an einem nachfolgenden Tag.

JSON-Darstellung 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Felder
openDay

enum (DayOfWeek)

Erforderlich. Gibt den day of the week an, an dem 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 Tages steht.
closeDay

enum (DayOfWeek)

Erforderlich. Gibt den day of the week an, an dem 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 Tages 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 normalen Öffnungszeiten des Unternehmens.

SpecialHourPeriod

Stellt einen einzelnen Zeitraum dar, in dem die Öffnungszeiten eines Standorts von den normalen Öffnungszeiten abweichen. Ein spezieller Zeitraum muss weniger als 24 Stunden umfassen. openTime und startDate müssen vor closeTime und endDate liegen. closeTime und endDate können sich bis 11:59 Uhr am Tag nach der 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 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 endet. Wenn das Feld endDate nicht festgelegt ist, wird standardmäßig das in startDate angegebene Datum verwendet. Wenn dieses Feld festgelegt ist, darf es höchstens einen Tag nach startDate sein.
closeTime

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.
closed

boolean

Optional. Wenn „true“ festgelegt ist, werden endDate, openTime und closeTime ignoriert und das in startDate angegebene Datum wird als den ganzen Tag geschlossen als Standort behandelt.

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 darstellen:

  • Ein vollständiges Datum mit Werten für Jahr, Monat und Tag ungleich null.
  • Ein Monat und ein Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
  • Ein Jahr für sich alleine, mit einem Monat und einem Tag von null.
  • Ein Jahr und ein Monat mit 0 Tag (z. B. dem Ablaufdatum einer Kreditkarte).

Ähnliche Typen:

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

integer

Jahr des Datums. 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 im Monat. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und Monat anzugeben, wenn der Tag nicht von Bedeutung ist.

ServiceAreaBusiness

Unternehmen ohne festen Standort in einem Einzugsgebiet stellen ihre Dienstleistungen am Standort des Kunden bereit, z. B. Schlüsseldienste oder Klempner.

JSON-Darstellung 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Felder
businessType

enum (BusinessType)

Erforderlich. Gibt den [type] an [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] des Unternehmens ohne festen Standort in einem Einzugsgebiet.
places

object (Places)

Das Gebiet, in dem das Unternehmen Dienstleistungen anbietet, definiert durch eine Reihe von Orten.
regionCode

string

Nicht veränderbar. CLDR-Regionscode des Landes/der Region, in der das 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 Unternehmen vom Typ CUSTOMER_LOCATION_ONLY erforderlich und wird ansonsten ignoriert.

Die hier angegebene Region kann sich von den Regionen der 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).

Falls für diesen Standort nach der Erstellung eine Bestätigung erforderlich ist, muss sich die zu Bestätigungszwecken angegebene Adresse in dieser Region befinden und der Geschäftsinhaber oder sein bevollmächtigter Vertreter muss Postsendungen unter der angegebenen Bestätigungsadresse empfangen können.

BusinessType

Gibt an, ob das Unternehmen seine Dienstleistungen nur am Kundenstandort (z. B. einen Abschleppwagen) oder sowohl an einer Adresse als auch vor Ort anbietet (z. B. eine Pizzeria mit Speiseraum, die auch an Kunden liefert).

Enums
BUSINESS_TYPE_UNSPECIFIED Nur Ausgabe. Nicht angegeben.
CUSTOMER_LOCATION_ONLY Der Service 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 das Standortupdate die Feldmaske storefrontAddress enthalten und das Feld auf ein leeres Feld setzen.
CUSTOMER_AND_BUSINESS_LOCATION Der Dienst wird an der Geschäftsadresse und in der Umgebung angeboten.

Orte

Definiert die Gesamtheit von Gebieten, die durch eine Reihe von Orten dargestellt werden.

JSON-Darstellung 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Felder
placeInfos[]

object (PlaceInfo)

Die Bereiche, die durch Orts-IDs dargestellt werden. 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 AdWords-Standorterweiterungen anstelle der primären Telefonnummer des Standorts angezeigt wird

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) 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 Ö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 als geschlossen gekennzeichnet 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 oder 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 wurde.

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 die mit diesem Standort verknüpfte Orts-ID Aktualisierungen aufweist, die vom Client aktualisiert oder abgelehnt werden müssen. Wenn dieser boolesche Wert festgelegt ist, sollten Sie die Methode getGoogleUpdated aufrufen, um nach Informationen zu suchen, die bestätigt werden müssen.
hasPendingEdits

boolean

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

boolean

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

boolean

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

boolean

Nur Ausgabe. Gibt an, ob die Dienstleistungsliste 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 der Standort mit Health-Daten verarbeitet werden kann.
canOperateLodgingData

boolean

Nur Ausgabe. Gibt an, ob der Standort für Unterkunftsdaten verwendet werden kann.
placeId

string

Nur Ausgabe. Wenn dieser Standort in Google Maps angezeigt wird, enthält dieses Feld die Orts-ID des Standorts. 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 dieser Standort dupliziert.
mapsUri

string

Nur Ausgabe. Ein Link zum Standort in Google Maps.
newReviewUri

string

Nur Ausgabe. Ein Link zu der Seite in der Google Suche, auf der Kunden eine Rezension für den Standort schreiben können
canHaveBusinessCalls

boolean

Nur Ausgabe. Gibt an, ob der Eintrag für geschäftliche Anrufe geeignet ist.
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 Standorts in Ihrer eigenen Stimme, die von anderen nicht bearbeitet werden kann

RelationshipData

Informationen zu allen über- und untergeordneten Standorten, die mit diesem Standort in Zusammenhang stehen.

JSON-Darstellung 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Felder
parentLocation

object (RelevantLocation)

Der übergeordnete Standort, zu dem dieser Standort Beziehungen hat.
childrenLocations[]

object (RelevantLocation)

Die Liste der untergeordneten Standorte, zu denen dieser Standort eine Beziehung hat.
parentChain

string

Der Ressourcenname der Kette, der dieser Standort angehört. [Ketten-ID ermitteln] [Locations.SearchChains]

RelevantLocation

Informationen zu einem anderen Standort, der im Zusammenhang mit dem aktuellen Standort steht. Die Beziehung kann DEPARTMENT_OF oder INDEPENDENT_ESTABLISHMENT_OF sein und der hier angegebene Standort kann sich auf beiden Seiten (übergeordnet/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 durch seine placeID an.
relationType

enum (RelationType)

Erforderlich. Die Art 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 denselben physischen Bereich, dieselbe Marke, dieselbe Führungsebene/Organisation, aber unterschiedliche Schlüsselattribute wie Öffnungszeiten oder Telefonnummern haben. Beispiel: Costco Pharmacy ist eine Abteilung von Costco Großhandel.
INDEPENDENT_ESTABLISHMENT_IN Das sind Fälle, in denen sich zwei Standorte am selben physischen Standort, aber von verschiedenen Unternehmen befinden (z.B. Starbucks im Supermarkt oder 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. Die Art der Öffnungszeiten. Kunden sollten {#link businessCategories:BatchGet} aufrufen, um unterstützte Öffnungszeiten für Kategorien ihrer Standorte zu erhalten.
periods[]

object (TimePeriod)

Erforderlich. Eine Sammlung der Zeiten, in denen dieser Standort geöffnet ist. Jeder Zeitraum steht für einen Zeitraum, in dem der Standort während der Woche geöffnet ist.

ServiceItem

Eine Nachricht, die eine einzelne Dienstleistung beschreibt. Sie wird verwendet, um die Art der Dienstleistung zu beschreiben, die der Händler anbietet. Zum Beispiel kann ein 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 monetäre Preis der Dienstleistung. Wir empfehlen, beim Einbeziehen eines Preises den „currencyCode“ und „units“ festzulegen. Dies wird als Festpreis für die Dienstleistung behandelt.
Union-Feld service_item_info. Eines der folgenden Felder sollte immer festgelegt sein. 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 Dienstleistungsdaten festgelegt.
freeFormServiceItem

object (FreeFormServiceItem)

Optional. In diesem Feld werden Dienstleistungsdaten im freien Format angegeben.

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 Dienstleistungselements. Die Zeichenbeschränkung beträgt 300 Zeichen.

FreeFormServiceItem

Stellt eine vom Händler angebotene Dienstleistung im freien Format dar. Dies sind Dienste, die nicht als Teil unserer Strukturdienstdaten offengelegt werden. Der Händler gibt die Namen solcher Dienstleistungen manuell über eine Plattform für Händler ein.

JSON-Darstellung 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Felder
category

string

Erforderlich. Dieses Feld stellt den Kategorienamen dar, d.h. die stabile ID der Kategorie. category und serviceTypeId sollten mit den möglichen Kombinationen in der Category-Meldung übereinstimmen.
label

object (Label)

Erforderlich. Mit Sprach-Tags versehene Labels für den Artikel. Artikelnamen sollten maximal 140 Zeichen und Beschreibungen maximal 250 Zeichen lang sein. Dieses Feld sollte nur festgelegt werden, wenn Sie eine benutzerdefinierte Dienstleistung eingeben. 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 Bereich 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 Labelsatz festgelegt werden.

Geld

Stellt einen Geldbetrag mit Währungstyp dar.

JSON-Darstellung 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Felder
currencyCode

string

Der dreistellige 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 als 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.