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,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Felder
name

string

Google-ID für diesen Standort im Format accounts/{accountId}/locations/{locationId}

Im Zusammenhang mit Übereinstimmungen wird dieses Feld nicht ausgefüllt.

languageCode

string

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

storeCode

string

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.

locationName

string

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“).

primaryPhone

string

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

Bis zu zwei weitere Mobilfunk- oder Festnetztelefonnummern, unter denen Ihr Unternehmen zu erreichen ist. Faxnummern sind nicht zulässig.

address

object (PostalAddress)

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.

primaryCategory

object (Category)

Kategorie, die das Kerngeschäft des Standorts am besten beschreibt.

additionalCategories[]

object (Category)

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.

websiteUrl

string

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)

Die Öffnungszeiten des Unternehmens.

specialHours

object (SpecialHours)

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.

serviceArea

object (ServiceAreaBusiness)

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.

locationKey

object (LocationKey)

Eine Sammlung von Schlüsseln, die dieses Unternehmen mit anderen Google-Produkten verknüpfen, z. B. einer Google+ Seite und Google Maps-Orten.

labels[]

string

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. Beschränkt auf 255 Zeichen (pro Label).

adWordsLocationExtensions

object (AdWordsLocationExtensions)

Zusätzliche Informationen, die in AdWords angezeigt werden.

latlng

object (LatLng)

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 Unternehmensprofil-Website aktualisiert wurde. Dieses Feld kann nicht aktualisiert werden.

openInfo

object (OpenInfo)

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

locationState

object (LocationState)

Nur Ausgabe. Eine Reihe von booleschen Werten, die den Status eines Standorts angeben.

attributes[]

object (Attribute)

Attribute für diesen Standort.

metadata

object (Metadata)

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

priceLists[]
(deprecated)

object (PriceList)

Eingestellt: Preislisteninformationen für diesen Standort.

profile

object (Profile)

Ihr Unternehmen mit Ihren eigenen Worten beschreiben und Nutzern mitteilen, wodurch sich Ihr Unternehmen und sein Angebot von anderen abhebt.

relationshipData

object (RelationshipData)

Alle zugehörigen Standorte und Ketten.

moreHours[]

object (MoreHours)

Weitere Öffnungszeiten für verschiedene Abteilungen oder Kunden eines Unternehmens.

BusinessHours

Die Zeiträume, in denen dieser Standort geöffnet ist. Enthält eine Sammlung von TimePeriod-Instanzen.

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

object (TimePeriod)

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

enum (DayOfWeek)

Gibt den day of the week an, an dem dieser Zeitraum beginnt.

openTime

string

Zeit im erweiterten 24-Stunden-Format ISO 8601 (hh:mm). Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tages steht.

closeDay

enum (DayOfWeek)

Gibt den day of the week an, an dem dieser Zeitraum endet.

closeTime

string

Zeit im erweiterten 24-Stunden-Format ISO 8601 (hh:mm). 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

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)

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

object (Date)

Das Kalenderdatum, an dem dieser Zeitraum beginnt.

openTime

string

Die Echtzeit am startDate, wenn ein Standort geöffnet wird, ausgedrückt im erweiterten 24-Stunden-Format ISO 8601. (hh:mm) Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für die Mitternacht am Ende des angegebenen Tages steht. Muss angegeben werden, wenn isClosed „false“ ist.

endDate

object (Date)

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

string

Die Echtzeit am endDate, wenn ein Standort geschlossen wird, ausgedrückt im erweiterten 24-Stunden-Format ISO 8601. (hh:mm) Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für die Mitternacht am Ende des angegebenen Tages steht. Muss angegeben werden, wenn isClosed „false“ ist.

isClosed

boolean

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.

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),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Felder
businessType

enum (BusinessType)

Gibt die type des Unternehmens ohne festen Standort in einem Einzugsgebiet an.

Union-Feld coverageArea. Gibt den Abdeckungsbereich an, in dem das Unternehmen seine Dienstleistungen anbietet. Für coverageArea ist nur einer der folgenden Werte zulässig:
radius

object (PointRadius)

Nur Ausgabe. Das Gebiet, in dem das Unternehmen Dienstleistungen anbietet, rund um einen Punkt herum.

places

object (Places)

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

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.
CUSTOMER_AND_BUSINESS_LOCATION Der Dienst wird an der Geschäftsadresse und in der Umgebung angeboten.

PointRadius

Ein Radius um einen bestimmten Punkt (Breiten-/Längengrad)

JSON-Darstellung
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Felder
latlng

object (LatLng)

