Package google.mybusiness.businessinformation.v1

Index

AttributesService

Ermöglicht Clients das Suchen und Aktualisieren von Attributen für einen bestimmten Standort.

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

Sucht alle für einen bestimmten Standort festgelegten Attribute.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

Ruft die von Google aktualisierte Version des angegebenen Standorts ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

Gibt die Liste der Attribute zurück, die für einen Standort mit der angegebenen primären Kategorie und dem angegebenen Land verfügbar wären.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

Attribute für einen bestimmten Standort aktualisieren

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CategoriesService

Diese API enthält Informationen zu unterstützten Kategorien für Unternehmensstandorte auf Google. Weitere Informationen finden Sie im Abschnitt zu den Kategorien in diesem Artikel: https://support.google.com/business/answer/3038177.

BatchGetCategories

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

Gibt eine Liste von Unternehmenskategorien für die angegebenen Sprach- und GConcept-IDs zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

Gibt eine Liste mit Unternehmenskategorien zurück. Die Suche stimmt mit dem Kategorienamen überein, aber nicht mit der Kategorie-ID.

Die Suche stimmt nur mit dem Anfang eines Kategorienamens überein (d. h., „food“ kann „Food Court“ zurückgeben, aber nicht „Fast Food Restaurant“).

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

Handelsketten

Ein Dienst zum Suchen von Informationen zu einer Unternehmenskette.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

Ruft die angegebene Kette ab. Gibt NOT_FOUND zurück, wenn die Kette nicht vorhanden ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

Sucht die Kette anhand des Kettennamens.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GoogleLocations

Diese API ermöglicht den Zugriff auf und die Suche in GoogleLocation.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

Es wird in allen möglichen Standorten gesucht, die mit der angegebenen Anfrage übereinstimmen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

Standorte

Diese API ermöglicht die Verwaltung von Unternehmensstandorten auf Google.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

Löscht einen Standort.

Wenn dieser Standort nicht über die API gelöscht werden kann und in den google.mybusiness.businessinformation.v1.LocationState entsprechend markiert ist, verwenden Sie die Google Unternehmensprofil-Website.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

Ruft die von Google aktualisierte Version des angegebenen Standorts ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

Gibt den angegebenen Standort zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

Listet die Standorte für das angegebene Konto auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

Aktualisiert den angegebenen Standort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/business.manage

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

AdWordsLocationExtensions

Zusätzliche Informationen, die in AdWords angezeigt werden.

Felder
ad_phone

string

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

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.

Felder
name

string

Erforderlich. Der Ressourcenname für dieses Attribut.

value_type

AttributeValueType

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

values[]

Value

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

repeated_enum_value

RepeatedEnumAttributeValue

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

uri_values[]

UriAttributeValue

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

AttributeMetadata

Metadaten für ein Attribut. Enthält Anzeigeinformationen für das Attribut, einschließlich eines lokalisierten Namens und einer Überschrift zum Gruppieren verwandter Attribute.

Felder
parent

string

Die eindeutige Kennung für das Attribut.

value_type

AttributeValueType

Der Werttyp für das Attribut. Es wird davon ausgegangen, dass die festgelegten und abgerufenen Werte diesen Typ haben.

display_name

string

Der lokalisierte Anzeigename für das Attribut, falls verfügbar andernfalls den englischen Anzeigenamen.

group_display_name

string

Der lokalisierte Anzeigename der Gruppe, die dieses Attribut enthält (falls verfügbar) andernfalls den englischen Gruppennamen. Zugehörige Attribute werden in einer Gruppe zusammengefasst und sollten zusammen unter der hier angegebenen Überschrift angezeigt werden.

repeatable

bool

Falls wahr, unterstützt das Attribut mehrere Werte. Bei „false“ sollte nur ein Wert angegeben werden.

value_metadata[]

AttributeValueMetadata

Für einige Attributtypen (z. B. enums) wird eine Liste der unterstützten Werte und der entsprechenden Anzeigenamen für diese Werte bereitgestellt.

deprecated

bool

Bei Einstellung auf „true“ wird das Attribut eingestellt und sollte nicht mehr verwendet werden. Wenn dieses Attribut eingestellt wird, führt das Aktualisieren dieses Attributs nicht zu einem Fehler, aber Aktualisierungen werden nicht gespeichert. Irgendwann wird das Attribut vollständig entfernt und es wird ein Fehler ausgegeben.

AttributeValueMetadata

Metadaten für unterstützte Attributwerte.

Felder
value

Value

Der Attributwert.

display_name

string

Der Anzeigename für diesen Wert, lokalisiert, sofern verfügbar. andernfalls auf Englisch. Der Anzeigename des Werts ist für die Verwendung im Zusammenhang mit dem Anzeigenamen des Attributs vorgesehen.

Für die Option „WLAN“ enum-Attribut enthält, könnte dieses Attribut „Bezahlt“ enthalten für kostenpflichtiges WLAN.

AttributeValueType

Der Werttyp des Attributs.

Enums
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED Nicht angegeben.
BOOL Die Werte für dieses Attribut sind boolesche Werte.
ENUM Für das Attribut gibt es eine vordefinierte Liste verfügbarer Werte, die verwendet werden können. In den Metadaten für dieses Attribut werden diese Werte aufgeführt.
URL Die Werte für dieses Attribut sind URLs.
REPEATED_ENUM Der Attributwert ist eine Aufzählung mit mehreren möglichen Werten, die explizit festgelegt oder aufgehoben werden können.

Attribute

Ein Container für alle Attribute für einen bestimmten Standort.

Felder
name

string

Erforderlich. Google-ID für diesen Standort im Format locations/{location_id}/attributes.

attributes[]

Attribute

Eine Sammlung von Attributen, die aktualisiert werden müssen.

BatchGetCategoriesRequest

Anfragenachricht für BusinessCategories.BatchGetBusinessCategories.

Felder
names[]

string

Erforderlich. Es muss mindestens ein Name festgelegt werden. Die GConcept-IDs, für die die lokalisierten Kategorienamen zurückgegeben werden sollen. Wenn Sie Details für mehrere Kategorien zurückgeben möchten, wiederholen Sie diesen Parameter in der Anfrage.

language_code

string

Erforderlich. Der BCP 47-Code der Sprache, in der die Kategorienamen zurückgegeben werden sollen.

