REST Resource: accounts.locations

Ressource: Location

Einen Ort. Eine detaillierte Beschreibung dieser Felder finden Sie in diesem Hilfeartikel. Eine Liste der gültigen Unternehmenskategorien finden Sie unter category.

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

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

string

Nicht veränderbar. Die Sprache des Orts. 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 können Sie den Standort mit Ihren eigenen Datensätzen verknüpfen.
title

string

Erforderlich. Der Name des Standorts sollte dem tatsächlichen Namen Ihres Unternehmens entsprechen, der einheitlich am Ladengeschäft, auf der Website und auf Briefpapier verwendet wird und den Kunden kennen. Alle zusätzlichen Informationen können, sofern relevant, in anderen Feldern der Ressource angegeben werden (z. B. Address, Categories). Fügen Sie dem Namen keine unnötigen Informationen hinzu (z. B. „Google“ statt „Google Inc. – Mountain View Corporate Headquarters“). Geben Sie keine Marketing-Slogans, Geschäftscodes, Sonderzeichen, Öffnungszeiten oder Informationen dazu, ob das Geschäft geöffnet oder geschlossen ist, Telefonnummern, Website-URLs, Produktinformationen, Standort/Adresse oder Wegbeschreibungen oder Informationen zu anderen Geschäften im selben Gebäude an (z. B. „Chase-Geldautomat bei 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. Die korrekte Anschrift Ihres Unternehmens. Postfächer oder Briefkästen an unternehmensfremden 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 einem Ladengeschäft festgelegt werden. Dieses Feld sollte für Orte vom Typ CUSTOMER_LOCATION_ONLY nicht festgelegt werden. Wenn es festgelegt wird, wird der angegebene Wert verworfen.
websiteUri

string

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

object (BusinessHours)

Optional. Öffnungszeiten des Unternehmens.
specialHours

object (SpecialHours)

Optional. Spezielle Öffnungszeiten des Unternehmens. Dazu gehören in der Regel Feiertage und andere Zeiten außerhalb der regulären Ö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 erbringen ihre Dienstleistungen am Standort des Kunden. Wenn es sich um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt, wird in diesem Feld das Einzugsgebiet des Unternehmens beschrieben.
labels[]

string

Optional. Eine Sammlung frei definierbarer Strings, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind für Nutzer NICHT sichtbar. Nur Sie können sie sehen. Muss 1–255 Zeichen pro Label umfassen.
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 angegebene latlng-Wert beim Erstellen akzeptiert oder der latlng-Wert über die Google Unternehmensprofil-Website aktualisiert wurde. Dieses Feld kann nur von genehmigten Clients aktualisiert werden.
openInfo

object (OpenInfo)

Optional. Ein Flag, das 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 abheben.

Dieses Feld ist für alle Kategorien außer Unterkunftskategorien (z.B. Hotels, Motels, Gasthäuser) erforderlich.
relationshipData

object (RelationshipData)

Optional. Alle Standorte und Ketten, die mit diesem Standort verknüpft sind.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

Optional. Liste der von Händlern unterstützten Dienste. Ein Dienst kann z. B. „Haarschnitt“ oder „Warmwasserbereiter installieren“ sein. Doppelte Dienstleistungen werden automatisch entfernt.

PhoneNumbers

Eine Sammlung von Telefonnummern für das Unternehmen. Bei Aktualisierungen müssen beide Felder festgelegt werden. Kunden können nicht nur die primäre oder zusätzliche Telefonnummern über die Aktualisierungsmaske aktualisieren. Das internationale Telefonnummernformat wird bevorzugt, 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. Sie können bis zu zwei weitere Mobilfunk- oder Festnetztelefonnummern angeben, unter denen Ihr Unternehmen zu erreichen ist. Faxnummern sind nicht zulässig.

Kategorien

Eine Sammlung von Kategorien, die das Unternehmen beschreiben. Bei Aktualisierungen müssen beide Felder festgelegt werden. Kunden dürfen die primäre oder zusätzliche Kategorien nicht einzeln mithilfe der Aktualisierungsmaske aktualisieren.

JSON-Darstellung 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Felder
primaryCategory

object (Category)

Erforderlich. Kategorie, die das Kerngeschäft dieses Standorts am besten beschreibt.
additionalCategories[]

object (Category)

Optional. Zusätzliche Kategorien, die Ihr Unternehmen beschreiben. Mithilfe von Kategorien können Ihre Kunden genaue, spezifische Ergebnisse für Dienstleistungen finden, an denen sie interessiert sind. Damit die Informationen zu Ihrem Unternehmen korrekt und aktuell sind, sollten Sie so wenige Kategorien wie möglich verwenden, um Ihr Kerngeschäft zu beschreiben. Wählen Sie Kategorien aus, die so spezifisch wie möglich sind, aber Ihr Hauptgeschäft repräsentieren.

Kategorie

Eine Kategorie, die beschreibt, was dieses Unternehmen ist (nicht, was es tut). Eine Liste der gültigen Kategorie-IDs und die Zuordnungen zu ihren menschenlesbaren Namen finden Sie unter categories.list.

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Felder
name

string

Erforderlich. Eine stabile ID (von Google bereitgestellt) für diese Kategorie. Der Wert muss beim Ändern der Kategorie (beim Erstellen oder Aktualisieren eines Standorts) angegeben werden.
displayName

string

Nur Ausgabe. Der menschenlesbare Name der Kategorie. Dieser wird beim Lesen des Standorts festgelegt. Wenn Sie den Standort ändern, 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, in der ein vom Unternehmen angebotener Dienstleistungstyp beschrieben wird.

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

string

Nur Ausgabe. Eine stabile ID (von Google bereitgestellt) für diesen Diensttyp.
displayName

string

Nur Ausgabe. Der menschenlesbare Anzeigename für den Diensttyp.

MoreHoursType

Weitere Öffnungszeiten, die ein Unternehmen zusätzlich zu den regulären Öffnungszeiten anbieten kann.

JSON-Darstellung 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Felder
hoursTypeId

string

Nur Ausgabe. Eine von Google bereitgestellte stabile ID für diesen Öffnungszeitentyp.
displayName

string

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

string

Nur Ausgabe. Der menschenlesbare lokalisierte Anzeigename für den Öffnungszeitentyp.

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

TimePeriod

Gibt den Zeitraum an, in dem das Unternehmen geöffnet ist, beginnend mit dem angegebenen Tag und der angegebenen Uhrzeit für die Öffnung und endend mit dem angegebenen Tag und der angegebenen Uhrzeit für die Schließung. Die Schließzeit 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–24:00, wobei 24:00 Mitternacht am Ende des angegebenen Tagesfelds darstellt. Hinweis: In der Proto3-JSON-Zuordnung werden die Standard-Nullwerte (00:00) weggelassen, sodass für „openTime“ {} erzeugt wird.
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–24:00, wobei 24:00 Mitternacht am Ende des angegebenen Tagesfelds darstellt. Hinweis: In der Proto3-JSON-Zuordnung werden die Standard-Nullwerte (00:00) weggelassen, sodass für „closeTime“ {} erzeugt wird.

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 der 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. Der Zeitraum für spezielle Öffnungszeiten muss weniger als 24 Stunden betragen. openTime und startDate müssen vor closeTime und endDate liegen. closeTime und endDate können bis 11:59 Uhr am Tag nach dem angegebenen startDate verlängert werden. 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 mit speziellen Öffnungszeiten beginnt.
openTime

object (TimeOfDay)

Optional. Gültige Werte sind 00:00–24:00, wobei 24:00 Mitternacht am Ende des angegebenen Tagesfelds darstellt. Muss angegeben werden, wenn closed „false“ ist.
endDate

object (Date)

Optional. Das Datum, an dem der Zeitraum mit speziellen Öffnungszeiten endet. Wenn das Feld endDate nicht festgelegt ist, wird standardmäßig das in startDate angegebene Datum verwendet. Wenn dieses Feld festgelegt ist, muss es gleich oder höchstens 1 Tag nach startDate sein.
closeTime

object (TimeOfDay)

Optional. Gültige Werte sind 00:00–24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tagesfelds steht. Muss angegeben werden, wenn closed „false“ ist.
closed

boolean

Optional. Wenn „true“, werden endDate, openTime und closeTime ignoriert und das in startDate angegebene Datum wird so behandelt, als wäre der Standort den ganzen Tag geschlossen.

ServiceAreaBusiness

Unternehmen ohne festen Standort in einem Einzugsgebiet erbringen ihre Dienstleistungen am Standort des Kunden (z. B. Schlüsseldienst oder Klempner).

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

enum (BusinessType)

Erforderlich. Gibt den [Typ] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] des Unternehmens ohne festen Standort an.
places