Der Breiten-/Längengrad, der den Mittelpunkt eines durch den Radius definierten Bereichs angibt.

radiusKm

number

Die Entfernung in Kilometern des Gebiets um den Punkt.

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.

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
{
  "name": string,
  "placeId": string
}
Felder
name

string

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

placeId

string

Die ID des Orts. Muss einer region.

LocationKey

Alternative/Ersatzschlüsselverweise für einen Standort.

JSON-Darstellung
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Felder
plusPageId

string

Nur Ausgabe. Wenn mit diesem Standort eine Google+ Seite verknüpft ist, wird die ID der Google+ Seite für diesen Standort in dieses Feld eingefügt.

placeId

string

Wenn dieser Standort bestätigt wurde und mit Google Maps verknüpft ist bzw. in Google Maps angezeigt wird, enthält dieses Feld die Orts-ID des Standorts. Diese ID kann in verschiedenen Places APIs verwendet werden.

Wenn der Standort nicht bestätigt ist, kann dieses Feld ausgefüllt werden, wenn der Standort mit einem Ort verknüpft wurde, der in Google Maps angezeigt wird.

Dieses Feld kann während „Create“-Aufrufen festgelegt werden, aber nicht für „Update“.

Der zusätzliche boolesche explicitNoPlaceId-Wert gilt unabhängig davon, ob eine nicht festgelegte Orts-ID beabsichtigt ist oder nicht.

explicitNoPlaceId

boolean

Nur Ausgabe. Der Wert „true“ gibt an, dass eine nicht festgelegte Orts-ID beabsichtigt ist. Im Gegensatz dazu wurde noch keine Verknüpfung erstellt.

requestId

string

Nur Ausgabe. Der requestId, der zum Erstellen dieses Standorts verwendet wurde. Kann leer sein, wenn dieser Standort außerhalb der Google My Business API oder von Google Unternehmensprofil-Standorten erstellt wurde.

AdWordsLocationExtensions

Zusätzliche Informationen, die in AdWords angezeigt werden.

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

string

Eine alternative Telefonnummer, die in AdWords-Standorterweiterungen anstelle der primären Telefonnummer des Standorts angezeigt wird

OpenInfo

Informationen zum Öffnungsstatus des Unternehmens.

JSON-Darstellung
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Felder
status

enum (OpenForBusiness)

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)

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. Dieser Wert kann nur auf veröffentlichte Standorte angewendet werden (d.h. locationState.is_publish = true). Wenn Sie das Statusfeld auf diesen Wert aktualisieren, müssen Clients updateMask explizit auf openInfo.status festlegen. Während dieses Aktualisierungsaufrufs können keine anderen Aktualisierungsmasken festgelegt werden. Dies ist eine vorübergehende Einschränkung, die bald aufgehoben wird.

LocationState

Enthält eine Reihe von booleschen Werten, die den Status eines Standorts wiedergeben.

JSON-Darstellung
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
Felder
isGoogleUpdated

boolean

Nur Ausgabe. Gibt an, ob die mit diesem Standort verknüpfte Orts-ID aktualisiert wurde.

isDuplicate

boolean

Nur Ausgabe. Gibt an, ob der Standort ein Duplikat eines anderen Standorts ist.

isSuspended

boolean

Nur Ausgabe. Gibt an, ob der Standort gesperrt ist. Gesperrte Standorte sind für Endnutzer in Google-Produkten nicht sichtbar. Wenn du der Meinung bist, dass hier ein Fehler vorliegt, findest du in diesem Hilfeartikel weitere Informationen.

canUpdate

boolean

Nur Ausgabe. Gibt an, ob der Standort aktualisiert werden kann.

canDelete

boolean

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

isVerified

boolean

Nur Ausgabe. Gibt an, ob der Standort bestätigt wurde.

needsReverification

boolean

Nur Ausgabe. Gibt an, ob der Standort noch einmal bestätigt werden muss.

isPendingReview

boolean

Nur Ausgabe. Gibt an, ob die Überprüfung des Standorts noch aussteht.

isDisabled

boolean

Nur Ausgabe. Gibt an, ob der Standort deaktiviert ist.

isPublished

boolean

Nur Ausgabe. Gibt an, ob der Standort veröffentlicht wurde.

isDisconnected

boolean

Nur Ausgabe. Gibt an, ob der Standort von einem Ort in Google Maps getrennt ist.

isLocalPostApiDisabled

boolean

Nur Ausgabe. Gibt an, ob accounts.locations.localPosts für diesen Standort deaktiviert ist.

canModifyServiceList

boolean

Nur Ausgabe. Gibt an, ob der Eintrag eine ServiceList ändern kann.