region_code

string

Optional. Der ISO 3166-1 Alpha-2-Ländercode, aus dem eine nicht standardmäßige Sprache abgeleitet wird.

view

CategoryView

Erforderlich. Gibt an, welche Teile der Kategorieressource in der Antwort zurückgegeben werden sollen.

BatchGetCategoriesResponse

Antwortnachricht für BusinessCategories.BatchGetBusinessCategories.

Felder
categories[]

Category

Kategorien, die mit den in der Anfrage angegebenen GConcept-IDs übereinstimmen. Sie haben nicht dieselbe Reihenfolge wie die Kategorie-IDs in der Anfrage.

BusinessHours

Die Zeiträume, in denen dieser Standort geöffnet ist. Enthält eine Sammlung von [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod]-Instanzen.

Felder
periods[]

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.

Kategorien

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

Felder
primary_category

Category

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

additional_categories[]

Category

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

Kategorie

Eine Kategorie, die die Art des Unternehmens beschreibt (nicht das, was es tut). Eine Liste gültiger Kategorie-IDs und der Zuordnungen zu ihren visuell lesbaren Namen finden Sie unter categories.list.

Felder
name

string

Erforderlich. Eine von Google bereitgestellte unveränderliche ID für diese Kategorie. Der Wert muss beim Ändern der Kategorie (beim Erstellen oder Aktualisieren eines Standorts) angegeben werden.

display_name

string

Nur Ausgabe. Der visuell lesbare Name der Kategorie. Wird beim Lesen des Standorts festgelegt. Beim Ändern des Standorts muss category_id festgelegt werden.

service_types[]

ServiceType

Nur Ausgabe. Eine Liste aller Dienstleistungsarten, die für diese Unternehmenskategorie verfügbar sind.

more_hours_types[]

MoreHoursType

Nur Ausgabe. Weitere Öffnungszeiten für diese Unternehmenskategorie.

CategoryView

Ein Enum-Wert, mit dem die vom Server zurückgegebene Datenmenge begrenzt wird.

Enums
CATEGORY_VIEW_UNSPECIFIED Nicht angegeben, entspricht CATEGORY_METADATA_ONLY.
BASIC Die Serverantwort enthält nur die Kategoriefelder „display_name“, „category_id“ und „language_code“. Metadaten in Bezug auf Diensttypen werden weggelassen.
FULL Gibt alle Felder in der Antwort zurück.

Kette

Eine Kette ist eine Marke, mit der die Standorte Ihres Unternehmens verknüpft werden können.

Felder
name

string

Erforderlich. Der Ressourcenname der Kette im Format chains/{chain_id}.

chain_names[]

ChainName

Namen der Kette

websites[]

ChainUri

Websites der Kette

location_count

int32

Anzahl der Standorte, die zu dieser Kette gehören.

ChainName

Name, der beim Anzeigen der Kette verwendet werden soll.

Felder
display_name

string

Der Anzeigename für diese Kette.

language_code

string

Der BCP 47-Code der Sprache des Namens.

ChainUri

URL, die beim Anzeigen der Kette verwendet werden soll.

Felder
uri

string

Der URI für diese Kette.

CreateLocationRequest

Anfragenachricht für Locations.CreateLocation.

Felder
parent

string

Erforderlich. Der Name des Kontos, in dem dieser Standort erstellt werden soll.

location

Location

Erforderlich. Die neuen Standortmetadaten.

validate_only

bool

Optional. Falls wahr, wird die Anfrage validiert, ohne den Standort tatsächlich zu erstellen.

request_id

string

Optional. Eine eindeutige Anfrage-ID für den Server, um doppelte Anfragen zu erkennen. Wir empfehlen die Verwendung von UUIDs. Darf maximal 50 Zeichen lang sein.

DeleteLocationRequest

Anfragenachricht für Locations.DeleteLocation.

Felder
name

string

Erforderlich. Der Name des zu löschenden Standorts.

ErrorCode

Alle von der API zurückgegebenen Fehlercodes.

