Package google.mybusiness.businessinformation.v1

Indeks

AttributesService

Umożliwia klientom wyszukiwanie i aktualizowanie atrybutów danej lokalizacji.

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

Wyszukuje wszystkie atrybuty ustawione dla danej lokalizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

Pobiera zaktualizowaną przez Google wersję określonej lokalizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

Zwraca listę atrybutów, które byłyby dostępne dla lokalizacji w podanej kategorii podstawowej i kraju.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

Aktualizowanie atrybutów danej lokalizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

CategoriesService

Ten interfejs API dostarcza informacji o obsługiwanych kategoriach lokalizacji firmy w Google. Więcej informacji znajdziesz w sekcji dotyczącej kategorii w tym artykule: https://support.google.com/business/answer/3038177

BatchGetCategories

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

Zwraca listę kategorii działalności dla podanego języka i identyfikatorów GConcept.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

Zwraca listę kategorii działalności. Wyszukiwanie będzie pasować do nazwy kategorii, ale nie do jej identyfikatora.

Wyszukiwanie pasuje tylko do początku nazwy kategorii (np. „jedzenie” może zwrócić hasło „Knajpka”, ale nie „restauracja typu fast food”).

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

Sieci

Usługa wyszukiwania informacji o firmie sieciowej.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

Pobiera określony łańcuch. Zwraca wartość NOT_FOUND, jeśli łańcuch nie istnieje.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

Przeszukuje sieć na podstawie jej nazwy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GoogleLocations

Ten interfejs API umożliwia dostęp do lokalizacji i wyszukiwanie w niej.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

Wyszukaj wszystkie możliwe lokalizacje pasujące do określonego żądania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

Lokalizacje

Ten interfejs API umożliwia zarządzanie lokalizacjami firmy w Google.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

Tworzy nową lokalizację, która będzie własnością zalogowanego użytkownika.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

Usuwa lokalizację.

Jeśli tej lokalizacji nie można usunąć za pomocą interfejsu API, a jest ona oznaczona w google.mybusiness.businessinformation.v1.LocationState, użyj strony Profil Firmy w Google.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

Pobiera zaktualizowaną przez Google wersję określonej lokalizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

GetLocation

rpc GetLocation(GetLocationRequest) returns (Location)

Zwraca określoną lokalizację.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

Zawiera listę lokalizacji określonego konta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

Aktualizuje określoną lokalizację.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

AdWordsLocationExtensions

Dodatkowe informacje wyświetlane w AdWords.

Pola
ad_phone

string

To pole jest wymagane. Alternatywny numer telefonu wyświetlany w rozszerzeniach lokalizacji AdWords zamiast głównego numeru telefonu lokalizacji.

Atrybut

Atrybut lokalizacji. Atrybuty zawierają dodatkowe informacje o lokalizacji. Atrybuty, które można ustawić dla lokalizacji, mogą się różnić w zależności od jej właściwości (np. kategorii). Dostępne atrybuty są określane przez Google i można je dodawać oraz usuwać bez wprowadzania zmian w interfejsie API.

Pola
name

string

To pole jest wymagane. Nazwa zasobu dla tego atrybutu.

value_type

AttributeValueType

Tylko dane wyjściowe. Typ wartości tego atrybutu. Pomaga określić sposób interpretacji wartości.

values[]

Value

Wartości tego atrybutu. Typ podanych wartości musi być zgodny z oczekiwanym dla danego atrybutu. Jest to pole powtarzane, w którym można podać wiele wartości atrybutu. Typy atrybutów obsługują tylko jedną wartość.

repeated_enum_value

RepeatedEnumAttributeValue

Gdy typ wartości atrybutu to REPEATED_ENUM, zawiera on wartość atrybutu, a inne pola wartości muszą być puste.

uri_values[]

UriAttributeValue

Gdy typem wartości atrybutu jest URL, to pole zawiera wartości tego atrybutu, a pozostałe pola wartości muszą być puste.

AttributeMetadata

Metadane atrybutu. Zawiera informacje wyświetlane dla atrybutu, w tym zlokalizowaną nazwę i nagłówek służący do grupowania powiązanych atrybutów.

Pola
parent

string

Unikalny identyfikator atrybutu.

value_type

AttributeValueType

Typ wartości atrybutu. Ustawione i pobrane wartości powinny być tego typu.

display_name

string

Zlokalizowana nazwa wyświetlana atrybutu, jeśli jest dostępna. W przeciwnym razie – angielska nazwa wyświetlana.

group_display_name

string

Zlokalizowana nazwa wyświetlana grupy zawierającej ten atrybut, jeśli jest dostępna. W przeciwnym razie – angielska nazwa grupy. Powiązane atrybuty są łączone w grupę i powinny być wyświetlane razem pod podanym tutaj nagłówkiem.

repeatable

bool

Jeśli ma wartość true (prawda), atrybut obsługuje wiele wartości. Jeśli ma wartość false (fałsz), należy podać tylko jedną wartość.

value_metadata[]

AttributeValueMetadata

W przypadku niektórych typów atrybutów (np. wyliczeniowych) podana jest lista obsługiwanych wartości i odpowiadających im nazw wyświetlanych.

deprecated

bool

Jeśli ma wartość true (prawda), atrybut został wycofany i nie powinien być już używany. Jeśli ten atrybut został wycofany, zaktualizowanie tego atrybutu nie spowoduje błędu, ale zmiany nie zostaną zapisane. W pewnym momencie po wycofaniu atrybut zostanie całkowicie usunięty i stanie się błędem.

AttributeValueMetadata

Metadane dotyczące obsługiwanych wartości atrybutów.

Pola
value

Value

Wartość atrybutu.

display_name

string

Wyświetlana nazwa tej wartości zlokalizowana tam, gdzie jest dostępna. W przeciwnym razie jest w języku angielskim. Wyświetlanej nazwy wartości należy używać w kontekście wyświetlanej nazwy atrybutu.

Na przykład atrybut wyliczeniowy „Wi-Fi” może zawierać wartość „Płatna”, która oznacza płatne Wi-Fi.

AttributeValueType

Typ wartości atrybutu.

Wartości w polu enum
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED Nie określono.
BOOL Wartości tego atrybutu są wartościami logicznymi.
ENUM Atrybut ma wstępnie określoną listę dostępnych wartości, których można użyć. Metadane tego atrybutu zawierają listę tych wartości.
URL Wartości tego atrybutu to adresy URL.
REPEATED_ENUM Wartość atrybutu jest wyliczoną z wieloma możliwymi wartościami, które można ustawić lub usunąć ustawienie.

Atrybuty

Kontener na wszystkie atrybuty danej lokalizacji.

Pola
name

string

To pole jest wymagane. Identyfikator Google tej lokalizacji w formacie locations/{location_id}/attributes.

attributes[]

Attribute

Zbiór atrybutów, które wymagają aktualizacji.

BatchGetCategoriesRequest

Prośba o wiadomość dla kategorii BusinessCategory.BatchGetBusinesskategorii.

Pola
names[]

string

To pole jest wymagane. Musisz ustawić co najmniej jedną nazwę. Identyfikatory GConcept, dla których mają zostać zwrócone zlokalizowane nazwy kategorii. Aby zwrócić szczegóły więcej niż jednej kategorii, powtórz ten parametr w żądaniu.

language_code

string