object (Places)

Optional. Das Einzugsgebiet dieses Unternehmens, definiert durch eine Reihe von Orten.
regionCode

string

Nicht veränderbar. CLDR-Regionscode des Landes/der Region, in dem/der das Unternehmen mit 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 unterscheiden, in denen dieses Unternehmen Dienstleistungen anbietet (z.B. Unternehmen ohne festen Standort, die Dienstleistungen in anderen Regionen als der Region anbieten, in der sie ihren Sitz haben).

Wenn für diesen Standort nach der Erstellung eine Bestätigung erforderlich ist, muss die für die Bestätigung angegebene Adresse in dieser Region liegen. Außerdem muss der Geschäftsinhaber oder sein bevollmächtigter Vertreter Post an der angegebenen Bestätigungsadresse empfangen können.

BusinessType

Gibt an, ob das Unternehmen seine Dienstleistungen nur am Kundenstandort anbietet (z. B. für einen Abschleppdienst), oder sowohl für eine Adresse als auch für die Unternehmensstandorte (z. B. Pizzeria mit Essbereich, die auch einen Lieferdienst hat)

Enums
BUSINESS_TYPE_UNSPECIFIED Nur Ausgabe. Nicht angegeben.
CUSTOMER_LOCATION_ONLY bietet Dienstleistungen nur in der Umgebung an (nicht an der Geschäftsadresse). Wenn ein Unternehmen von CUSTOMER_AND_BUSINESS_LOCATION auf CUSTOMER_LOCATION_ONLY aktualisiert wird, muss die Standortaktualisierung die Feldmaske storefrontAddress enthalten und das Feld muss leer sein.
CUSTOMER_AND_BUSINESS_LOCATION Bietet Dienstleistungen an der Geschäftsadresse und in der Umgebung an.