Enums
ERROR_CODE_UNSPECIFIED Fehlender Fehlercode.
INVALID_ATTRIBUTE_NAME Eines der angegebenen Attribute kann nicht auf diesen Standort angewendet werden. Nur in der ListAttributeMetadata-Antwort zurückgegebene Attribute können auf diesen Speicherort angewendet werden. Alle problematischen Attributnamen werden im Schlüssel attribute_names unter „Metadaten“ zurückgegeben.
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION Dieser Fehler wird zurückgegeben, wenn ein Client versucht, einen Standort mit einem bestätigten Standort zu verknüpfen oder eine Standortverknüpfung zu löschen.
ASSOCIATE_LOCATION_INVALID_PLACE_ID Die in der associateLocation-Anfrage angegebene place_id stimmt nicht mit dem Standort überein oder ist ungültig. Achten Sie darauf, dass die festgelegte place_id mit einer der IDs übereinstimmt, die in der SearchGoogleLocations-Antwort zurückgegeben werden.
LAT_LNG_UPDATES_NOT_PERMITTED Dieses Projekt darf das Feld „lat/lng“ für den Standort nicht aktualisieren. Sie können die Breiten- und Längengrade entweder über die Markierungsfunktion in der Benutzeroberfläche aktualisieren oder uns eine Adresse mitteilen.
PO_BOX_IN_ADDRESS_NOT_ALLOWED Postfach kann nicht in der Adresse verwendet werden. Metadatenschlüssel enthalten „field_mask“.
BLOCKED_REGION Aufgrund von internationalen Sanktionen, zu deren Einhaltung wir verpflichtet sind, können wir Unternehmen aus dieser Region nicht akzeptieren. Metadatenschlüssel umfassen „field_maks“.
MISSING_BOTH_PHONE_AND_WEBSITE Für Unternehmen in CUSTOMER_LOCATION_ONLY ist entweder eine Telefonnummer oder eine Website erforderlich. Metadatenschlüssel enthalten „field_mask“.
MISSING_STOREFRONT_ADDRESS_OR_SAB Für alle Standorte muss mindestens eine Adresse oder ein Einzugsgebiet angegeben sein. Metadatenschlüssel enthalten „field_mask“.
LAT_LNG_TOO_FAR_FROM_ADDRESS Das Paar aus Breiten- und Längengrad und Adresse liegt zu weit auseinander. Metadatenschlüssel enthalten „field_mask“.
LAT_LNG_REQUIRED VERWORFEN. Ersetzt durch PIN_DROP_REQUIRED Die angegebene Adresse kann nicht gefunden werden. Geben Sie einen Längen- und Breitengrad an. Metadatenschlüssel enthalten „field_mask“.
INVALID_CHARACTERS Ungültige Zeichen wurden gefunden. Metadatenschlüssel enthalten „field_mask“. und "ungültige_Zeichen".
FORBIDDEN_WORDS Unzulässige Wörter wurden gefunden. Metadatenschlüssel enthalten „field_mask“. und „forbidden_words“.
INVALID_INTERCHANGE_CHARACTERS Ungültige Zeichen wurden gefunden. Metadatenschlüssel enthalten „field_mask“.
FIELDS_REQUIRED_FOR_CATEGORY Für diese Standortkategorie sind zusätzliche Felder erforderlich. Zu den Metadatenschlüsseln gehören „field_mask“, „value“ und „fields_required“.
STOREFRONT_REQUIRED_FOR_CATEGORY Für Ihre Unternehmenskategorie ist ein Ladengeschäft erforderlich, das Kunden besuchen können. Metadatenschlüssel enthalten „field_mask“.
ADDRESS_MISSING_REGION_CODE In der Adresse fehlt der erforderliche „region_code“. Metadatenschlüssel enthalten „field_mask“.
ADDRESS_EDIT_CHANGES_COUNTRY Die Adresse kann nicht in ein anderes Land verschoben werden. Metadatenschlüssel enthalten „field_mask“.
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS Spezielle Öffnungszeiten müssen angegeben werden, wenn für den Standort normale Öffnungszeiten festgelegt sind. Metadaten leer.
INVALID_TIME_SCHEDULE Ungültiger Zeitplan, überlappende Zeit oder Endzeit liegt vor der Startzeit. Metadatenschlüssel enthalten „field_mask“.
INVALID_HOURS_VALUE Ungültiges Format oder ungültiger Wert für Öffnungszeiten. Metadatenschlüssel enthalten „field_mask“.
OVERLAPPED_SPECIAL_HOURS Spezielle_Öffnungszeiten dürfen sich nicht überschneiden. Metadatenschlüssel enthalten „field_mask“.
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY Diese Art von Öffnungszeiten wird von der primären Unternehmenskategorie nicht unterstützt. Metadatenschlüssel enthalten „field_mask“. und „incompatible_hours_type“.
DUPLICATE_CHILDREN_LOCATIONS Doppelte „childs_locations“ in „relation_data“. Metadatenschlüssel enthalten „field_mask“.
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY Ein Unternehmen ohne festen Standort in einem Einzugsgebiet kann nicht die primäre Kategorie haben. Metadatenschlüssel enthalten „field_mask“.
INVALID_SERVICE_AREA_PLACE_ID Ungültige „place_id“ in service_area. Metadatenschlüssel enthalten „field_mask“. und „place_id“.
INVALID_AREA_TYPE_FOR_SERVICE_AREA Ungültiger Gebietstyp für service_area. Metadatenschlüssel enthalten „field_mask“. und „place_id“.
OPENING_DATE_TOO_FAR_IN_THE_FUTURE Das Eröffnungsdatum darf nicht mehr als ein Jahr in der Zukunft liegen. Metadatenschlüssel enthalten „field_mask“.
OPENING_DATE_MISSING_YEAR_OR_MONTH Als Eröffnungsdatum muss ein Jahr oder ein Monat angegeben werden. Metadatenschlüssel enthalten „field_mask“.
OPENING_DATE_BEFORE_1AD Das Eröffnungsdatum darf nicht vor dem 1. Jahrhundert liegen. Metadatenschlüssel enthalten „field_mask“.
TOO_MANY_ENTRIES Zu viele Einträge für das Feld. Metadatenschlüssel enthalten „field_mask“. und „max_count“.
INVALID_PHONE_NUMBER Die eingegebene Telefonnummer wurde nicht erkannt. Metadatenschlüssel enthalten „field_mask“. und „value“.
INVALID_PHONE_NUMBER_FOR_REGION Ungültige Telefonnummer für Region Metadatenschlüssel enthalten „field_mask“. und „value“.
MISSING_PRIMARY_PHONE_NUMBER Primäre Telefonnummer fehlt. Metadatenschlüssel enthalten „field_mask“.
THROTTLED Das Feld kann derzeit nicht aktualisiert werden. Metadatenschlüssel enthalten „field_mask“. und „value“.
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA Einzugsgebiete mit Punktradius werden nicht mehr unterstützt. Metadatenschlüssel enthalten „field_mask“.
INVALID_CATEGORY Ungültige Kategorie-ID. Metadatenschlüssel enthalten „field_mask“. und „value“.
CANNOT_REOPEN Das Unternehmen kann nicht wieder geöffnet werden. Metadatenschlüssel enthalten „field_mask“.
INVALID_BUSINESS_OPENING_DATE Ungültiges Eröffnungsdatum. Metadatenschlüssel enthalten „field_mask“.
INVALID_LATLNG Ungültiger latlng-Wert Metadatenschlüssel enthalten „field_mask“.
PROFILE_DESCRIPTION_CONTAINS_URL Die Unternehmensbeschreibung darf keine URL enthalten. Metadatenschlüssel enthalten „field_mask“.
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION Die Profilbeschreibung des Standorts der Unterkunft kann nicht bearbeitet werden. Metadatenschlüssel enthalten „field_mask“.
INVALID_URL Ungültiger Link Metadatenschlüssel enthalten „field_mask“.
INVALID_ADDRESS Ungültige Adresse. Metadatenschlüssel enthalten „field_mask“.
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF ParentChain kann nicht der Standort selbst sein. Metadatenschlüssel enthalten „field_mask“. und „value“.
RELATION_CANNOT_BE_THE_LOCATION_ITSELF Die Beziehung kann nicht der Ort selbst sein. Metadatenschlüssel enthalten „field_mask“. und „value“.
MISSING_ADDRESS_COMPONENTS Wert für Adresskomponenten fehlt. Metadatenschlüssel enthalten „field_mask“.
READ_ONLY_ADDRESS_COMPONENTS Schreibgeschützte Adresskomponenten können nicht bearbeitet werden. Metadatenschlüssel enthalten „field_mask“.
STRING_TOO_LONG Der String ist zu lang. Metadatenschlüssel enthalten „field_mask“. und "max_length".
STRING_TOO_SHORT Der String ist zu kurz. Metadatenschlüssel enthalten „field_mask“. und „min_length“.
REQUIRED_FIELD_MISSING_VALUE Fehlender Wert in Pflichtfeld. Metadatenschlüssel enthalten „field_mask“.
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED Die URL für einen Anbieter kann nicht hinzugefügt oder bearbeitet werden. Metadatenschlüssel enthalten „attribute_name“.
ATTRIBUTE_INVALID_ENUM_VALUE Unbekannter Wert für enum-Attribut. Metadatenschlüssel enthalten „attribute_name“.
ATTRIBUTE_NOT_AVAILABLE Skalierbares Attribut ist für diesen Standort nicht gültig. Metadatenschlüssel enthalten „attribute_name“.
ATTRIBUTE_CANNOT_BE_REPEATED Skalierbares Attribut kann nur einmal angegeben werden. Metadatenschlüssel enthalten „attribute_name“.
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY Das Attribut „Skalierbar“ ist nicht mit den am Standort festgelegten Kategorien kompatibel. Metadatenschlüssel enthalten „attribute_name“.
ADDRESS_REMOVAL_NOT_ALLOWED Das Entfernen von Adressen ist für Ihr Unternehmen nicht zulässig. Metadatenschlüssel enthalten „field_mask“.
AMBIGUOUS_TITLE Der beste Name ist für eine Sprache mehrdeutig. Metadatenschlüssel enthalten „field_mask“.
INVALID_CATEGORY_FOR_SAB Ein reines SAB kann keine GCIDs haben, die Subtypen von gcid:generatement_poi sind. Metadatenschlüssel enthalten „field_mask“. und „value“.
RELATION_ENDPOINTS_TOO_FAR Die Endpunkte der Beziehungen sind zu weit voneinander entfernt. Metadatenschlüssel enthalten „field_mask“. und „value“.
INVALID_SERVICE_ITEM Weder „structured_service_item“ noch „free_form_service_item“ ist festgelegt. Metadatenschlüssel enthalten „field_mask“.
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME Dem Label fehlt der Anzeigename. Metadatenschlüssel enthalten „field_mask“.
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME Der Anzeigename ist nicht für alle Labels in allen Preislisten eindeutig. Metadatenschlüssel enthalten „field_mask“.
SERVICE_ITEM_LABEL_INVALID_UTF8 Das Label enthält ungültige UTF-8-Symbole. Metadatenschlüssel enthalten „field_mask“.
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID Im Feld „free_form_service_item“ fehlt das Feld „category_id“. Metadatenschlüssel enthalten „field_mask“.
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL In „free_form_service_item“ fehlt ein Label. Metadatenschlüssel enthalten „field_mask“.
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID Das Feld „service_type_id“ fehlt in „structured_service_item“. Metadatenschlüssel enthalten „field_mask“.
INVALID_LANGUAGE Der Sprachcode ist ungültig. Metadatenschlüssel enthalten „field_mask“.
PRICE_CURRENCY_MISSING ISO 4217-Währungscode fehlt. Metadatenschlüssel enthalten „field_mask“.
PRICE_CURRENCY_INVALID Der angegebene Währungscode entspricht nicht dem gültigen ISO 4217-Standard. Metadatenschlüssel enthalten „field_mask“.
SERVICE_TYPE_ID_DUPLICATE Diensttyp-IDs sind innerhalb des Standorts nicht eindeutig. Metadatenschlüssel enthalten „field_mask“.
PIN_DROP_REQUIRED Die angegebene Adresse kann nicht gefunden werden. Bitte verwende die Benutzeroberfläche, um eine Markierung festzulegen. Metadatenschlüssel enthalten „field_mask“.
STALE_DATA Mindestens ein Element wurde kürzlich von Google aktualisiert. Nur der Inhaber dieses Unternehmens kann Änderungen an den Daten im Feld „Feld“ vornehmen unter business.google.com. Metadatenschlüssel enthalten „field_mask“.
PHONE_NUMBER_EDITS_NOT_ALLOWED Das Feld für die Telefonnummer wurde für diesen Standort deaktiviert und Änderungen sind nicht zulässig. Metadatenschlüssel enthalten „field_mask“.
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION Es gibt mehr als eine Beziehung, die die logische Beziehung zwischen zwei Orten modelliert (z.B. Entfernung oder Arbeit). Metadatenschlüssel enthalten „field_mask“. und „value“.