To pole jest wymagane. Kod języka BCP 47, w którym powinny być zwracane nazwy kategorii.

region_code

string

Opcjonalnie. Kod kraju zgodny ze standardem ISO 3166-1 alfa-2 służący do określenia języka niestandardowego.

view

CategoryView

To pole jest wymagane. Określa, które części zasobu kategorii mają być zwracane w odpowiedzi.

BatchGetCategoriesResponse

Komunikat z odpowiedzią na potrzeby kategorii BusinessCategory.BatchGetBusinesskategorii.

Pola
categories[]

Category

Kategorie pasujące do identyfikatorów GConcepts podanych w żądaniu. Nie będą one podane w tej samej kolejności co identyfikatory kategorii w żądaniu.

BusinessHours

Określa przedziały czasu, w których firma jest otwarta. Przechowuje kolekcję [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

Pola
periods[]

TimePeriod

To pole jest wymagane. Informacja o godzinach otwarcia tej lokalizacji. Każdy okres oznacza zakres godzin, w których firma jest otwarta w ciągu tygodnia.

Kategorie

Zbiór kategorii opisujących firmę. Podczas aktualizacji musisz ustawić oba pola. Klienci nie mogą samodzielnie aktualizować kategorii podstawowych ani dodatkowych za pomocą maski aktualizacji.

Pola
primary_category

Category

To pole jest wymagane. Kategoria najlepiej opisująca główną działalność, w której działa ta lokalizacja.

additional_categories[]

Category

Opcjonalnie. Dodatkowe kategorie opisujące Twoją firmę. Kategorie pomagają klientom znajdować dokładne wyniki wyszukiwania usług, którymi są zainteresowani. Aby informacje o firmie były dokładne i aktualne, opisuj swoją podstawową działalność za pomocą jak najmniejszej liczby kategorii. Wybierz kategorie, które są najbardziej szczegółowe i związane z główną działalnością Twojej firmy.

Kategoria

Kategoria opisująca, czym jest firma (nie czym się zajmuje). Listę prawidłowych identyfikatorów kategorii oraz mapowania na ich nazwy zrozumiałe dla człowieka znajdziesz tutaj: categories.list.

Pola
name

string

To pole jest wymagane. Stały identyfikator tej kategorii (podany przez Google). Wartość należy określić podczas modyfikowania kategorii (podczas tworzenia lub aktualizowania lokalizacji).

display_name

string

Tylko dane wyjściowe. Czytelna dla człowieka nazwa kategorii. Ta opcja jest ustawiana podczas odczytywania lokalizacji. Podczas modyfikowania lokalizacji należy ustawić category_id.

service_types[]

ServiceType

Tylko dane wyjściowe. Lista wszystkich typów usług dostępnych w tej kategorii działalności.

more_hours_types[]

MoreHoursType

Tylko dane wyjściowe. Więcej typów godzin otwarcia dostępnych dla tej kategorii działalności.

CategoryView

Wyliczenie pomagające ograniczyć ilość danych zwracanych przez serwer.

Wartości w polu enum
CATEGORY_VIEW_UNSPECIFIED Nie określono. Odpowiednik funkcji CATEGORY_METADATA_ONLY.
BASIC Odpowiedź serwera będzie zawierała tylko te pola: display_name, category_id i language_code. Pomija wszystkie pola metadanych związane z typem usługi.
FULL Zwraca wszystkie pola odpowiedzi.

Łańcuch

Sieć to marka, z którą możesz powiązać lokalizacje Twojej firmy.

Pola
name

string

To pole jest wymagane. Nazwa zasobu łańcucha w formacie chains/{chain_id}.

chain_names[]

ChainName

Nazwy sieci.

websites[]

ChainUri

Witryny sieci.

location_count

int32

Liczba lokalizacji należących do sieci.

ChainName

Nazwa, która ma być używana przy wyświetlaniu sieci.

Pola
display_name

string

Wyświetlana nazwa tej sieci.

language_code

string

Kod języka nazwy w formacie BCP 47.

ChainUri

Adres URL, który ma być używany do wyświetlania łańcucha.

Pola
uri

string

Identyfikator URI tego łańcucha.

CreateLocationRequest

Prośba o wiadomość dotyczącą Locations.CreateLocation.

Pola
parent

string

To pole jest wymagane. Nazwa konta, na którym chcesz utworzyć tę lokalizację.

location

Location

To pole jest wymagane. Nowe metadane lokalizacji.

validate_only

bool

Opcjonalnie. Jeśli ma wartość true (prawda), żądanie jest weryfikowane bez faktycznego utworzenia lokalizacji.

request_id

string

Opcjonalnie. Unikalny identyfikator żądania, który serwer może wykrywać zduplikowane żądania. Zalecamy korzystanie z identyfikatorów UUID. Maksymalna długość to 50 znaków.

DeleteLocationRequest

Prośba o wiadomość dotyczącą Locations.DeleteLocation.

Pola
name

string

To pole jest wymagane. Nazwa lokalizacji do usunięcia.

ErrorCode

Wszystkie kody błędów zwrócone przez interfejs API.

Wartości w polu enum
ERROR_CODE_UNSPECIFIED Brak kodu błędu.
INVALID_ATTRIBUTE_NAME Jeden z podanych atrybutów nie może zostać zastosowany do tej lokalizacji. Do tej lokalizacji mogą zostać zastosowane tylko atrybuty zwrócone w odpowiedzi ListAttributeMetadata. Wszystkie problematyczne nazwy atrybutów będą zwracane w kluczu attribute_names w ramach metadanych.
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION Ten błąd jest zwracany, gdy klient próbuje powiązać lokalizację lub wyczyścić powiązanie z lokalizacją w stanie zweryfikowaną.
ASSOCIATE_LOCATION_INVALID_PLACE_ID Wartość place_id podana w żądaniu associateLocation nie pasuje do lokalizacji lub jest nieprawidłowa. Upewnij się, że ustawiany element place_id jest zgodny z jednym z identyfikatorów zwracanych w odpowiedzi SearchGoogleLocations.
LAT_LNG_UPDATES_NOT_PERMITTED Ten projekt nie ma uprawnień do aktualizowania pola szerokości/długości geograficznej lokalizacji. Możesz zaktualizować szerokość i długość geograficzną za pomocą funkcji upuszczania pinezki w interfejsie lub podać nam adres.
PO_BOX_IN_ADDRESS_NOT_ALLOWED W adresie nie można użyć skrytki pocztowej. Klucze metadanych to „field_mask”.
BLOCKED_REGION Ze względu na międzynarodowe sankcje, których musimy przestrzegać, nie możemy przyjmować firm z tego regionu. Klucze metadanych obejmują „field_maks”.
MISSING_BOTH_PHONE_AND_WEBSITE W przypadku CUSTOMER_LOCATION_ONLY firm wymagany jest numer telefonu lub strona internetowa. Klucze metadanych to „field_mask”.
MISSING_STOREFRONT_ADDRESS_OR_SAB Wszystkie lokalizacje muszą mieć co najmniej adres siedziby lub obsługiwany obszar. Klucze metadanych to „field_mask”.
LAT_LNG_TOO_FAR_FROM_ADDRESS Para szerokości i długości geograficznej oraz adresu są oddalone od siebie zbyt daleko. Klucze metadanych to „field_mask”.
LAT_LNG_REQUIRED WYCOFANE. Zastąpione przez PIN_DROP_REQUIRED. Nie można znaleźć podanego adresu. Podaj długość i szerokość geograficzną. Klucze metadanych to „field_mask”.
INVALID_CHARACTERS Znaleziono nieprawidłowe znaki. Klucze metadanych to „field_mask” i „ invalid_characters”.
FORBIDDEN_WORDS Znaleziono zabronione słowa. Klucze metadanych to „field_mask” i „forbidden_words”.
INVALID_INTERCHANGE_CHARACTERS Znaleziono nieprawidłowe znaki. Klucze metadanych to „field_mask”.
FIELDS_REQUIRED_FOR_CATEGORY Ta kategoria lokalizacji wymaga pól dodatkowych. Klucze metadanych to „field_mask”, „value” i „fields_required”.
STOREFRONT_REQUIRED_FOR_CATEGORY Twoja kategoria działalności wymaga lokalizacji, w której klienci mogą odwiedzić witrynę. Klucze metadanych to „field_mask”.
ADDRESS_MISSING_REGION_CODE W adresie brakuje wymaganego kodu regionu. Klucze metadanych to „field_mask”.
ADDRESS_EDIT_CHANGES_COUNTRY Adresu nie można przenieść do innego kraju. Klucze metadanych to „field_mask”.
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS Niestandardowe godziny otwarcia można określić tylko wtedy, gdy dana lokalizacja ma standardowe godziny pracy. Metadane są puste.
INVALID_TIME_SCHEDULE Nieprawidłowy harmonogram, pokrywający się czas lub czas zakończenia jest wcześniejszy niż czas rozpoczęcia. Klucze metadanych to „field_mask”.
INVALID_HOURS_VALUE Nieprawidłowy format lub wartość godziny. Klucze metadanych to „field_mask”.
OVERLAPPED_SPECIAL_HOURS Wartość Special_hours nie może się pokrywać. Klucze metadanych to „field_mask”.
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY Główna kategoria Twojej firmy nie obsługuje tego typu godzin otwarcia. Klucze metadanych to „field_mask” (maska_pola) i „incompatible_hours_type”.
DUPLICATE_CHILDREN_LOCATIONS Zduplikowana wartość „child_locations” w relacji_data. Klucze metadanych to „field_mask”.
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY Firma działająca na określonym obszarze nie może mieć wybranej kategorii podstawowej. Klucze metadanych to „field_mask”.
INVALID_SERVICE_AREA_PLACE_ID Nieprawidłowy identyfikator miejsca w usłudze service_area. Klucze metadanych to „field_mask” i „place_id”.
INVALID_AREA_TYPE_FOR_SERVICE_AREA Nieprawidłowy typ obszaru dla pola service_area. Klucze metadanych to „field_mask” i „place_id”.
OPENING_DATE_TOO_FAR_IN_THE_FUTURE Wpisz datę otwarcia, która przypada w ciągu roku. Klucze metadanych to „field_mask”.
OPENING_DATE_MISSING_YEAR_OR_MONTH Datę otwarcia należy określić rok lub miesiąc. Klucze metadanych to „field_mask”.
OPENING_DATE_BEFORE_1AD Data otwarcia nie może przypadać przed 1 n.e. Klucze metadanych to „field_mask”.
TOO_MANY_ENTRIES Zbyt wiele wpisów w polu. Klucze metadanych to „field_mask” i „max_count”.
INVALID_PHONE_NUMBER Nie rozpoznano podanego numeru telefonu. Klucze metadanych to „field_mask” i „value”.
INVALID_PHONE_NUMBER_FOR_REGION Nieprawidłowy numer kierunkowy dla regionu. Klucze metadanych to „field_mask” i „value”.
MISSING_PRIMARY_PHONE_NUMBER Brak głównego numeru telefonu. Klucze metadanych to „field_mask”.
THROTTLED Nie można teraz zaktualizować tego pola. Klucze metadanych to „field_mask” i „value”.
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA Obszary działalności w zakresie promienia punktu nie są już obsługiwane. Klucze metadanych to „field_mask”.
INVALID_CATEGORY Nieprawidłowy identyfikator kategorii. Klucze metadanych to „field_mask” i „value”.
CANNOT_REOPEN Nie można ponownie otworzyć firmy. Klucze metadanych to „field_mask”.
INVALID_BUSINESS_OPENING_DATE Nieprawidłowa data otwarcia firmy. Klucze metadanych to „field_mask”.
INVALID_LATLNG Nieprawidłowa długość geograficzna. Klucze metadanych to „field_mask”.
PROFILE_DESCRIPTION_CONTAINS_URL Opis firmy nie powinien zawierać adresu URL. Klucze metadanych to „field_mask”.
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION Nie można edytować opisu profilu lokalizacji kwatery. Klucze metadanych to „field_mask”.
INVALID_URL Nieprawidłowy link Klucze metadanych to „field_mask”.
INVALID_ADDRESS Nieprawidłowy adres. Klucze metadanych to „field_mask”.
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF ParentChain nie może być samą lokalizacją. Klucze metadanych to „field_mask” i „value”.
RELATION_CANNOT_BE_THE_LOCATION_ITSELF Relacja nie może być samą lokalizacją. Klucze metadanych to „field_mask” i „value”.
MISSING_ADDRESS_COMPONENTS Brak wartości dla komponentów adresu. Klucze metadanych to „field_mask”.
READ_ONLY_ADDRESS_COMPONENTS Nie można edytować komponentów adresu tylko do odczytu. Klucze metadanych to „field_mask”.
STRING_TOO_LONG Ciąg jest za długi. Klucze metadanych to „field_mask” i „max_length”.
STRING_TOO_SHORT Ciąg jest za krótki. Klucze metadanych to „field_mask” i „min_length”.
REQUIRED_FIELD_MISSING_VALUE Brak wartości w wymaganym polu. Klucze metadanych to „field_mask”.
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED Nie można dodawać ani edytować adresu URL dostawcy. Klucze metadanych obejmują atrybut „attribute_name”.
ATTRIBUTE_INVALID_ENUM_VALUE Nieznana wartość atrybutu wyliczeniowego. Klucze metadanych obejmują atrybut „attribute_name”.
ATTRIBUTE_NOT_AVAILABLE Skalowalny atrybut jest nieprawidłowy w przypadku tej lokalizacji. Klucze metadanych obejmują atrybut „attribute_name”.
ATTRIBUTE_CANNOT_BE_REPEATED Atrybut skalowalny można określić tylko raz. Klucze metadanych obejmują atrybut „attribute_name”.
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY Atrybut skalowalny jest niezgodny z kategoriami ustawionymi w lokalizacji. Klucze metadanych obejmują atrybut „attribute_name”.
ADDRESS_REMOVAL_NOT_ALLOWED Usuwanie adresu jest niedozwolone w przypadku Twojej firmy. Klucze metadanych to „field_mask”.
AMBIGUOUS_TITLE Najlepsza nazwa jest niejednoznaczna dla danego języka. Klucze metadanych to „field_mask”.
INVALID_CATEGORY_FOR_SAB Sam obiekt SAB nie może mieć grup gcidów będących podtypami gcid:establishment_poi. Klucze metadanych to „field_mask” i „value”.
RELATION_ENDPOINTS_TOO_FAR Punkty końcowe relacji znajdują się zbyt daleko od siebie. Klucze metadanych to „field_mask” i „value”.
INVALID_SERVICE_ITEM Nie ustawiono atrybutuStructured_service_item, ani free_form_service_item. Klucze metadanych to „field_mask”.
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME Brak wyświetlanej nazwy etykiety. Klucze metadanych to „field_mask”.
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME Wyświetlana nazwa nie jest unikalna dla wszystkich etykiet we wszystkich cennikach. Klucze metadanych to „field_mask”.
SERVICE_ITEM_LABEL_INVALID_UTF8 Etykieta zawiera nieprawidłowe symbole UTF-8. Klucze metadanych to „field_mask”.
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID Brak pola „category_id” w elemencie free_form_service_item. Klucze metadanych to „field_mask”.
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL Brak etykiety w elemencie free_form_service_item. Klucze metadanych to „field_mask”.
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID Brak pola service_type_id w elemenciestructure_service_item. Klucze metadanych to „field_mask”.
INVALID_LANGUAGE Kod języka jest nieprawidłowy. Klucze metadanych to „field_mask”.
PRICE_CURRENCY_MISSING Brak kodu waluty w formacie ISO 4217. Klucze metadanych to „field_mask”.
PRICE_CURRENCY_INVALID Podany kod waluty jest nieprawidłowy w formacie ISO 4217. Klucze metadanych to „field_mask”.
SERVICE_TYPE_ID_DUPLICATE Identyfikatory typów usług nie są unikalne w obrębie lokalizacji. Klucze metadanych to „field_mask”.
PIN_DROP_REQUIRED Nie można znaleźć podanego adresu. Aby dodać pinezkę, użyj interfejsu użytkownika. Klucze metadanych to „field_mask”.
STALE_DATA Co najmniej jeden element został ostatnio zaktualizowany przez Google. Obecnie tylko właściciel tej firmy może wprowadzać zmiany w danych znajdujących się w polu „field” na stronie business.google.com. Klucze metadanych to „field_mask”.
PHONE_NUMBER_EDITS_NOT_ALLOWED Pole numeru telefonu zostało wyłączone dla tej lokalizacji i nie można wprowadzać zmian. Klucze metadanych to „field_mask”.
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION Istnieje więcej niż jeden związek, który modeluje logiczny związek między dwoma lokalizacjami (np. zniszczenie lub zniszczenie pracy). Klucze metadanych to „field_mask” i „value”.

GetAttributesRequest

Żądanie AttributesService.GetAttributes.

Pola
name

string

To pole jest wymagane. Identyfikator Google tej lokalizacji w formacie locations/{location_id}/attributes.

GetChainRequest

Prośba o wiadomość dotyczącą Locations.GetChain.

Pola
name

string

To pole jest wymagane. Nazwa zasobu łańcucha w formacie chains/{chain_place_id}.

GetGoogleUpdatedAttributesRequest

Żądanie AttributesService.GetGoogleUpdatedAttributes.

Pola
name

string

To pole jest wymagane. Identyfikator Google tej lokalizacji w formacie locations/{location_id}/attributes.

GetGoogleUpdatedLocationRequest

Prośba o wiadomość dotyczącą Locations.GetGoogleUpdatedLocation.

Pola
name

string

To pole jest wymagane. Nazwa lokalizacji do pobrania.

read_mask

FieldMask

To pole jest wymagane. Maska odczytu, aby określić, które pola będą zwracane w odpowiedzi.

GetLocationRequest

Prośba o wiadomość dotyczącą Locations.GetLocation.

Pola
name

string

To pole jest wymagane. Nazwa lokalizacji do pobrania.

read_mask

FieldMask

To pole jest wymagane. Maska odczytu, aby określić, które pola będą zwracane w odpowiedzi.

GoogleLocation

Reprezentuje identyfikator Location widoczny w Google. Może to być lokalizacja, do której prawa zgłosił użytkownik lub ktoś inny. Może to być również miejsce, do którego prawa zgłosił użytkownik.

Pola
name

string

Nazwa zasobu tej lokalizacji Google w formacie googleLocations/{googleLocationId}.

location

Location

Rzadko wypełnione informacje o: Location. To pole może być ponownie użyte w CreateLocation, jeśli użytkownik nie zarezerwował go obecnie.

request_admin_rights_uri

string

Adres URL, który przekierowuje użytkownika do interfejsu prośby o prawa administratora. To pole jest dostępne tylko wtedy, gdy lokalizacja została już zarezerwowana przez dowolnego użytkownika, w tym bieżącego użytkownika.

GoogleUpdatedLocation

Reprezentuje lokalizację zmodyfikowaną przez Google.

Pola
location

Location

Wersja tej lokalizacji zaktualizowana przez Google.

diff_mask

FieldMask

Pola zaktualizowane przez Google.

pending_mask

FieldMask

Pola z oczekującymi zmianami, które nie zostały jeszcze przekazane do wyszukiwarki i Map Google.

Etykieta

Etykieta używana do wyświetlania cennika, sekcji lub produktu.

Pola
display_name

string

To pole jest wymagane. Wyświetlana nazwa cennika, sekcji lub produktu.

description

string

Opcjonalnie. Opis cennika, sekcji lub produktu.

language_code

string

Opcjonalnie. Kod języka BCP-47, którego dotyczą te ciągi znaków. Dla każdego języka można ustawić tylko jeden zestaw etykiet.

ListAttributeMetadataRequest

Żądanie AttributesService.ListAttributeMetadata.

Pola
parent

string

Nazwa zasobu lokalizacji, w której można wyszukać dostępne atrybuty. Jeśli to pole jest skonfigurowane, wartości parametrówcategory_name, region_code, language_code oraz show_all nie są wymagane i nie można ich ustawiać.

category_name

string

Stabilny identyfikator kategorii podstawowej służący do znajdowania dostępnych atrybutów. Musi mieć format kategorie/{identyfikator_kategorii}.

region_code

string

Kod kraju zgodny ze standardem ISO 3166-1 alfa-2 pozwala znaleźć dostępne atrybuty.

language_code

string

Kod języka BCP 47, w którym są pobierane nazwy wyświetlane atrybutów. Jeśli ten język nie jest dostępny, zostaną podane w języku angielskim.

show_all

bool

Jeśli to pole ma wartość „true” (prawda), zwracane są metadane wszystkich dostępnych atrybutów. Zignorowane są pola „parent” (nazwa_elementu) i „category_name”. Jeśli zasada show_all ma wartość true (prawda), wymagane są metadane language_code i region_code.

page_size

int32

Liczba atrybutów do uwzględnienia na stronie. Wartość domyślna to 200, a minimalna 1.

page_token

string

Jeśli określono wartość, pobierana jest następna strona metadanych atrybutów.

ListAttributeMetadataResponse

Odpowiedź na atrybut AttributesService.ListAttributeMetadata.

Pola
attribute_metadata[]

AttributeMetadata

Zbiór metadanych atrybutów dla dostępnych atrybutów.

next_page_token

string

Jeśli liczba atrybutów przekracza żądany rozmiar strony, w tym polu pojawi się token służący do pobierania następnej strony atrybutów przy kolejnym wywołaniu funkcji attributes.list. Jeśli nie ma więcej atrybutów, to pole nie będzie obecne w odpowiedzi.

ListCategoriesRequest

Prośba o wiadomość dla kategorii BusinessCategory.ListCategory.

Pola
region_code

string

To pole jest wymagane. Kod kraju zgodny ze standardem ISO 3166-1 alfa-2.

language_code

string

To pole jest wymagane. Kod języka w formacie BCP 47.

filter

string

Opcjonalnie. Ciąg filtra od użytkownika. Jedyne obsługiwane pole to displayName. Na przykład: filter=displayName=foo.

page_size

int32

Opcjonalnie. Liczba kategorii do pobrania na stronę. Wartość domyślna to 100, minimalna wartość to 1, a maksymalny rozmiar strony to 100.

page_token

string

Opcjonalnie. Jeśli określisz, zostanie pobrana następna strona kategorii.

view

CategoryView

To pole jest wymagane. Określa, które części zasobu kategorii mają być zwracane w odpowiedzi.

ListCategoriesResponse

Komunikat z odpowiedzią na potrzeby kategorii BusinessCategory.ListCategory.

Pola
categories[]

Category

Pasujące kategorie na podstawie żądanych parametrów.

next_page_token

string

Jeśli liczba kategorii przekracza żądany rozmiar strony, w tym polu pojawi się token służący do pobierania następnej strony kategorii przy kolejnym wywołaniu funkcji ListCategories.

ListLocationsRequest

Prośba o wiadomość dotyczącą Locations.ListLocations.

Pola
parent

string

To pole jest wymagane. Nazwa konta, z którego chcesz pobrać lokalizacje. Jeśli konto nadrzędne [Account] [google.mybusiness.accountmanagement.v1.Account] ma typ [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL, zwracane są tylko Lokalizacje, które należą bezpośrednio do konta. W przeciwnym razie zwraca wszystkie lokalizacje dostępne na koncie – bezpośrednio lub pośrednio.

page_size

int32

Opcjonalnie. Liczba lokalizacji do pobrania na stronę. Jeśli nie zostanie ustawiona, domyślna wartość to 10. Wartość minimalna to 1, a maksymalny rozmiar strony to 100.

page_token

string

Opcjonalnie. Jeśli podasz te wartości, zostanie pobrana liczba kolejnych lokalizacji (page). Token strony jest zwracany przez poprzednie wywołania funkcji ListLocations, gdy liczba lokalizacji przekracza limit żądanego rozmiaru strony.

filter

string

Opcjonalnie. Filtr ograniczający lokalizacje do zwrócenia. Odpowiedź zawiera tylko wpisy pasujące do filtra. Jeśli pole filter jest puste, obowiązują ograniczenia, a wszystkie lokalizacje (z podziałem na strony) są pobierane z żądanego konta.

Więcej informacji o prawidłowych polach i przykładowym użyciu danych znajdziesz w artykule Praca z danymi o lokalizacji (w języku angielskim).

order_by

string

Opcjonalnie. Kolejność sortowania żądania. Poszczególne pola powinny być rozdzielone przecinkami zgodnie ze składnią SQL. Domyślna kolejność sortowania jest rosnąca. Aby określić kolejność malejącą, należy dodać sufiks „ desc”. Prawidłowe pola wartości order_by to title i store_code. Na przykład: „title, store_code desc” lub „title” lub „store_code desc”.

read_mask

FieldMask

To pole jest wymagane. Maska odczytu, aby określić, które pola będą zwracane w odpowiedzi.

ListLocationsResponse

Odpowiedź na żądanie Locations.ListLocations.

Pola
locations[]

Location

Lokalizacje.

next_page_token

string

Jeśli liczba lokalizacji przekracza żądany rozmiar strony, w tym polu pojawia się token służący do pobierania następnej strony z lokalizacjami przy kolejnym wywołaniu funkcji ListLocations. Jeśli nie ma więcej lokalizacji, to pole nie jest obecne w odpowiedzi.

total_size

int32

Przybliżona liczba lokalizacji na liście bez względu na podział na strony. To pole zostanie zwrócone tylko wtedy, gdy jako parametr zapytania używany jest filter.

Lokalizacja

Lokalizacja. Szczegółowy opis tych pól znajdziesz w artykule w Centrum pomocy, a lista prawidłowych kategorii działalności znajdziesz w punkcie końcowym kategorii.

Pola
name

string

Identyfikator Google dla tej lokalizacji w formacie: locations/{location_id}.

language_code

string

Niezmienne. Język lokalizacji. Ustawiona podczas tworzenia i niemożliwa do zaktualizowania.

store_code

string

Opcjonalnie. Zewnętrzny identyfikator lokalizacji, który musi być unikalny w obrębie danego konta. W ten sposób powiążesz lokalizację z Twoimi własnymi rekordami.

title

string

To pole jest wymagane. Nazwa lokalizacji powinna odpowiadać nazwie firmy w świecie rzeczywistym – znajdującej się w witrynie sklepowej, na stronie internetowej i na artykułach firmowych, a także znanej klientom. Wszelkie dodatkowe informacje można umieścić w innych polach zasobu (np. Address, Categories). Nie dodawaj zbędnych informacji do imienia i nazwiska (na przykład używaj słowa „Google” zamiast „Google Inc. – siedziba firmy w Mountain View”). Nie podawaj sloganów marketingowych, kodów sklepów, znaków specjalnych, godzin otwarcia lub informacji o zamknięciu/otwarciu, numerów telefonów, adresów URL witryn, informacji o usługach/produktach, lokalizacji, adresie i wskazówki dojazdu ani informacji o zabezpieczeniu (np. „Bankomat PKO BP w Biedronce”).

phone_numbers

PhoneNumbers

Opcjonalnie. różne numery telefonów, których klienci mogą używać do kontaktowania się z firmą.

categories

Categories

Opcjonalnie. Różne kategorie opisujące firmę.

storefront_address

PostalAddress

Opcjonalnie. Dokładny adres, pod którym można opisać lokalizację firmy. Skrytki pocztowe i skrzynki pocztowe znajdujące się w odległych lokalizacjach są niedozwolone. Obecnie w adresie możesz określić maksymalnie 5 wartości address_lines. To pole należy ustawiać tylko dla firm, które mają placówkę stacjonarną. To pole nie powinno być ustawione dla lokalizacji typu CUSTOMER_LOCATION_ONLY, ale jeśli jest ustawione, każda podana wartość zostanie odrzucona.

website_uri

string

Opcjonalnie. Adres URL tej firmy. Jeśli to możliwe, użyj adresu URL reprezentującego daną lokalizację firmy zamiast ogólnej strony/adresu URL reprezentującego wszystkie lokalizacje lub markę.

regular_hours

BusinessHours

Opcjonalnie. Godziny otwarcia firmy.

special_hours

SpecialHours

Opcjonalnie. Niestandardowe godziny otwarcia firmy. Dotyczy to zwykle godzin pracy w święta i innych godzin poza standardowymi godzinami pracy. Zastępują one zwykłe godziny otwarcia. W tym polu nie można ustawić regularnych godzin pracy.

service_area

ServiceAreaBusiness

Opcjonalnie. Firmy działające na określonym obszarze świadczą usługi w lokalizacji klienta. Jeśli firma świadczy usługi na określonym obszarze, to pole opisuje obsługiwane przez nią obszary.

labels[]

string

Opcjonalnie. Zbiór dowolnych ciągów tekstowych, które umożliwiają tagowanie firmy. Te etykiety NIE są widoczne dla użytkowników – tylko Ty je widzisz. Każda etykieta musi mieć od 1 do 255 znaków.

ad_words_location_extensions

AdWordsLocationExtensions

Opcjonalnie. Dodatkowe informacje wyświetlane w AdWords.

latlng

LatLng

Opcjonalnie. Długość i szerokość geograficzna podana przez użytkownika. Podczas tworzenia lokalizacji to pole jest ignorowane, jeśli przesłany adres geokod został poprawnie przesłany. To pole jest zwracane tylko w przypadku żądań „pobierania”, jeśli podana przez użytkownika wartość latlng została zaakceptowana podczas tworzenia lub wartość latlng została zaktualizowana na stronie Profilu Firmy w Google. To pole może aktualizować tylko zatwierdzeni klienci.

open_info

OpenInfo

Opcjonalnie. Flaga, która wskazuje, czy firma jest obecnie otwarta.

metadata

Metadata

Tylko dane wyjściowe. Dodatkowe informacje, których użytkownik nie może edytować.

profile

Profile

Opcjonalnie. Osobiście opisują Twoją firmę i przedstawiają użytkownikom niepowtarzalną historię jej firmy i jej oferty.

To pole jest wymagane w przypadku wszystkich kategorii oprócz kategorii zakwaterowania (np. hoteli, moteli, zajazdów).

relationship_data

RelationshipData

Opcjonalnie. Wszystkie powiązane z nią lokalizacje i sieci.

more_hours[]

MoreHours

Opcjonalnie. Więcej godzin dla różnych działów firmy lub poszczególnych klientów.

service_items[]

ServiceItem

Opcjonalnie. Lista usług obsługiwanych przez sprzedawców. Może to być np. strzyżenie lub instalacja podgrzewacza wody. Zduplikowane usługi będą usuwane automatycznie.

Metadane

dodatkowe informacje o lokalizacji, których użytkownik nie może edytować.

Pola
has_google_updated

bool

Tylko dane wyjściowe. Wskazuje, czy identyfikator miejsca powiązany z tą lokalizacją ma aktualizacje, które klient musi zaktualizować lub odrzucić. Jeśli ta wartość logiczna jest ustawiona, do wyszukiwania informacji, które wymagają weryfikacji, należy wywołać metodę getGoogleUpdated.

has_pending_edits

bool

Tylko dane wyjściowe. Wskazuje, czy któraś z właściwości tej lokalizacji jest w stanie oczekiwania na zmianę.

can_delete

bool

Tylko dane wyjściowe. Wskazuje, czy lokalizację można usunąć przy użyciu interfejsu API.

can_operate_local_post

bool

Tylko dane wyjściowe. Wskazuje, czy w wizytówce można zarządzać lokalnymi wpisami.

can_modify_service_list

bool

Tylko dane wyjściowe. Wskazuje, czy strona może modyfikować listę usług.

can_have_food_menus

bool

Tylko dane wyjściowe. Wskazuje, czy oferta kwalifikuje się do wykorzystania w menu.

can_operate_health_data

bool

Tylko dane wyjściowe. Wskazuje, czy lokalizacja może korzystać z danych dotyczących zdrowia.

can_operate_lodging_data

bool

Tylko dane wyjściowe. Wskazuje, czy lokalizacja może przeprowadzać operacje na danych dotyczących kwater.

place_id

string

Tylko dane wyjściowe. Jeśli lokalizacja pojawi się w Mapach Google, w tym polu pojawi się identyfikator miejsca. Tego identyfikatora można używać w różnych interfejsach API Miejsc.

To pole można skonfigurować podczas tworzenia połączeń, ale nie podczas aktualizacji.

duplicate_location

string

Tylko dane wyjściowe. Zasób z lokalizacją, który jest duplikatem tej lokalizacji.

maps_uri

string

Tylko dane wyjściowe. link do lokalizacji w Mapach Google,

new_review_uri

string

Tylko dane wyjściowe. Link do strony w wyszukiwarce Google, na której klient może dodać opinię o lokalizacji.

can_have_business_calls

bool

Tylko dane wyjściowe. Wskazuje, czy w przypadku wizytówki można nawiązywać połączenia telefoniczne.

has_voice_of_merchant

bool

Tylko dane wyjściowe. Wskazuje, czy informacje mają Voice of Merchant. Jeśli ta wartość logiczna ma wartość false, należy wywołać interfejs locations.getVoiceOfMerchantState API, aby uzyskać szczegółowe informacje o przyczynach braku usługi Voice of Merchant.

MoreHours

Okresy, w których dana lokalizacja jest otwarta dla określonych rodzajów działalności.

Pola
hours_type_id

string

To pole jest wymagane. Rodzaj godzin pracy. Aby uzyskać informacje na temat obsługiwanych typów godzin pracy dla poszczególnych kategorii lokalizacji, klienci powinni zadzwonić pod numer {#link businessCategory:BatchGet}.

periods[]

TimePeriod

To pole jest wymagane. Zbiór godzin otwarcia danej lokalizacji. Każdy okres oznacza zakres godzin, w których firma jest otwarta w ciągu tygodnia.

MoreHoursType

Więcej typów godzin pracy, które firma oferuje (oprócz zwykłych godzin pracy).

Pola
hours_type_id

string

Tylko dane wyjściowe. Stabilny identyfikator podany przez Google dla tego rodzaju godzin pracy.

display_name

string

Tylko dane wyjściowe. Czytelna dla człowieka angielska nazwa wyświetlana typu godzin.

localized_display_name

string

Tylko dane wyjściowe. Czytelna dla człowieka zlokalizowana nazwa wyświetlana typu godzin.

OpenInfo

Informacje dotyczące stanu otwarcia firmy.

Pola
status

OpenForBusiness

To pole jest wymagane. Wskazuje, czy lokalizacja jest obecnie otwarta. Wszystkie lokalizacje są domyślnie otwarte, chyba że zostaną zaktualizowane.

can_reopen

bool

Tylko dane wyjściowe. Wskazuje, czy firma kwalifikuje się do ponownego otwarcia.

opening_date

Date

Opcjonalnie. Data pierwszego otwarcia lokalizacji. Jeśli dokładny dzień nie jest znany, możesz podać tylko miesiąc i rok. Data musi przypadać w przeszłości lub nie później niż za rok.

OpenForBusiness

Wskazuje stan lokalizacji.

Wartości w polu enum
OPEN_FOR_BUSINESS_UNSPECIFIED Nie określono.
OPEN Wskazuje, że lokalizacja jest otwarta.
CLOSED_PERMANENTLY wskazuje, że lokalizacja została zamknięta na stałe.
CLOSED_TEMPORARILY Wskazuje, że lokalizacja została tymczasowo zamknięta.

PhoneNumbers

Zbiór numerów telefonów firmy. Podczas aktualizacji musisz ustawić oba pola. Klienci nie mogą aktualizować za pomocą maski aktualizacji tylko podstawowych lub dodatkowych numerów telefonów. Preferowany jest międzynarodowy format numeru telefonu, taki jak „+1 415 555 0132”. Więcej informacji znajdziesz tutaj: (https://developers.google.com/style/phone-numbers#international-phone-numbers).

Pola
primary_phone

string

To pole jest wymagane. Numer telefonu umożliwiający jak najbardziej bezpośrednie skontaktowanie się z konkretną lokalizacją firmy. Jeśli to możliwe, użyj lokalnego numeru telefonu zamiast numeru centrum obsługi telefonicznej.

additional_phones[]

string

Opcjonalnie. maksymalnie 2 numery telefonów (komórkowych lub stacjonarnych, bez faksu), pod którymi można zadzwonić do firmy (oprócz podstawowego numeru telefonu).

PlaceInfo

Określa obszar reprezentowany przez identyfikator miejsca.

Pola
place_name

string

To pole jest wymagane. Zlokalizowana nazwa miejsca. Na przykład: Scottsdale, AZ.

place_id

string

To pole jest wymagane. Identyfikator miejsca. Musi odpowiadać regionowi. (https://developers.google.com/places/web-service/supported_types#table3)

Miejsca

Określa sumę obszarów reprezentowanych przez zbiór miejsc.

Pola
place_infos[]

PlaceInfo

Obszary reprezentowane przez identyfikatory miejsc. Maksymalnie 20 miejsc.

Profil

Wszystkie informacje związane z profilem lokalizacji.

Pola
description

string

To pole jest wymagane. Opis lokalizacji wyrażony Twoim głosem. Nikt inny nie może go edytować.

RelationshipData

Informacje o wszystkich lokalizacjach nadrzędnych i podrzędnych związanych z tą lokalizacją.

Pola
parent_location

RelevantLocation

Lokalizacja nadrzędna, z którą jest powiązana ta lokalizacja.

children_locations[]

RelevantLocation

Lista lokalizacji podrzędnych, z którymi jest powiązana ta lokalizacja.

parent_chain

string

Nazwa zasobu sieci, do której należy ta lokalizacja. [Jak znaleźć identyfikator sieci] [Locations.SearchChains]

RelevantLocation

Informacje o innej lokalizacji powiązanej z bieżącą. Relacja może być dowolną z relacji DEPARTMENT_OF lub INDEPENDENT_ESTABLISHMENT_OF, a określona tutaj lokalizacja może znajdować się po obu stronach (nadrzędnej/podrzędnej) lokalizacji.

Pola
place_id

string

To pole jest wymagane. Określ lokalizację po drugiej stronie relacji, podając jej identyfikator miejsca.

relation_type

RelationType

To pole jest wymagane. Typ relacji.

RelationType

Relacje typów do określenia.

Wartości w polu enum
RELATION_TYPE_UNSPECIFIED Typ nieokreślony.
DEPARTMENT_OF Jest to relacja między 2 lokalizacjami, które znajdują się w jednym obszarze fizycznym, ta sama marka / wyższe kierownictwo lub organizacja, ale mają różne kluczowe atrybuty, takie jak godziny otwarcia sklepu lub numer telefonu. Na przykład apteki w Tesco to dział sprzedaży hurtowej Costco.
INDEPENDENT_ESTABLISHMENT_IN Dotyczy to sytuacji, gdy 2 lokalizacje znajdują się w tej samej lokalizacji, ale pochodzą od różnych firm (np. Starbucks a Safeway czy sklepy w centrum handlowym).

RepeatedEnumAttributeValue

Wartości dla atrybutu z value_type o wartości REPEATED_ENUM. Składa się z 2 list identyfikatorów wartości – tych, które są ustawione (prawda) i nieskonfigurowane (fałsz). Brak wartości jest uznawany za nieznany. Musisz podać co najmniej 1 wartość.

Pola
set_values[]

string

Wylicz ustawione wartości.

unset_values[]

string

Wartości w polu Enum, które nie są skonfigurowane.

SearchChainsRequest

Prośba o wiadomość dotyczącą Locations.SearchChains.

Pola
chain_name

string

To pole jest wymagane. Wyszukaj sieć według nazwy. Obsługiwane są zapytania ścisłe/częściowe, przybliżone i podobne. Przykłady: „walmart”, „wal-mart”, „walmmmart”, „沃尔玛”

page_size

int32

Maksymalna liczba pasujących łańcuchów do zwrócenia z tego zapytania. Wartością domyślną jest 10. Maksymalna możliwa wartość to 500.

SearchChainsResponse

Odpowiedź na żądanie Locations.SearchChains.

Pola
chains[]

Chain

Sieci pasujące do poszukiwanej nazwy łańcucha_display_name, której dotyczy zapytanie, w żądaniu SearchChainsRequest. Jeśli nie ma żadnych dopasowań, to pole jest puste. Wyniki są wyświetlane według trafności.

SearchGoogleLocationsRequest

Prośba o wiadomość dla GoogleLocations.SearchGoogleLocations.

Pola
page_size

int32

Liczba dopasowań do zwrócenia. Wartością domyślną jest 3, a maksymalnie 10. Pamiętaj, że w przypadku zwiększenia limitu czas oczekiwania może się zwiększyć. Brak podziału na strony.

Pole sumy search_query. Wyszukiwane hasło. Możesz ją podać w postaci obiektu lokalizacji lub zapytania w postaci ciągu znaków. search_query może mieć tylko jedną z tych wartości:
location

Location

Lokalizacja do wyszukania. Jeśli je podasz, zostaną udostępnione lokalizacje pasujące do podanych szczegółów.

query

string

Zapytanie tekstowe do wyszukania. Wyniki wyszukiwania pochodzące z ciągu zapytania będą mniej dokładne niż w przypadku podawania dokładnej lokalizacji, ale mogą zapewnić więcej dopasowań nieścisłych.

SearchGoogleLocationsResponse

Odpowiedź na „GoogleLocations.SearchGoogleLocations”.

Pola
google_locations[]

GoogleLocation

Zbiór lokalizacji Google, które mogą zostać dopasowane do określonego żądania, posortowane w kolejności od największej do najmniejszej dokładności.

ServiceAreaBusiness

Firmy świadczące usługi na określonym obszarze świadczą usługi w lokalizacji klienta (np. są to ślusarze lub hydraulicy).

Pola
business_type

BusinessType

To pole jest wymagane. Wskazuje [typ] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] firmy działającej na określonym obszarze.

places

Places

Obszar, na którym działa ta firma, określony przez zbiór miejsc.

region_code

string

Niezmienne. Kod regionu CLDR kraju lub regionu, w którym znajduje się firma działająca na określonym obszarze. Szczegółowe informacje znajdziesz na stronach http://cldr.unicode.org/ i http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH” w przypadku Szwajcarii.

To pole jest wymagane w przypadku CUSTOMER_LOCATION_ONLY firm i jest ignorowane.

Określony tutaj region może się różnić od regionu obsługiwanego przez tę firmę (np. firmy świadczące usługi w innym regionie niż ten, w którym znajduje się siedziba firmy).

Jeśli ta lokalizacja wymaga weryfikacji po utworzeniu, adres podany na potrzeby weryfikacji musi znajdować się w tym regionie, a właściciel firmy lub jego upoważniony przedstawiciel musi mieć możliwość odbierania listów pocztowych na podany adres weryfikacyjny.

BusinessType

Wskazuje, czy firma oferuje usługi tylko u klienta (np. przez holownicę) czy też pod adresem i na miejscu (np. pizzeria z jadalnią, która zapewnia dostawę do klientów).

Wartości w polu enum
BUSINESS_TYPE_UNSPECIFIED Tylko dane wyjściowe. Nie określono.
CUSTOMER_LOCATION_ONLY Usługa działa tylko w okolicy (nie pod adresem firmy). Jeśli firma jest aktualizowana z lokalizacji CUSTOMER_AND_BUSINESS_LOCATION na CUSTOMER_LOCATION_ONLY, aktualizacja lokalizacji musi zawierać maskę pola storefront_address i ustawić to pole na puste.
CUSTOMER_AND_BUSINESS_LOCATION Świadczy usługi pod adresem firmy i w jej okolicy.

ServiceItem

Komunikat opisujący pojedynczy produkt w usłudze. Służy do opisania rodzaju usługi świadczonej przez sprzedawcę. Na przykład strzyżenie może być usługą.

Pola
price

Money

Opcjonalnie. Reprezentuje cenę pieniężną usługi. Zalecamy, aby przy uwzględnianiu ceny podać wartość currency_code oraz jednostki. Będzie ona traktowana jako stała cena za usługę.

Pole sumy service_item_info. Zawsze powinno być ustawione jedno z tych pól. service_item_info może mieć tylko jedną z tych wartości:
structured_service_item

StructuredServiceItem

Opcjonalnie. To pole zawiera w polu przypadku uporządkowanych danych usług.

free_form_service_item

FreeFormServiceItem

Opcjonalnie. W tym polu należy określić wielkość liter danych usług swobodnych.

FreeFormServiceItem

Reprezentuje usługę swobodną oferowaną przez sprzedawcę. Są to usługi, które nie są ujawniane w ramach naszych uporządkowanych danych. Sprzedawca ręcznie wpisuje nazwy takich usług na platformie geosprzedawcy.

Pola
category

string

To pole jest wymagane. To pole zawiera nazwę kategorii (tzn. jej stały identyfikator). Wartości category i service_type_id powinny odpowiadać możliwym kombinacjom zawartym w komunikacie Category.

label

Label

To pole jest wymagane. Etykiety elementu z tagami języka. Zalecana długość nazwy produktu to maksymalnie 140 znaków, a opis nie może przekraczać 250 znaków. To pole należy ustawiać tylko wtedy, gdy dane wejściowe są niestandardowym elementem usługi. Znormalizowane typy usług należy zaktualizować za pomocą parametru service_type_id.

StructuredServiceItem

Reprezentuje uporządkowaną usługę oferowaną przez sprzedawcę. Na przykład: instalacja_toalet.

Pola
service_type_id

string

To pole jest wymagane. Pole service_type_id zawiera unikalny identyfikator podany przez Google, który można znaleźć w ServiceType. Te informacje są dostarczane przez usługę RPC BatchGetCategories.

description

string

Opcjonalnie. Opis umieszczonej w witrynie usługi. Limit znaków wynosi 300.

ServiceType

Komunikat opisujący typ usług świadczonych przez firmę.

Pola
service_type_id

string

Tylko dane wyjściowe. Stabilny identyfikator (podany przez Google) usługi tego typu.

display_name

string

Tylko dane wyjściowe. Czytelna dla człowieka nazwa wyświetlana typu usługi.

SpecialHourPeriod

Oznacza jeden okres, w którym godziny pracy lokalizacji różnią się od zwykłych godzin pracy. Zakres niestandardowych godzin pracy musi wynosić mniej niż 24 godziny. Wartości open_time i start_date muszą być wcześniejsze niż close_time i end_date. Zasady close_time i end_date mogą zostać wydłużone do godziny 11:59 w dniu następującym po określonym dniu start_date. Prawidłowe są na przykład te dane wejściowe:

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

Te dane wejściowe są nieprawidłowe:

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
Pola
start_date

Date

To pole jest wymagane. Data kalendarzowa rozpoczęcia obowiązywania specjalnych godzin pracy.

open_time

TimeOfDay

Opcjonalnie. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego pola dnia. Ta wartość musi być określona, jeśli closed ma wartość fałsz.

end_date

Date

Opcjonalnie. Data kalendarzowa zakończenia obowiązywania specjalnych godzin pracy. Jeśli pole end_date nie jest skonfigurowane, domyślnie przyjmuje się datę określoną w polu start_date. Jeśli jest ustawione, to pole nie może być późniejsza niż 1 dzień po start_date.

close_time

TimeOfDay

Opcjonalnie. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego pola dnia. Ta wartość musi być określona, jeśli closed ma wartość fałsz.

closed

bool

Opcjonalnie. Jeśli ma wartość true (prawda), end_date, open_time i close_time są ignorowane, a data podana w polu start_date jest traktowana jako lokalizacja zamknięta na cały dzień.

SpecialHours

To zestaw okresów, w których godziny pracy lokalizacji różnią się od typowych godzin otwarcia.

Pola
special_hour_periods[]

SpecialHourPeriod

To pole jest wymagane. Lista wyjątków od standardowych godzin otwarcia firmy.

TimePeriod

Odnosi się do przedziału czasu, przez jaki firma jest otwarta, zaczynając od określonego dnia lub godziny otwarcia do określonego dnia/godziny zamknięcia. Godzina zamknięcia musi przypadać po godzinie otwarcia, na przykład później w tym samym dniu lub w następnym dniu.

Pola
open_day

DayOfWeek

To pole jest wymagane. Wskazuje day of the week, od którego rozpoczyna się ten okres.

open_time

TimeOfDay

To pole jest wymagane. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego pola dnia.

close_day

DayOfWeek

To pole jest wymagane. Wskazuje day of the week, do którego ten okres kończy się.

close_time

TimeOfDay

To pole jest wymagane. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego pola dnia.

UpdateAttributesRequest

Żądanie AttributesService.UpdateAttributes.

Pola
attributes

Attributes

Zbiór atrybutów, które wymagają aktualizacji.

attribute_mask

FieldMask

To pole jest wymagane. Nazwa atrybutu dla atrybutów, które chcesz zaktualizować. Reprezentowane przez: attributes/{attribute}.

Aktualizacje: wszystkie atrybuty podane w polu atrybutów, które chcesz zaktualizować, muszą być ustawione w attribute_mask. Atrybuty ustawione na liście powyżej, ale nieuwzględnione w polu attribute_mask, będą ignorowane.

Usunięcia: jeśli chcesz usunąć określone atrybuty, musisz je określić w attribute_mask bez pasującego wpisu na liście atrybutów. Jeśli chcesz usunąć wszystkie atrybuty ustawione dla lokalizacji, wyszukaj wszystkie atrybuty odpowiednie dla tej lokalizacji, a następnie dodaj je do pola attribute_mask z pustym polem atrybutów.

UpdateLocationRequest

Prośba o wiadomość dotyczącą Locations.UpdateLocation.

Pola
location

Location

To pole jest wymagane. Zaktualizowane informacje o lokalizacji.

update_mask

FieldMask

To pole jest wymagane. Określone pola do zaktualizowania.

validate_only

bool

Opcjonalnie. Jeśli ma wartość true (prawda), żądanie jest weryfikowane bez rzeczywistej aktualizacji lokalizacji. Po ustawieniu tego pola zwracamy tylko błędy weryfikacji, jeśli takie wystąpiły. Jeśli nie zostaną znalezione żadne błędy, odpowiedź będzie pusta.

UriAttributeValue

Wartości atrybutu z parametrem value_type adresu URL.

Pola
uri

string

To pole jest wymagane. Proponowana wartość identyfikatora URI dla tego atrybutu.