REST Resource: accounts.locations

Ressource: Location

Ein Standort. Eine ausführliche Beschreibung dieser Felder finden Sie in diesem Hilfeartikel. Unter Kategorieendpunkt finden Sie eine Liste gültiger Unternehmenskategorien.

JSON-Darstellung 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "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-Kennung für diesen Standort im Format accounts/{accountId}/locations/{locationId}

Bei Ü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. Dies ist eine Möglichkeit, den Standort mit Ihren eigenen Datensätzen zu verknüpfen.
locationName

string

Der Standortname sollte mit dem tatsächlichen Namen Ihres Unternehmens übereinstimmen, so wie er auch für Ihr Ladengeschäft, Ihre Website, Ihr Briefpapier und gegenüber Kunden gebräuchlich ist. Gegebenenfalls können zusätzliche Informationen in andere Felder der Ressource eingefügt werden (z. B. Address, Categories). Füge deinem Namen keine unnötigen Informationen hinzu (z. B. „Google“ statt „Google Inc. – Mountain View Corporate Headquarters“). Es dürfen keine Marketingslogans, Geschäftscodes, Sonderzeichen, Öffnungszeiten oder den Status „Geschlossen/geöffnet“, Telefonnummern, Website-URLs, Dienstleistungs-/Produktinformationen, Standort/Adresse oder Wegbeschreibungen oder Eingrenzungsinformationen (z. B. „Geldautomat in Duane Reade“) enthalten sein.
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 Adresse zur Beschreibung Ihres Unternehmensstandorts. Postfächer an entfernten Standorten sind nicht zulässig. Derzeit können Sie maximal fünf addressLines-Werte in der Adresse angeben.
primaryCategory

object (Category)

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

object (Category)

Zusätzliche Kategorien zur Beschreibung Ihres Unternehmens. Mithilfe von Kategorien können Ihre Kunden präzise und spezifische Ergebnisse für Dienstleistungen finden, für die sie sich interessieren. Damit die Informationen zu Ihrem Unternehmen immer aktuell und korrekt sind, verwenden Sie möglichst wenige Kategorien zur Beschreibung Ihres Kerngeschäfts. Wählen Sie möglichst spezifische Kategorien aus, die Ihrem Kerngeschäft entsprechen.
websiteUrl

string

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

object (BusinessHours)

Die Öffnungszeiten des Unternehmens.
specialHours

object (SpecialHours)

Spezielle Öffnungszeiten für das Unternehmen. Dazu zählen in der Regel Öffnungszeiten an Feiertagen und andere Zeiten außerhalb der regulären Öffnungszeiten. Diese überschreiben die regulären Öffnungszeiten.
serviceArea

object (ServiceAreaBusiness)

Unternehmen ohne festen Standort in einem Einzugsgebiet bieten ihre Dienstleistungen am Standort des Kunden an. Wenn es sich bei diesem Unternehmen um ein Unternehmen ohne festen Standort in einem Einzugsgebiet handelt, beschreibt dieses Feld die Einzugsgebiete, in denen das Unternehmen tätig ist.
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 frei definierbarer Strings, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind NICHT für Nutzer sichtbar, sondern nur für Sie sichtbar. Begrenzt 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 wurde. Dieses Feld wird nur bei GET-Anfragen zurückgegeben, wenn der vom Nutzer angegebene latlng-Wert beim Erstellen akzeptiert oder der latlng-Wert über die 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 Ein Satz boolescher Werte, die den Status eines Standorts widerspiegeln.
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)

Sie beschreibt Ihr Unternehmen mit Ihren eigenen Worten und vermittelt Nutzern die einzigartige Geschichte Ihres Unternehmens und Ihres Angebots.
relationshipData

object (RelationshipData)

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

object (MoreHours)

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

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

TimePeriod

Stellt einen Zeitraum dar, in dem das Unternehmen geöffnet ist, beginnend am angegebenen Tag bzw. zur angegebenen Uhrzeit bis zum angegebenen Geschäftsschluss. Der Geschäftsschluss muss nach dem Geschäftsbeginn liegen, beispielsweise später am selben Tag oder an einem darauffolgenden Tag.

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

enum (DayOfWeek)

Gibt die day of the week an, an der 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 Tagesfelds steht.
closeDay

enum (DayOfWeek)

Gibt die day of the week an, an der 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 Tagesfelds steht.

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

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 regulären Öffnungszeiten des Unternehmens.

SpecialHourPeriod

Stellt einen einzelnen Zeitraum dar, in dem die Öffnungszeiten eines Standorts von den normalen Öffnungszeiten abweichen. Ein spezieller Stundenzeitraum muss einen Bereich von weniger als 24 Stunden darstellen. openTime und startDate müssen vor closeTime und endDate liegen. closeTime und endDate können sich bis 11:59 Uhr am Tag nach dem angegebenen startDate erstrecken. Die folgenden Eingaben sind beispielsweise gültig:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