GetAttributesRequest

Anfrage für AttributesService.GetAttributes.

Felder
name

string

Erforderlich. Google-ID für diesen Standort im Format locations/{location_id}/attributes.

GetChainRequest

Anfragenachricht für Locations.GetChain

Felder
name

string

Erforderlich. Der Ressourcenname der Kette im Format chains/{chain_place_id}.

GetGoogleUpdatedAttributesRequest

Anfrage für AttributesService.GetGoogleUpdatedAttributes.

Felder
name

string

Erforderlich. Google-ID für diesen Standort im Format locations/{location_id}/attributes.

GetGoogleUpdatedLocationRequest

Anfragenachricht für Locations.GetGoogleUpdatedLocation

Felder
name

string

Erforderlich. Der Name des abzurufenden Standorts.

read_mask

FieldMask

Erforderlich. Lesemaske, um anzugeben, welche Felder in der Antwort zurückgegeben werden.

GetLocationRequest

Anfragenachricht für Locations.GetLocation

Felder
name

string

Erforderlich. Der Name des abzurufenden Standorts.

read_mask

FieldMask

Erforderlich. Lesemaske, um anzugeben, welche Felder in der Antwort zurückgegeben werden.

GoogleLocation

Stellt eine Location dar, die auf Google vorhanden ist. Dabei kann es sich um einen Standort handeln, auf den der Nutzer oder jemand anderes Anspruch erhoben hat oder dessen Anspruch nicht erhoben wurde.

Felder
name

string

Ressourcenname dieses GoogleLocations-Objekts im Format googleLocations/{googleLocationId}.