canHaveFoodMenus

boolean

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

hasPendingEdits

boolean

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

hasPendingVerification

boolean

Nur Ausgabe. Gibt an, ob für den Standort ausstehende Bestätigungsanfragen vorhanden sind.

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.

Attribut

Ein Standortattribut. Attribute liefern zusätzliche Informationen zu einem Standort. Welche Attribute für einen Standort festgelegt werden können, hängt von den Eigenschaften des jeweiligen Standorts ab (z. B. Kategorie). Die verfügbaren Attribute werden von Google festgelegt und können ohne API-Änderungen hinzugefügt und entfernt werden.

JSON-Darstellung
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Felder
attributeId

string

Die ID des Attributs. Attribut-IDs werden von Google bereitgestellt.

valueType

enum (AttributeValueType)

Nur Ausgabe. Der Typ des Werts, den dieses Attribut enthält. Damit wird festgelegt, wie der Wert zu interpretieren ist.

values[]

value (Value format)

Die Werte für dieses Attribut. Der Typ der bereitgestellten Werte muss dem für dieses Attribut erwarteten Typ entsprechen. Siehe AttributeValueType. Dies ist ein wiederkehrendes Feld, in dem mehrere Attributwerte angegeben werden können. Attributtypen unterstützen nur einen Wert.

repeatedEnumValue

object (RepeatedEnumAttributeValue)

Wenn der Attributwerttyp REPEATED_ENUM lautet, enthält dieses Feld den Attributwert. Die anderen Wertefelder müssen leer sein.

urlValues[]

object (UrlAttributeValue)

Wenn der Attributwerttyp "URL" lautet, enthält dieses Feld den oder die Werte für dieses Attribut. Die anderen Wertefelder müssen leer sein.

RepeatedEnumAttributeValue

Werte für ein Attribut mit einem valueType von REPEATED_ENUM. Diese besteht aus zwei Listen mit Wert-IDs: den Wert-IDs, die festgelegt sind (true) und denen, die nicht konfiguriert sind (false). Fehlende Werte werden als unbekannt betrachtet. Es muss mindestens ein Wert angegeben werden.

JSON-Darstellung
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
Felder
setValues[]

string

Festgelegte Enum-Werte.

unsetValues[]

string

Nicht festgelegte Enum-Werte.

UrlAttributeValue

Werte für ein Attribut mit einer URL als valueType.

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

string

Die URL.

Metadaten

Zusätzliche Informationen zum Standort, die nicht vom Nutzer bearbeitet werden können

JSON-Darstellung
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Felder
duplicate
(deprecated)

object (Duplicate)

Informationen zum Standort, den dieser Standort dupliziert. Ist nur vorhanden, wenn locationState.is_duplicate „true“ ist. Eingestellt: Detaillierte Informationen zu Duplikaten werden nicht mehr unterstützt.

mapsUrl

string

Ein Link zum Standort in Google Maps.

newReviewUrl

string

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

Duplizieren

Informationen zum Standort, den dieser Standort dupliziert.

JSON-Darstellung
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
Felder
locationName

string

Der Ressourcenname des Standorts, den dies dupliziert. Das Feld wird nur ausgefüllt, wenn der authentifizierte Nutzer Zugriffsrechte für diesen Standort hat und dieser nicht gelöscht wird.

placeId

string

Die Orts-ID des duplizierten Standorts.

access

enum (Access)

Gibt an, ob der Nutzer Zugriff auf den duplizierten Standort hat.

Zugriff

Zugriffsebene des Nutzers für den duplizierten Standort Dies ersetzt „Eigentumsrechte“ und sollte stattdessen verwendet werden.

Enums
ACCESS_UNSPECIFIED Nicht angegeben.
ACCESS_UNKNOWN Es konnte nicht ermittelt werden, ob der Nutzer Zugriff auf den duplizierten Standort hat.
ALLOWED Der Nutzer hat Zugriff auf den duplizierten Standort.
INSUFFICIENT Der Nutzer hat keinen Zugriff auf den duplizierten Standort.

PriceList

Veraltet: Eine Liste mit Informationen zu Artikelpreisen. Preislisten sind als eine oder mehrere Preislisten strukturiert, die jeweils einen oder mehrere Abschnitte mit einem oder mehreren Artikeln enthalten. Beispielsweise können Lebensmittelpreislisten für Frühstücks-, Mittags- und Abendmenüs stehen und Abschnitte für Burger, Steak und Meeresfrüchte sein.

JSON-Darstellung
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Felder
priceListId

string