Places

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

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

object (PlaceInfo)

Optional. Die durch Orts-IDs dargestellten Gebiete. Auf maximal 20 Orte beschränkt.

PlaceInfo

Definiert ein Gebiet, das 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 Ortes. 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 werden soll.

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 aktualisiert werden.
canReopen

boolean

Nur Ausgabe. Gibt an, ob dieses Unternehmen wiedereröffnet werden kann.
openingDate

object (Date)

Optional. Das Datum, an dem der Standort erö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

Gibt 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 wurde.
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,
  "isParticularlyPersonalPlace": boolean
}
Felder
hasGoogleUpdated

boolean

Nur Ausgabe. Gibt an, ob für die mit diesem Standort verknüpfte Orts-ID Aktualisierungen vorliegen, die vom Kunden aktualisiert oder abgelehnt werden müssen. Wenn dieser boolesche Wert festgelegt ist, sollten Sie die Methode getGoogleUpdated aufrufen, um die Informationen zu finden, die bestätigt werden müssen.
hasPendingEdits

boolean

Nur Ausgabe. Gibt an, ob Änderungen an den Attributen dieses Standorts den Status „Ausstehend“ haben.
canDelete

boolean

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

boolean

Nur Ausgabe. Eingestellt: Dieses Feld wird nicht mehr ausgefüllt und in einer zukünftigen Version entfernt.
canModifyServiceList

boolean

Nur Ausgabe. Gibt an, ob der Eintrag die Dienstleistungsliste ändern kann.
canHaveFoodMenus

boolean

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

boolean

Nur Ausgabe. Gibt an, ob der Standort mit Gesundheitsdaten arbeiten kann.
canOperateLodgingData

boolean

Nur Ausgabe. Gibt an, ob der Standort Daten zu Unterkünften verarbeiten 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 bei 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 in Google Maps.
newReviewUri

string

Nur Ausgabe. Ein Link zur Seite in der Google Suche, auf der ein Kunde eine Rezension für den Standort hinterlassen 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 „VoiceOfMerchant“ hat. Wenn dieser boolesche Wert „false“ ist, sollten Sie die API „locations.getVoiceOfMerchantState“ aufrufen, um Details dazu zu erhalten, warum die Zustimmung des Händlers nicht vorliegt.
isParticularlyPersonalPlace

boolean

Nur Ausgabe. Gibt an, ob der Ort als Ort mit besonderem Privatsphärebedarf eingestuft ist. Das bedeutet, dass es Einschränkungen bei den Funktionen des Standortverlaufs gibt. Wenn Sie der Meinung sind, dass es sich um einen Fehler handelt, lesen Sie diesen Hilfeartikel.

Profil

Alle Informationen zum Profil des Standorts.

JSON-Darstellung 
{
  "description": string
}
Felder
description

string