location

Location

Die dünnbesetzten Location-Informationen. Dieses Feld kann in CreateLocation wiederverwendet werden, wenn es derzeit nicht von einem Nutzer beansprucht wurde.

request_admin_rights_uri

string

Eine URL, über die der Nutzer zur Benutzeroberfläche für Administratorrechte weitergeleitet wird. Dieses Feld ist nur vorhanden, wenn der Standort bereits von einem anderen Nutzer, einschließlich des aktuellen Nutzers, beansprucht wurde.

GoogleUpdatedLocation

Stellt einen Standort dar, der von Google geändert wurde.

Felder
location

Location

Die von Google aktualisierte Version dieses Standorts.

diff_mask

FieldMask

Die Felder, die Google aktualisiert hat.

pending_mask

FieldMask

Die Felder mit ausstehenden Änderungen, die noch nicht an Google Maps und die Google Suche gesendet wurden

Label

Label, das beim Anzeigen der Preisliste, des Bereichs oder des Artikels verwendet werden soll.

Felder
display_name

string

Erforderlich. Anzeigename für die Preisliste, den Bereich oder den Artikel.

description

string

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

language_code

string

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

ListAttributeMetadataRequest

Anfrage für AttributesService.ListAttributeMetadata.

Felder
parent

string

Ressourcenname des Standorts für die Suche nach verfügbaren Attributen. Wenn dieses Feld festgelegt ist, sind „category_name“, „region_code“, „language_code“ und „show_all“ nicht erforderlich und dürfen nicht festgelegt werden.

category_name

string

Die stabile ID der primären Kategorie zum Ermitteln verfügbarer Attribute. Muss das Format „categories/{category_id}“ haben.

region_code

string

Der ISO 3166-1 Alpha-2-Ländercode für die Suche nach verfügbaren Attributen.

language_code

string

Der BCP 47-Code der Sprache, in der die Anzeigenamen der Attribute abgerufen werden sollen. Wenn diese Sprache nicht verfügbar ist, wird sie auf Englisch angegeben.

show_all

bool

Metadaten für alle verfügbaren Attribute werden zurückgegeben, wenn dieses Feld auf „true“ gesetzt ist, wobei die Felder „parent“ und „category_name“ ignoriert werden. „language_code“ und „region_code“ sind erforderlich, wenn „show_all“ auf „true“ gesetzt ist.

page_size

int32

Die Anzahl der Attribute, die pro Seite hinzugefügt werden sollen. Der Standardwert ist 200, der Mindestwert ist 1.

page_token

string

Wenn angegeben, wird die nächste Seite mit Attributmetadaten abgerufen.

ListAttributeMetadataResponse

Antwort für AttributesService.ListAttributeMetadata.

Felder
attribute_metadata[]

AttributeMetadata

Eine Sammlung von Attributmetadaten für die verfügbaren Attribute.

next_page_token

string

Wenn die Anzahl der Attribute die angeforderte Seitengröße überschreitet, wird dieses Feld mit einem Token gefüllt, um bei einem nachfolgenden Aufruf von attributes.list die nächste Seite mit Attributen abzurufen. Wenn keine weiteren Attribute vorhanden sind, ist dieses Feld nicht in der Antwort vorhanden.

ListCategoriesRequest

Anfragenachricht für BusinessCategories.ListCategories.

Felder
region_code

string

Erforderlich. Der Ländercode gemäß ISO 3166-1 Alpha-2.

language_code

string

Erforderlich. Der BCP 47-Sprachcode.

filter

string

Optional. Filterstring nach Nutzer. Das einzige unterstützte Feld ist displayName. Beispiel: filter=displayName=foo.

page_size

int32

Optional. Die Anzahl der Kategorien, die pro Seite abgerufen werden sollen. Die Standardeinstellung ist 100, die Mindestanzahl ist 1 und die maximale Seitengröße 100.

page_token

string

Optional. Wenn angegeben, wird die nächste Seite mit Kategorien abgerufen.

view

CategoryView

Erforderlich. Gibt an, welche Teile der Kategorieressource in der Antwort zurückgegeben werden sollen.

ListCategoriesResponse

Antwortnachricht für BusinessCategories.ListCategories.

Felder
categories[]

Category

Die übereinstimmenden Kategorien basierend auf den angeforderten Parametern.

next_page_token

string

Wenn die Anzahl der Kategorien die angeforderte Seitengröße überschreitet, wird dieses Feld mit einem Token gefüllt, um bei einem nachfolgenden Aufruf von ListCategories die nächste Kategorieseite abzurufen.

ListLocationsRequest

Anfragenachricht für Locations.ListLocations

Felder
parent

string

