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.

PostalAddress

Stellt eine Postanschrift dar, z. B. für Postsendungen oder Zahlungsadressen. Mit einer Postanschrift kann ein Postdienst Sendungen an ein Gebäude, ein Postfach oder Ähnliches zustellen. Eine Postanschrift ist nicht dazu gedacht, geografische Standorte wie Straßen, Städte oder Berge zu modellieren.

In der Regel wird eine Adresse durch Nutzereingabe oder durch Importieren vorhandener Daten erstellt, je nach Art des Prozesses.

Hinweise zur Eingabe oder Bearbeitung von Adressen:

  • Verwenden Sie ein Adress-Widget, das für die Internationalisierung geeignet ist, z. B. https://github.com/google/libaddressinput.
  • Nutzern sollten keine UI-Elemente für die Eingabe oder Bearbeitung von Feldern außerhalb der Länder angezeigt werden, in denen dieses Feld verwendet wird.

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. Nicht in allen Ländern werden Postleitzahlen verwendet oder sind erforderlich. Wenn sie jedoch verwendet werden, können sie eine zusätzliche Validierung mit anderen Teilen der Adresse auslösen (z. B. Validierung des Bundesstaats oder der 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 Zahl (z. B. „CEDEX 7“), oder nur eine Zahl, die den „Sektorcode“ (Jamaika), den „Liefergebietsindikator“ (Malawi) oder den „Postamtsindikator“ (Côte d'Ivoire) darstellt.
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 die Provinz und nicht die autonome Gemeinschaft (z. B. „Barcelona“ und nicht „Katalonien“). In vielen Ländern werden in der Postadresse keine Verwaltungsgebiete verwendet. In der Schweiz sollte dieses Feld beispielsweise nicht ausgefüllt werden.
locality

string

Optional. Bezieht sich im Allgemeinen auf den Ort der Adresse. Beispiele: Stadt in den USA, italienische Gemeinde, Post Town in Großbritannien. In Regionen, in denen Orte nicht klar definiert sind oder nicht gut in diese Struktur passen, lassen Sie locality leer und verwenden Sie addressLines.
sublocality

string

Optional. Unterlokalität der Adresse. Das kann beispielsweise ein Stadtteil, ein Bezirk oder ein Viertel sein.
addressLines[]

string

Unstrukturierte Adresszeilen, mit denen die unteren Ebenen einer Adresse beschrieben werden.

Da Werte in addressLines keine Typinformationen enthalten und manchmal mehrere Werte in einem einzelnen Feld enthalten können (z. B. „Austin, TX“), ist es wichtig, dass die Zeilenreihenfolge klar ist. Die Reihenfolge der Adresszeilen sollte der „Umschlagreihenfolge“ für das Land oder die Region der Adresse entsprechen. An Orten, an denen dies variieren kann (z. B. Japan), wird address_language verwendet, um dies explizit anzugeben (z. B. „ja“ für die Reihenfolge von groß nach klein und „ja-Latn“ oder „en“ für die Reihenfolge von klein nach groß). So kann die spezifischste Zeile einer Adresse basierend auf der Sprache ausgewählt werden.

Die minimal zulässige strukturelle Darstellung einer Adresse besteht aus einem regionCode, wobei alle verbleibenden Informationen in der addressLines platziert werden. 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.

Wenn Sie eine Adresse erstellen, die nur regionCode und addressLines enthält, und diese dann geocodieren, ist das die empfohlene Methode für vollständig unstrukturierte Adressen. Sie müssen dann nicht raten, welche Teile der Adresse Orte oder Verwaltungsgebiete sein sollen.
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 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.

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. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein.
seconds

integer

Sekunden einer Minute. Muss größer oder gleich 0 und normalerweise kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein.

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.

Datum

Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum bezieht sich auf den gregorianischen Kalender. Dies kann Folgendes darstellen:

  • Ein ganzes Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind
  • Einen Monat und einen Tag mit einem Jahr von 0 (z. B. einen Jahrestag)
  • Ein Jahr für sich allein, also mit einem Monat und einem Tag von 0
  • Ein Jahr und einen Monat mit einem Tag von 0 (z. B. ein Ablaufdatum der 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 kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird.
month

integer

Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.
day

integer

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist.

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.

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 es dem World Geodetic System 1984 (WGS 84) 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 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 categories.batchGet 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.

Geld

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. Wenn currencyCode beispielsweise "USD" ist, entspricht 1 Einheit einem 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

 Ruft die Standorte für das angegebene Konto ab.