Erforderlich. ID für die Preisliste. Preislisten-, Abschnitts- und Artikel-IDs dürfen an diesem Standort nicht dupliziert werden.

labels[]

object (Label)

Erforderlich. Mit Sprach-Tags versehene Labels für die Preisliste.

sourceUrl

string

Optionale Quell-URL, von der die Preisliste abgerufen wurde. Dabei kann es sich beispielsweise um die URL der Seite handeln, die automatisch kopiert wurde, um die Menüinformationen einzutragen.

sections[]

object (Section)

Erforderlich. Bereiche für diese Preisliste. Jede Preisliste muss mindestens einen Abschnitt enthalten.

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.

Abschnitt

Ein Abschnitt der Preisliste mit einem oder mehreren Artikeln.

JSON-Darstellung
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Felder
sectionId

string

Erforderlich. ID für den Bereich. Preislisten-, Abschnitts- und Artikel-IDs dürfen an diesem Standort nicht dupliziert werden.

labels[]

object (Label)

Erforderlich. Mit Sprach-Tags versehene Labels für den Bereich. Abschnittsnamen und -beschreibungen sollten aus maximal 140 Zeichen bestehen. Mindestens ein Labelsatz ist erforderlich.

sectionType

enum (SectionType)

Optional. Typ des Abschnitts mit der aktuellen Preisliste. Der Standardwert ist FOOD.

items[]

object (Item)

Artikel, die in diesem Abschnitt der Preisliste enthalten sind.

SectionType

Typ des Abschnitts.

Enums
SECTION_TYPE_UNSPECIFIED Nicht angegeben.
FOOD Abschnitt enthält Artikel, die Lebensmittel repräsentieren.
SERVICES Der Abschnitt enthält Elemente, die Dienstleistungen darstellen.

Element

Ein einzelnes Listenelement. Jede Variante eines Artikels in der Preisliste sollte einen eigenen Artikel mit eigenen Preisdaten haben.

JSON-Darstellung
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Felder
itemId

string

Erforderlich. ID des Artikels. Preislisten-, Abschnitts- und Artikel-IDs dürfen an diesem Standort nicht dupliziert werden.

labels[]

object (Label)

Erforderlich. Mit Sprach-Tags versehene Labels für den Artikel. Artikelnamen sollten maximal 140 Zeichen und Beschreibungen maximal 250 Zeichen lang sein. Mindestens ein Labelsatz ist erforderlich.

price

object (Money)

Optional. Preis des Artikels.

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.

Profil

Alle Informationen zum Profil des Standorts.

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

string

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
{
  "parentChain": string
}
Felder
parentChain

string

Der Ressourcenname der Kette, der dieser Standort angehört. How to find Chain ID

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.

Methoden

associate

Verknüpft einen Standort mit einer Orts-ID.

batchGet

Ruft alle angegebenen Standorte im angegebenen Konto ab.

batchGetReviews

Gibt die paginierte Liste mit Rezensionen für alle angegebenen Standorte zurück

clearAssociation

Löscht eine Verknüpfung zwischen einem Standort und seiner Orts-ID.

create

Erstellt eine neue location, die dem angegebenen Konto gehört, und gibt sie zurück.

delete

Löscht einen Standort.

fetchVerificationOptions

Meldet alle infrage kommenden Bestätigungsoptionen für einen Standort in einer bestimmten Sprache.

findMatches

Findet alle möglichen Standorte, die mit dem angegebenen Standort übereinstimmen.

get

Ruft den angegebenen Speicherort ab.

getFoodMenus

Gibt die Speisekarten für einen bestimmten Standort zurück

getGoogleUpdated

Ruft die von Google aktualisierte Version des angegebenen Standorts ab.

getHealthProviderAttributes

Gibt die Attribute des Gesundheitsdienstleisters für einen bestimmten Standort zurück.

getServiceList

Ruft die angegebene Dienstliste eines Standorts ab.

list

Listet die Standorte für das angegebene Konto auf.

patch

Aktualisiert den angegebenen Standort.

reportInsights

Gibt einen Bericht mit Statistiken zu einem oder mehreren Messwerten nach Standort zurück.

transfer
(deprecated)

Verschiebt einen Standort von einem Konto des Nutzers in ein anderes Konto, das dieser Nutzer verwaltet.

updateFoodMenus

Aktualisiert die Speisekarten eines bestimmten Standorts

updateHealthProviderAttributes

Aktualisiert die Attribute des Gesundheitsdienstleisters für einen bestimmten Standort.

updateServiceList

Aktualisiert die angegebene Dienstleistungsliste eines Standorts.

verify

Startet den Bestätigungsprozess für einen Standort.