Erforderlich. Der Name des Kontos, aus dem Standorte abgerufen werden sollen. Wenn der Elternteil [Account] [google.mybusiness.accountmanagement.v1.Account] ist vom Typ [AccountType]. [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL: Es werden nur Standorte zurückgegeben, die direkt zum Konto gehören. Andernfalls werden alle über das Konto zugänglichen Standorte zurückgegeben, entweder direkt oder indirekt.

page_size

int32

Optional. Die Anzahl der Standorte, die pro Seite abgerufen werden sollen. Wenn nicht festgelegt, ist der Standardwert 10. Der Mindestwert ist 1 und die maximale Seitengröße 100.

page_token

string

Optional. Wenn angegeben, werden die nächsten page von Standorten abgerufen. Das Seitentoken wird bei vorherigen Aufrufen von ListLocations zurückgegeben, wenn mehr Speicherorte vorhanden waren, als für die angeforderte Seitengröße möglich waren.

filter

string

Optional. Ein Filter, der die zurückzugebenden Standorte einschränkt. Die Antwort enthält nur Einträge, die dem Filter entsprechen. Wenn filter leer ist, werden Einschränkungen angewendet und alle Standorte (mit Seitenzahlen) für das angeforderte Konto abgerufen.

Weitere Informationen zu gültigen Feldern und Anwendungsbeispiele finden Sie im Leitfaden zur Verwendung von Standortdaten.

order_by

string

Optional. Sortierreihenfolge für die Anfrage. Mehrere Felder sollten gemäß der SQL-Syntax durch Kommas getrennt werden. Standardmäßig wird die Sortierreihenfolge aufsteigend sein. Um eine absteigende Reihenfolge festzulegen, wird ein Suffix " desc" sollte hinzugefügt werden. Gültige Felder für „order_by“ sind „title“ und „store_code“. Beispiel: „title, store_code desc“ oder „title“ oder „store_code desc“

read_mask

FieldMask

Erforderlich. Lesemaske, um anzugeben, welche Felder in der Antwort zurückgegeben werden.

ListLocationsResponse

Antwortnachricht für Locations.ListLocations

Felder
locations[]

Location

Die Standorte.

next_page_token

string

Wenn die Anzahl der Standorte die angeforderte Seitengröße überschreitet, wird dieses Feld mit einem Token gefüllt, um bei einem nachfolgenden Aufruf von ListLocations die nächste Seite mit Standorten abzurufen. Wenn keine weiteren Standorte vorhanden sind, ist dieses Feld in der Antwort nicht vorhanden.

total_size

int32

Die ungefähre Anzahl der Standorte in der Liste, unabhängig von der Paginierung. Dieses Feld wird nur zurückgegeben, wenn filter als Abfrageparameter verwendet wird.

Standort

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

Felder
name

string

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

language_code

string

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

store_code

string

Optional. Externe Kennung für diesen Standort, die innerhalb eines bestimmten Kontos eindeutig sein muss. So verknüpfen Sie den Standort mit Ihren eigenen Einträgen.

title

string

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

phone_numbers

PhoneNumbers

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

categories

Categories

Optional. Die verschiedenen Kategorien, die das Unternehmen beschreiben

storefront_address

PostalAddress

Optional. Eine genaue und korrekte Adresse, um Ihren Unternehmensstandort zu beschreiben. Postfächer an entlegenen Standorten sind nicht zulässig. Derzeit können Sie maximal fünf address_lines-Werte in der Adresse angeben. Dieses Feld sollte nur für Unternehmen mit Ladengeschäft festgelegt werden. Dieses Feld sollte nicht für Standorte vom Typ CUSTOMER_LOCATION_ONLY festgelegt werden. Wenn es aber konfiguriert ist, werden alle angegebenen Werte verworfen.

website_uri

string

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

regular_hours

BusinessHours

Optional. Die Öffnungszeiten des Unternehmens.

special_hours

SpecialHours

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

service_area

ServiceAreaBusiness

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

labels[]

string

Optional. Eine Sammlung von Strings im freien Format, mit denen Sie Ihr Unternehmen taggen können. Diese Labels sind NICHT für den Nutzer sichtbar. und nur du kannst sie sehen. Muss zwischen 1 und 255 Zeichen pro Label enthalten.

ad_words_location_extensions

AdWordsLocationExtensions

Optional. Zusätzliche Informationen, die in AdWords angezeigt werden.

latlng

LatLng

Optional. Vom Nutzer angegebener Breiten- und Längengrad. Beim Erstellen eines Standorts wird dieses Feld ignoriert, wenn die angegebene Adresse erfolgreich geocodiert wird. Dieses Feld wird nur bei GET-Anfragen zurückgegeben, wenn der vom Nutzer bereitgestellte latlng-Wert beim Erstellen akzeptiert oder der latlng-Wert über die Google Unternehmensprofil-Website aktualisiert wurde. Dieses Feld kann nur von genehmigten Kunden aktualisiert werden.

open_info

OpenInfo

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

metadata

Metadata

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

profile

Profile

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

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

relationship_data

RelationshipData

Optional. Alle zugehörigen Standorte und Ketten.

more_hours[]

MoreHours

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

service_items[]

ServiceItem

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

Metadaten

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

Felder
has_google_updated

bool

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

has_pending_edits

bool

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

can_delete

bool

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

can_operate_local_post

bool

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

can_modify_service_list

bool

Nur Ausgabe. Gibt an, ob die Dienstleistungsliste durch den Eintrag geändert werden kann.

can_have_food_menus

bool

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

can_operate_health_data

bool

Nur Ausgabe. Gibt an, ob der Standort mit Health-Daten verarbeitet werden kann.

can_operate_lodging_data

bool

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

place_id

string

Nur Ausgabe. Wenn dieser Standort in Google Maps angezeigt wird, enthält dieses Feld die Orts-ID des Standorts. Diese ID kann in verschiedenen Places APIs verwendet werden.

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

duplicate_location

string

Nur Ausgabe. Die Standortressource, die dieser Standort dupliziert.

maps_uri

string

Nur Ausgabe. Ein Link zum Standort in Google Maps.

new_review_uri

string

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

can_have_business_calls

bool

Nur Ausgabe. Gibt an, ob der Eintrag für geschäftliche Anrufe geeignet ist.

has_voice_of_merchant

bool

Nur Ausgabe. Gibt an, ob der Eintrag die Stimme des Händlers enthält. Wenn dieser boolesche Wert „false“ ist, sollten Sie die locations.getVoiceOfMerchantState-API aufrufen, um Details dazu zu erhalten, warum Voice of Merchant nicht vorhanden ist.

MoreHours

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

Felder
hours_type_id

string

Erforderlich. Die Art der Öffnungszeiten. Kunden sollten {#link businessCategories:BatchGet} aufrufen, um unterstützte Öffnungszeiten für Kategorien ihrer Standorte zu erhalten.

periods[]

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.

MoreHoursType

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

Felder
hours_type_id

string

Nur Ausgabe. Eine von Google bereitgestellte unveränderliche ID für diesen Öffnungszeitentyp.

display_name

string

Nur Ausgabe. Der für Menschen lesbare englische Anzeigename für den Öffnungszeitentyp.

localized_display_name

string

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

OpenInfo

Informationen zum Öffnungsstatus des Unternehmens.

Felder
status

OpenForBusiness

Erforderlich. Gibt an, ob der Standort derzeit geöffnet ist. Alle Standorte sind standardmäßig geöffnet, sofern sie nicht als geschlossen gekennzeichnet werden.

can_reopen

bool

Nur Ausgabe. Gibt an, ob das Unternehmen wieder eröffnet werden kann.

opening_date

Date

Optional. Das Datum, an dem der Standort erstmals geöffnet wurde. Wenn der genaue Tag nicht bekannt ist, können nur Monat und Jahr angegeben werden. Das Datum muss in der Vergangenheit oder nicht mehr als ein Jahr in der Zukunft liegen.

OpenForBusiness

Zeigt den Status eines Standorts an.

Enums
OPEN_FOR_BUSINESS_UNSPECIFIED Nicht angegeben.
OPEN Gibt an, dass der Standort geöffnet ist.
CLOSED_PERMANENTLY Gibt an, dass der Standort dauerhaft geschlossen ist.
CLOSED_TEMPORARILY Gibt an, dass der Standort vorübergehend geschlossen wurde.

PhoneNumbers

Eine Sammlung von Telefonnummern des Unternehmens. Während der Aktualisierung müssen beide Felder festgelegt werden. Kunden dürfen mithilfe der Aktualisierungsmaske nicht nur die primäre Telefonnummer oder zusätzliche Telefonnummern aktualisieren. Wir bevorzugen internationale Telefonnummern, wie z. B. „+1 415 555 0132“. Weitere Informationen finden Sie unter https://developers.google.com/style/phone-numbers#international-phone-numbers).

Felder
primary_phone

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.

additional_phones[]

string

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

PlaceInfo

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

Felder
place_name

string

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

place_id

string

Erforderlich. Die ID des Orts. Muss einer Region entsprechen. (https://developers.google.com/places/web-service/supported_types#table3)

Orte

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

Felder
place_infos[]

PlaceInfo

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

Profil

Alle Informationen zum Profil des Standorts.

Felder
description

string

Erforderlich. Beschreibung des Standorts in Ihrer eigenen Stimme, die von anderen nicht bearbeitet werden kann

RelationshipData

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

Felder
parent_location

RelevantLocation

Der übergeordnete Standort, zu dem dieser Standort Beziehungen hat.

children_locations[]

RelevantLocation

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

parent_chain

string

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

RelevantLocation

Informationen zu einem anderen Standort, der im Zusammenhang mit dem aktuellen Standort steht. Die Beziehung kann DEPARTMENT_OF oder INDEPENDENT_ESTABLISHMENT_OF sein und der hier angegebene Standort kann sich auf beiden Seiten (übergeordnet/untergeordnet) des Standorts befinden.

Felder
place_id

string

Erforderlich. Geben Sie den Standort auf der anderen Seite der Beziehung durch seine placeID an.

relation_type

RelationType

Erforderlich. Die Art der Beziehung.

RelationType

Die Typbeziehungen, die angegeben werden sollen.

Enums
RELATION_TYPE_UNSPECIFIED Der Typ ist nicht angegeben.
DEPARTMENT_OF Dies stellt eine Beziehung zwischen zwei Standorten dar, die sich denselben physischen Bereich, dieselbe Marke, dieselbe Führungsebene/Organisation, aber unterschiedliche Schlüsselattribute wie Öffnungszeiten oder Telefonnummern haben. Beispiel: Costco Pharmacy ist eine Abteilung von Costco Großhandel.
INDEPENDENT_ESTABLISHMENT_IN Das sind Fälle, in denen sich zwei Standorte am selben physischen Standort, aber von verschiedenen Unternehmen befinden (z.B. Starbucks im Supermarkt oder Geschäfte in einem Einkaufszentrum).

RepeatedEnumAttributeValue

Werte für ein Attribut mit einem value_type 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.

Felder
set_values[]

string

Festgelegte Enum-Werte.

unset_values[]

string

Nicht festgelegte Enum-Werte.

SearchChainsRequest

Anfragenachricht für Locations.SearchChains

Felder
chain_name

string

Erforderlich. Suchen Sie anhand des Namens nach einer Kette. Genaue/teilweise/unvollständige/ähnliche Suchanfragen werden unterstützt. Beispiele: „walmart“, „wal-mart“, „walmmmart“, „沃尔玛“

page_size

int32

Die maximale Anzahl übereinstimmender Ketten, die von dieser Abfrage zurückgegeben werden sollen. Der Standardwert ist 10. Der maximal mögliche Wert ist 500.

SearchChainsResponse

Antwortnachricht für Locations.SearchChains

Felder
chains[]

Chain

Ketten, die mit dem abgefragten „chain_display_name“ in SearchChainsRequest übereinstimmen. Wenn es keine Übereinstimmungen gibt, ist dieses Feld leer. Die Ergebnisse werden nach ihrer Relevanz aufgelistet.

SearchGoogleLocationsRequest

Anfragenachricht für GoogleLocations.SearchGoogleLocations

Felder
page_size

int32

Die Anzahl der zurückzugebenden Übereinstimmungen. Der Standardwert ist 3, der Höchstwert ist 10. Die Latenz kann sich erhöhen, wenn mehr angefordert werden. Es gibt keine Paginierung.

Union-Feld search_query. Suchanfrage. Dies kann entweder als Standortobjekt oder als Stringabfrage angegeben werden. Für search_query ist nur einer der folgenden Werte zulässig:
location

Location

Standort, nach dem gesucht werden soll. Sofern angegeben, werden Standorte gesucht, die mit den angegebenen Standortdetails übereinstimmen.

query

string

Textabfrage, nach der gesucht werden soll. Die Suchergebnisse aus einem Abfragestring sind weniger genau als bei der Angabe eines genauen Standorts. Sie können jedoch genauere Übereinstimmungen liefern.

SearchGoogleLocationsResponse

Antwortnachricht für GoogleLocations.SearchGoogleLocations

Felder
google_locations[]

GoogleLocation

Eine Sammlung von GoogleLocations, bei denen es sich um potenzielle Übereinstimmungen für die angegebene Anfrage handelt, die in absteigender Genauigkeit aufgelistet sind.

ServiceAreaBusiness

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

Felder
business_type

BusinessType

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

places

Places

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

region_code

string

Nicht veränderbar. CLDR-Regionscode des Landes/der Region, in der das Unternehmen ohne festen Standort in einem Einzugsgebiet ansässig ist. Weitere Informationen finden Sie unter http://cldr.unicode.org/ und http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Beispiel: "CH" für die Schweiz.

Dieses Feld ist für Unternehmen vom Typ CUSTOMER_LOCATION_ONLY erforderlich und wird ansonsten ignoriert.

Die hier angegebene Region kann sich von den Regionen der Gebiete unterscheiden, in denen das Unternehmen tätig ist (z.B. Unternehmen ohne festen Standort in einem Einzugsgebiet, die Dienstleistungen in anderen Regionen als der Region anbieten, in der sie ansässig sind).

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

BusinessType

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

Enums
BUSINESS_TYPE_UNSPECIFIED Nur Ausgabe. Nicht angegeben.
CUSTOMER_LOCATION_ONLY Der Service wird nur in der näheren Umgebung und nicht an der Geschäftsadresse angeboten. Wenn ein Unternehmen von CUSTOMER_AND_BUSINESS_LOCATION auf CUSTOMER_LOCATION_ONLY aktualisiert wird, muss das Standortupdate die Feldmaske storefront_address enthalten und das Feld auf ein leeres Feld setzen.
CUSTOMER_AND_BUSINESS_LOCATION Der Dienst wird an der Geschäftsadresse und in der Umgebung angeboten.

ServiceItem

Eine Nachricht, die eine einzelne Dienstleistung beschreibt. Sie wird verwendet, um die Art der Dienstleistung zu beschreiben, die der Händler anbietet. Zum Beispiel kann ein Haarschnitt eine Dienstleistung sein.

Felder
price

Money

Optional. Der monetäre Preis der Dienstleistung. Wir empfehlen, bei Angabe eines Preises den Währungscode und die Einheiten festzulegen. Dies wird als Festpreis für die Dienstleistung behandelt.

Union-Feld service_item_info. Eines der folgenden Felder sollte immer festgelegt sein. Für service_item_info ist nur einer der folgenden Werte zulässig:
structured_service_item

StructuredServiceItem

Optional. In diesem Feld wird die Groß-/Kleinschreibung von strukturierten Dienstleistungsdaten festgelegt.

free_form_service_item

FreeFormServiceItem

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

FreeFormServiceItem

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

Felder
category

string

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

label

Label

Erforderlich. Mit Sprach-Tags versehene Labels für den Artikel. Artikelnamen sollten maximal 140 Zeichen und Beschreibungen maximal 250 Zeichen lang sein. Dieses Feld sollte nur festgelegt werden, wenn Sie eine benutzerdefinierte Dienstleistung eingeben. Standardisierte Diensttypen sollten über „service_type_id“ aktualisiert werden.

StructuredServiceItem

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

Felder
service_type_id

string

Erforderlich. Das Feld „service_type_id“ ist eine von Google bereitgestellte eindeutige ID, die in ServiceType zu finden ist. Diese Informationen werden vom RPC-Dienst BatchGetCategories bereitgestellt.

description

string

Optional. Beschreibung des strukturierten Dienstleistungselements. Die Zeichenbeschränkung beträgt 300 Zeichen.

ServiceType

Eine Nachricht, die einen vom Unternehmen angebotenen Diensttyp beschreibt.

Felder
service_type_id

string

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

display_name

string

Nur Ausgabe. Der visuell lesbare Anzeigename des Diensttyps.

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. open_time und start_date müssen vor close_time und end_date liegen. close_time und end_date können sich bis 11:59 Uhr am Tag nach der angegebenen start_date erstrecken. Die folgenden Eingaben sind beispielsweise gültig:

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

Die folgenden Eingaben sind ungültig:

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
Felder
start_date

Date

Erforderlich. Das Kalenderdatum, an dem dieser Zeitraum beginnt.

open_time

TimeOfDay

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

end_date

Date

Optional. Das Kalenderdatum, an dem dieser Zeitraum endet. Wenn das Feld end_date nicht festgelegt ist, wird standardmäßig das in start_date angegebene Datum verwendet. Wenn dieses Feld festgelegt ist, darf es höchstens einen Tag nach start_date sein.

close_time

TimeOfDay

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

closed

bool

Optional. Wenn „true“ festgelegt ist, werden end_date, open_time und close_time ignoriert und das in start_date angegebene Datum wird als den ganzen Tag geschlossen als Standort behandelt.

SpecialHours

Stellt eine Reihe von Zeiträumen dar, in denen die Öffnungszeiten eines Standorts von den normalen Öffnungszeiten abweichen.

Felder
special_hour_periods[]

SpecialHourPeriod

Erforderlich. Eine Liste mit Ausnahmen von den normalen Öffnungszeiten des Unternehmens.

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.

Felder
open_day

DayOfWeek

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

open_time

TimeOfDay

Erforderlich. Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tages steht.

close_day

DayOfWeek

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

close_time

TimeOfDay

Erforderlich. Gültige Werte sind 00:00 bis 24:00, wobei 24:00 für Mitternacht am Ende des angegebenen Tages steht.

UpdateAttributesRequest

Anfrage für AttributesService.UpdateAttributes.

Felder
attributes

Attributes

Eine Sammlung von Attributen, die aktualisiert werden müssen.

attribute_mask

FieldMask

Erforderlich. Attributname der Attribute, die Sie aktualisieren möchten. Vertreten durch attributes/{attribute}.

Aktualisierungen: Alle im Attributfeld angegebenen Attribute, die Sie aktualisieren möchten, müssen in der attribute_mask festgelegt werden. Attribute, die in der obigen Liste, aber nicht in attribute_mask festgelegt sind, werden ignoriert.

Löschungen: Wenn Sie bestimmte Attribute löschen möchten, müssen diese in der attribute_mask ohne übereinstimmenden Eintrag in der Attributliste angegeben werden. Wenn Sie alle für einen Standort festgelegten Attribute löschen möchten, suchen Sie nach allen anwendbaren Attributen für den Standort und fügen Sie sie dem attribute_mask mit einem leeren Feld für Attribute hinzu.

UpdateLocationRequest

Anfragenachricht für Locations.UpdateLocation

Felder
location

Location

Erforderlich. Die aktualisierten Standortinformationen.

update_mask

FieldMask

Erforderlich. Die Felder, die aktualisiert werden sollen.

validate_only

bool

Optional. Falls wahr, wird die Anfrage validiert, ohne den Standort tatsächlich zu aktualisieren. Wenn dieses Feld festgelegt ist, werden nur eventuelle Validierungsfehler zurückgegeben. Die Antwort ist leer, wenn keine Fehler gefunden wurden.

UriAttributeValue

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

Felder
uri

string

Erforderlich. Der vorgeschlagene URI-Wert für dieses Attribut.