Die folgenden Eingaben sind ungültig:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON-Darstellung 
{
  "startDate": {
    object (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Felder
startDate

object (Date)

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

string

Die Echtzeit am startDate, zu der 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 Mitternacht am Ende des angegebenen Tagesfelds steht. Muss angegeben werden, wenn isClosed „false“ ist.
endDate

object (Date)

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

string

Die Echtzeit am endDate, zu der 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 Mitternacht am Ende des angegebenen Tagesfelds steht. Muss angegeben werden, wenn isClosed „false“ ist.
isClosed

boolean

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

ServiceAreaBusiness

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

JSON-Darstellung 
{
  "businessType": enum (BusinessType),

  // 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 Dienstleistungen anbietet. Für coverageArea ist nur einer der folgenden Werte zulässig:
radius

object (PointRadius)

Nur Ausgabe Das Gebiet, in dem das Unternehmen tätig ist (um einen Punkt herum).
places

object (Places)

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

BusinessType

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

Enums
BUSINESS_TYPE_UNSPECIFIED Nur Ausgabe Nicht angegeben.
CUSTOMER_LOCATION_ONLY Der Dienst wird nur in der näheren Umgebung und nicht an der Geschäftsadresse angeboten.
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- und Längengrad, der den Mittelpunkt eines durch den Radius definierten Bereichs angibt.
radiusKm

number

Die Entfernung in Kilometern des Umkreises um den Punkt.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Dies wird als Paar von Double-Werten zur Darstellung von Breiten- und Längengraden ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung 
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

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

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

Places

Definiert die Gesamtheit von Gebieten, die durch mehrere Orte dargestellt werden.

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

object (PlaceInfo)

Die Bereiche, die durch Orts-IDs dargestellt werden. Es sind auf maximal 20 Orte beschränkt.

PlaceInfo

Definiert einen Bereich, der durch eine Orts-ID dargestellt wird.

JSON-Darstellung 
{
  "name": string,
  "placeId": string
}
Felder
name

string

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

string

Die ID des Orts. Muss einer Region entsprechen.

LocationKey

Alternative Schlüsselreferenzen/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 hier die ID der Google+ Seite dieses Standorts eingefügt.
placeId

string

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

Falls dieser 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 Wert explicitNoPlaceId gilt unabhängig davon, ob eine nicht konfigurierte Orts-ID beabsichtigt ist oder nicht.
explicitNoPlaceId

boolean

Nur Ausgabe Der Wert „true“ bedeutet, dass eine nicht festgelegte Orts-ID beabsichtigt ist. Dies unterscheidet sich von der noch nicht erfolgten Verknüpfung.
requestId

string

Nur Ausgabe Die requestId, die zum Erstellen dieses Standorts verwendet wurde. Dieses Feld kann leer sein, wenn dieser Standort außerhalb der Google My Business API oder der Google Unternehmensprofil-Standorte erstellt wurde.

AdWordsLocationExtensions

Zusätzliche Informationen, die in AdWords angezeigt werden

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

string

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

OpenInfo

Informationen zum Erö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 auf „geschlossen“ aktualisiert 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 liegen oder darf nicht mehr als ein Jahr in der Zukunft liegen.

OpenForBusiness

Zeigt den Status eines Standorts an.

Enums
OPEN_FOR_BUSINESS_UNSPECIFIED Nicht angegeben.
OPEN Gibt an, dass der Standort geöffnet ist.
CLOSED_PERMANENTLY Gibt an, dass der Standort dauerhaft geschlossen ist.
CLOSED_TEMPORARILY Gibt an, dass der Standort vorübergehend geschlossen ist. Dieser Wert kann nur auf veröffentlichte Standorte angewendet werden, d.h. locationState.is_publish = true. Wenn das Statusfeld auf diesen Wert aktualisiert wird, müssen Clients updateMask explizit auf openInfo.status setzen. 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 widerspiegeln.

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 wurde. Gesperrte Standorte sind für Endnutzer in Google-Produkten nicht sichtbar. Wenn Sie der Meinung sind, dass ein Fehler vorliegt, lesen Sie diesen Hilfeartikel.
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 erneut bestätigt werden muss.
isPendingReview

boolean

Nur Ausgabe Gibt an, ob die Überprüfung des Standorts ausstehend ist.
isDisabled

boolean

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

boolean

Nur Ausgabe Gibt an, ob der Standort veröffentlicht ist.
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 „Bearbeitung 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 für den Standort Gesundheitsdaten verarbeitet werden können.
canOperateLodgingData

boolean

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

Attribut

Ein Standortattribut. Attribute liefern zusätzliche Informationen zu einem Standort. Die Attribute, die für einen Standort festgelegt werden können, können je nach den Eigenschaften dieses Standorts (z. B. Kategorie) variieren. 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 lässt sich bestimmen, wie der Wert interpretiert wird.
values[]

value (Value format)

Die Werte für dieses Attribut. Der Typ der bereitgestellten Werte muss dem erwarteten Wert für dieses Attribut 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)

Lautet der Attributwerttyp REPEATED_ENUM, enthält dieser 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. Dies besteht aus zwei Listen mit Wert-IDs: Die festgelegten (true) und die nicht festgelegten (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 valueType URL.

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, der von diesem Standort dupliziert wurde. Nur vorhanden, wenn locationState.is_duplicate „true“ ist. Eingestellt: Detaillierte Informationen zu Duplikaten werden nicht mehr unterstützt.
mapsUrl

string

Ein Link zum Standort auf Google Maps.
newReviewUrl

string

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

Duplizieren

Informationen zum Standort, der von diesem Standort dupliziert wurde.

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

string

Der Ressourcenname des Standorts, der dupliziert wird. Dieses Feld wird nur ausgefüllt, wenn der authentifizierte Nutzer Zugriff auf diesen Standort hat und dieser Standort nicht gelöscht wird.
placeId

string

Die Orts-ID des Standorts, der dupliziert wurde.
access

enum (Access)

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

Zugriff

Die Zugriffsebene des Nutzers für den Standort, den er dupliziert hat. Dies ersetzt die Inhaberschaft 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 Standort, den er dupliziert hat.
INSUFFICIENT Der Nutzer hat keinen Zugriff auf den Standort, den er dupliziert hat.

PriceList

Eingestellt: eine Liste mit Preisinformationen für Artikel. Preislisten sind eine oder mehrere Preislisten, die jeweils einen oder mehrere Abschnitte mit einem oder mehreren Artikeln enthalten. Beispielsweise können Lebensmittelpreislisten Frühstücks-, Mittags- und Abendmenüs mit Abschnitten für Burger/Steaks/Meeresfrüchte enthalten.

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 können innerhalb dieses Standorts nicht dupliziert werden.
labels[]

object (Label)

Erforderlich. Labels mit Sprach-Tags 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 Speisekarteninformationen zu erfassen.
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 Abschnitt oder den Artikel
description

string

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

string

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

Abschnitt

Ein Abschnitt der Preisliste, der einen oder mehrere Artikel enthält.

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 können innerhalb dieses Standorts nicht dupliziert werden.
labels[]

object (Label)

Erforderlich. Labels mit Sprach-Tags für den Bereich. Abschnittsnamen und -beschreibungen sollten maximal 140 Zeichen lang sein. Mindestens ein Labelsatz ist erforderlich.
sectionType

enum (SectionType)

Optional. Typ des aktuellen Preislistenbereichs. Der Standardwert ist FOOD.
items[]

object (Item)

Artikel, die in diesem Abschnitt der Preisliste enthalten sind.

SectionType

Typ des Bereichs.

Enums
SECTION_TYPE_UNSPECIFIED Nicht angegeben.
FOOD Der Bereich enthält Elemente, die Lebensmittel darstellen.
SERVICES Der Bereich enthält Elemente, die Dienste 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 können innerhalb dieses Standorts nicht dupliziert werden.
labels[]

object (Label)

Erforderlich. Labels mit Sprach-Tags für das Element. Wir empfehlen, dass Elementnamen maximal 140 Zeichen und Beschreibungen maximal 250 Zeichen lang sein sollten. Mindestens ein Labelsatz ist erforderlich.
price

object (Money)

Optional. Preis des Artikels

Geldbetrag

Stellt einen Geldbetrag mit Währungstyp dar.

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

string

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

string (int64 format)

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

integer

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

Profil

Alle Informationen zum Profil des Standorts.

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

string

Beschreibung des Orts, die von anderen nicht bearbeitet werden kann.

RelationshipData

Informationen zu allen übergeordneten und untergeordneten Standorten, die sich auf diesen Standort beziehen.

JSON-Darstellung 
{
  "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. Art der Öffnungszeiten. Kunden sollten {#link businessCategories:BatchGet} anrufen, um unterstützte Öffnungszeiten für die Kategorien ihrer Standorte zu erhalten.
periods[]

object (TimePeriod)

Erforderlich. Eine Sammlung von Uhrzeiten, zu denen dieser Standort geöffnet ist. Jeder Zeitraum steht für einen Zeitraum, in dem der Standort in der Woche geöffnet ist.

Methoden

associate

 Ordnet einer Orts-ID einen Standort zu.

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 einen neuen location, der dem angegebenen Konto gehört, und gibt ihn zurück.

delete

 Löscht einen Standort.

fetchVerificationOptions

 Meldet alle zulässigen 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 eines bestimmten Orts 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 für einen Standort ab

list

 Listet die Standorte für das angegebene Konto auf.

patch

 Aktualisiert den angegebenen Standort.

reportInsights

 Gibt einen Bericht zurück, der Informationen zu einem oder mehreren Messwerten nach Standort enthält.

transfer
(deprecated)

 Verschiebt einen Standort von einem Konto, dessen Inhaber der Nutzer ist, in ein anderes Konto, das derselbe Nutzer verwaltet.

updateFoodMenus

 Aktualisiert die Speisekarten eines bestimmten Standorts

updateHealthProviderAttributes

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

updateServiceList

 Aktualisiert die angegebene Dienstliste eines Standorts.

verify

 Startet den Bestätigungsprozess für einen Standort.