Erforderlich. Beschreibung des Ortes in Ihren eigenen Worten, die von niemandem sonst bearbeitet werden kann.

RelationshipData

Informationen zu allen über- und untergeordneten Standorten, die mit diesem Standort verknüpft sind.

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

object (RelevantLocation)

Optional. Der übergeordnete Ort, zu dem dieser Ort eine Beziehung hat.
childrenLocations[]

object (RelevantLocation)

Optional. Die Liste der untergeordneten Standorte, mit denen dieser Standort verknüpft ist.
parentChain

string

Optional. Der Ressourcenname der Kette, zu der dieser Standort gehört. [So finden Sie die Handelsketten-ID] [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. 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 Ort auf der anderen Seite der Beziehung mit seiner Orts-ID an.
relationType

enum (RelationType)

Erforderlich. Der Typ der Beziehung.

RelationType

Die anzugebenden Typbeziehungen.

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 obere Management oder dieselbe Organisation teilen, aber unterschiedliche wichtige Attribute wie Öffnungszeiten oder Telefonnummern haben. Beispiel: „Costco Pharmacy“ ist eine Abteilung von „Costco Wholesale“.
INDEPENDENT_ESTABLISHMENT_IN Dies betrifft Fälle, in denen sich zwei Standorte am selben physischen Ort befinden, aber zu unterschiedlichen Unternehmen gehören (z.B. Starbucks in einem Safeway, Geschäfte in einem Einkaufszentrum).

MoreHours

Die Zeiträume, in denen ein Standort für bestimmte Arten von Geschäften geöffnet ist.

JSON-Darstellung 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Felder
hoursTypeId

string

Erforderlich. Art der Öffnungszeiten. Kunden sollten {#link businessCategories:BatchGet} aufrufen, um die unterstützten Öffnungszeitentypen für die Kategorien ihrer Standorte abzurufen.
periods[]

object (TimePeriod)

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

ServiceItem

Eine Nachricht, die ein einzelnes Dienstelement beschreibt. Er wird verwendet, um die Art der Dienstleistung zu beschreiben, die der Händler anbietet. Beispiel: „Haarschnitt“ kann eine Dienstleistung sein.

JSON-Darstellung 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Felder
price

object (Money)

Optional. Stellt den Preis des Dienstleistungselements dar. Wir empfehlen, „currencyCode“ und „units“ festzulegen, wenn ein Preis angegeben wird. Dieser wird als Festpreis für das Serviceelement behandelt.
Eines der folgenden Felder sollte immer festgelegt sein. Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
structuredServiceItem

object (StructuredServiceItem)

Optional. Dieses Feld wird bei strukturierten Dienstdaten festgelegt.
freeFormServiceItem

object (FreeFormServiceItem)

Optional. Dieses Feld wird bei Dienstdaten im freien Format festgelegt.
Ende der sich gegenseitig ausschließenden Felder.

StructuredServiceItem

Stellt eine strukturierte Dienstleistung dar, die vom Händler angeboten wird. Beispiel: toilet_installation.

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 BatchGetCategories bereitgestellt.
description

string

Optional. Beschreibung des strukturierten Dienstleistungselements. Die Zeichenbeschränkung liegt bei 300.

FreeFormServiceItem

Stellt eine vom Händler angebotene Dienstleistung in freiem Format dar. Diese Dienste werden nicht als Teil unserer Gebäudedienstdaten offengelegt. Der Händler gibt die Namen für solche Dienste manuell über eine Geomerchant-Oberfläche ein.

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

string

Erforderlich. Dieses Feld enthält den Kategorienamen (d.h. die stabile ID der Kategorie). category und serviceTypeId sollten mit den möglichen Kombinationen in der Category-Nachricht übereinstimmen.
label

object (Label)

Erforderlich. Mit Sprach-Tags versehene Labels für das Element. Wir empfehlen, dass Artikelnamen maximal 140 Zeichen und Beschreibungen maximal 250 Zeichen lang sind. Dieses Feld sollte nur festgelegt werden, wenn die Eingabe ein benutzerdefiniertes Dienstobjekt ist. Standardisierte Dienstleistungstypen sollten mit „serviceTypeId“ aktualisiert werden.

Label

Label, das beim Anzeigen der Preisliste, des Abschnitts 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 Abschnitts oder des Artikels.
languageCode

string

Optional. Der BCP-47-Sprachcode, für den diese Strings gelten. Pro Sprache kann nur ein Satz von Labels festgelegt werden.

Methoden

create

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

list

 Ruft die Standorte für das angegebene Konto ab.