Indeks
AttributesService
(interfejs)CategoriesService
(interfejs)Chains
(interfejs)GoogleLocations
(interfejs)Locations
(interfejs)AdWordsLocationExtensions
(komunikat)Attribute
(komunikat)AttributeMetadata
(komunikat)AttributeMetadata.AttributeValueMetadata
(komunikat)AttributeValueType
(wyliczenie)Attributes
(komunikat)BatchGetCategoriesRequest
(komunikat)BatchGetCategoriesResponse
(komunikat)BusinessHours
(komunikat)Categories
(komunikat)Category
(komunikat)CategoryView
(wyliczenie)Chain
(komunikat)Chain.ChainName
(komunikat)Chain.ChainUri
(komunikat)CreateLocationRequest
(komunikat)DeleteLocationRequest
(komunikat)ErrorCode
(wyliczenie)GetAttributesRequest
(komunikat)GetChainRequest
(komunikat)GetGoogleUpdatedAttributesRequest
(komunikat)GetGoogleUpdatedLocationRequest
(komunikat)GetLocationRequest
(komunikat)GoogleLocation
(komunikat)GoogleUpdatedLocation
(komunikat)Label
(komunikat)ListAttributeMetadataRequest
(komunikat)ListAttributeMetadataResponse
(komunikat)ListCategoriesRequest
(komunikat)ListCategoriesResponse
(komunikat)ListLocationsRequest
(komunikat)ListLocationsResponse
(komunikat)Location
(komunikat)Metadata
(komunikat)MoreHours
(komunikat)MoreHoursType
(komunikat)OpenInfo
(komunikat)OpenInfo.OpenForBusiness
(wyliczenie)PhoneNumbers
(komunikat)PlaceInfo
(komunikat)Places
(komunikat)Profile
(komunikat)RelationshipData
(komunikat)RelevantLocation
(komunikat)RelevantLocation.RelationType
(wyliczenie)RepeatedEnumAttributeValue
(komunikat)SearchChainsRequest
(komunikat)SearchChainsResponse
(komunikat)SearchGoogleLocationsRequest
(komunikat)SearchGoogleLocationsResponse
(komunikat)ServiceAreaBusiness
(komunikat)ServiceAreaBusiness.BusinessType
(wyliczenie)ServiceItem
(komunikat)ServiceItem.FreeFormServiceItem
(komunikat)ServiceItem.StructuredServiceItem
(komunikat)ServiceType
(komunikat)SpecialHourPeriod
(komunikat)SpecialHours
(komunikat)TimePeriod
(komunikat)UpdateAttributesRequest
(komunikat)UpdateLocationRequest
(komunikat)UriAttributeValue
(komunikat)
AttributesService
Umożliwia klientom wyszukiwanie i aktualizowanie atrybutów danej lokalizacji.
GetAttributes |
---|
Wyszukuje wszystkie atrybuty ustawione dla danej lokalizacji.
|
GetGoogleUpdatedAttributes |
---|
Pobiera zaktualizowaną przez Google wersję określonej lokalizacji.
|
ListAttributeMetadata |
---|
Zwraca listę atrybutów, które byłyby dostępne dla lokalizacji w podanej kategorii podstawowej i kraju.
|
UpdateAttributes |
---|
Aktualizowanie atrybutów danej lokalizacji.
|
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 |
---|
Zwraca listę kategorii działalności dla podanego języka i identyfikatorów GConcept.
|
ListCategories |
---|
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”).
|
Sieci
Usługa wyszukiwania informacji o firmie sieciowej.
GetChain |
---|
Pobiera określony łańcuch. Zwraca wartość
|
SearchChains |
---|
Przeszukuje sieć na podstawie jej nazwy.
|
GoogleLocations
Ten interfejs API umożliwia dostęp do lokalizacji i wyszukiwanie w niej.
SearchGoogleLocations |
---|
Wyszukaj wszystkie możliwe lokalizacje pasujące do określonego żądania.
|
Lokalizacje
Ten interfejs API umożliwia zarządzanie lokalizacjami firmy w Google.
CreateLocation |
---|
Tworzy nową lokalizację, która będzie własnością zalogowanego użytkownika.
|
DeleteLocation |
---|
Usuwa lokalizację. Jeśli tej lokalizacji nie można usunąć za pomocą interfejsu API, a jest ona oznaczona w
|
GetGoogleUpdatedLocation |
---|
Pobiera zaktualizowaną przez Google wersję określonej lokalizacji.
|
GetLocation |
---|
Zwraca określoną lokalizację.
|
ListLocations |
---|
Zawiera listę lokalizacji określonego konta.
|
UpdateLocation |
---|
Aktualizuje określoną lokalizację.
|
AdWordsLocationExtensions
Dodatkowe informacje wyświetlane w AdWords.
Pola | |
---|---|
ad_phone |
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 |
To pole jest wymagane. Nazwa zasobu dla tego atrybutu. |
value_type |
Tylko dane wyjściowe. Typ wartości tego atrybutu. Pomaga określić sposób interpretacji wartości. |
values[] |
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 |
Gdy typ wartości atrybutu to REPEATED_ENUM, zawiera on wartość atrybutu, a inne pola wartości muszą być puste. |
uri_values[] |
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 |
Unikalny identyfikator atrybutu. |
value_type |
Typ wartości atrybutu. Ustawione i pobrane wartości powinny być tego typu. |
display_name |
Zlokalizowana nazwa wyświetlana atrybutu, jeśli jest dostępna. W przeciwnym razie – angielska nazwa wyświetlana. |
group_display_name |
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 |
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[] |
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 |
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 |
Wartość atrybutu. |
display_name |
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 |
To pole jest wymagane. Identyfikator Google tej lokalizacji w formacie |
attributes[] |
Zbiór atrybutów, które wymagają aktualizacji. |
BatchGetCategoriesRequest
Prośba o wiadomość dla kategorii BusinessCategory.BatchGetBusinesskategorii.
Pola | |
---|---|
names[] |
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 |
To pole jest wymagane. Kod języka BCP 47, w którym powinny być zwracane nazwy kategorii. |
region_code |
Opcjonalnie. Kod kraju zgodny ze standardem ISO 3166-1 alfa-2 służący do określenia języka niestandardowego. |
view |
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[] |
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[] |
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 |
To pole jest wymagane. Kategoria najlepiej opisująca główną działalność, w której działa ta lokalizacja. |
additional_categories[] |
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 |
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 |
Tylko dane wyjściowe. Czytelna dla człowieka nazwa kategorii. Ta opcja jest ustawiana podczas odczytywania lokalizacji. Podczas modyfikowania lokalizacji należy ustawić |
service_types[] |
Tylko dane wyjściowe. Lista wszystkich typów usług dostępnych w tej kategorii działalności. |
more_hours_types[] |
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 |
To pole jest wymagane. Nazwa zasobu łańcucha w formacie |
chain_names[] |
Nazwy sieci. |
websites[] |
Witryny sieci. |
location_count |
Liczba lokalizacji należących do sieci. |
ChainName
Nazwa, która ma być używana przy wyświetlaniu sieci.
Pola | |
---|---|
display_name |
Wyświetlana nazwa tej sieci. |
language_code |
Kod języka nazwy w formacie BCP 47. |
ChainUri
Adres URL, który ma być używany do wyświetlania łańcucha.
Pola | |
---|---|
uri |
Identyfikator URI tego łańcucha. |
CreateLocationRequest
Prośba o wiadomość dotyczącą Locations.CreateLocation.
Pola | |
---|---|
parent |
To pole jest wymagane. Nazwa konta, na którym chcesz utworzyć tę lokalizację. |
location |
To pole jest wymagane. Nowe metadane lokalizacji. |
validate_only |
Opcjonalnie. Jeśli ma wartość true (prawda), żądanie jest weryfikowane bez faktycznego utworzenia lokalizacji. |
request_id |
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 |
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 |
To pole jest wymagane. Identyfikator Google tej lokalizacji w formacie |
GetChainRequest
Prośba o wiadomość dotyczącą Locations.GetChain.
Pola | |
---|---|
name |
To pole jest wymagane. Nazwa zasobu łańcucha w formacie |
GetGoogleUpdatedAttributesRequest
Żądanie AttributesService.GetGoogleUpdatedAttributes.
Pola | |
---|---|
name |
To pole jest wymagane. Identyfikator Google tej lokalizacji w formacie |
GetGoogleUpdatedLocationRequest
Prośba o wiadomość dotyczącą Locations.GetGoogleUpdatedLocation.
Pola | |
---|---|
name |
To pole jest wymagane. Nazwa lokalizacji do pobrania. |
read_mask |
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 |
To pole jest wymagane. Nazwa lokalizacji do pobrania. |
read_mask |
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 |
Nazwa zasobu tej lokalizacji Google w formacie |
location |
Rzadko wypełnione informacje o: |
request_admin_rights_uri |
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 |
Wersja tej lokalizacji zaktualizowana przez Google. |
diff_mask |
Pola zaktualizowane przez Google. |
pending_mask |
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 |
To pole jest wymagane. Wyświetlana nazwa cennika, sekcji lub produktu. |
description |
Opcjonalnie. Opis cennika, sekcji lub produktu. |
language_code |
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 |
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 |
Stabilny identyfikator kategorii podstawowej służący do znajdowania dostępnych atrybutów. Musi mieć format kategorie/{identyfikator_kategorii}. |
region_code |
Kod kraju zgodny ze standardem ISO 3166-1 alfa-2 pozwala znaleźć dostępne atrybuty. |
language_code |
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 |
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 |
Liczba atrybutów do uwzględnienia na stronie. Wartość domyślna to 200, a minimalna 1. |
page_token |
Jeśli określono wartość, pobierana jest następna strona metadanych atrybutów. |
ListAttributeMetadataResponse
Odpowiedź na atrybut AttributesService.ListAttributeMetadata.
Pola | |
---|---|
attribute_metadata[] |
Zbiór metadanych atrybutów dla dostępnych atrybutów. |
next_page_token |
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 |
ListCategoriesRequest
Prośba o wiadomość dla kategorii BusinessCategory.ListCategory.
Pola | |
---|---|
region_code |
To pole jest wymagane. Kod kraju zgodny ze standardem ISO 3166-1 alfa-2. |
language_code |
To pole jest wymagane. Kod języka w formacie BCP 47. |
filter |
Opcjonalnie. Ciąg filtra od użytkownika. Jedyne obsługiwane pole to |
page_size |
Opcjonalnie. Liczba kategorii do pobrania na stronę. Wartość domyślna to 100, minimalna wartość to 1, a maksymalny rozmiar strony to 100. |
page_token |
Opcjonalnie. Jeśli określisz, zostanie pobrana następna strona kategorii. |
view |
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[] |
Pasujące kategorie na podstawie żądanych parametrów. |
next_page_token |
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 |
ListLocationsRequest
Prośba o wiadomość dotyczącą Locations.ListLocations.
Pola | |
---|---|
parent |
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 |
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 |
Opcjonalnie. Jeśli podasz te wartości, zostanie pobrana liczba kolejnych lokalizacji ( |
filter |
Opcjonalnie. Filtr ograniczający lokalizacje do zwrócenia. Odpowiedź zawiera tylko wpisy pasujące do filtra. Jeśli pole 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 |
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 |
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[] |
Lokalizacje. |
next_page_token |
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 |
total_size |
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 |
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 |
Identyfikator Google dla tej lokalizacji w formacie: |
language_code |
Niezmienne. Język lokalizacji. Ustawiona podczas tworzenia i niemożliwa do zaktualizowania. |
store_code |
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 |
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. |
phone_numbers |
Opcjonalnie. różne numery telefonów, których klienci mogą używać do kontaktowania się z firmą. |
categories |
Opcjonalnie. Różne kategorie opisujące firmę. |
storefront_address |
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 |
website_uri |
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 |
Opcjonalnie. Godziny otwarcia firmy. |
special_hours |
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 |
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[] |
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 |
Opcjonalnie. Dodatkowe informacje wyświetlane w AdWords. |
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ść |
open_info |
Opcjonalnie. Flaga, która wskazuje, czy firma jest obecnie otwarta. |
metadata |
Tylko dane wyjściowe. Dodatkowe informacje, których użytkownik nie może edytować. |
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 |
Opcjonalnie. Wszystkie powiązane z nią lokalizacje i sieci. |
more_hours[] |
Opcjonalnie. Więcej godzin dla różnych działów firmy lub poszczególnych klientów. |
service_items[] |
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 |
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ę |
has_pending_edits |
Tylko dane wyjściowe. Wskazuje, czy któraś z właściwości tej lokalizacji jest w stanie oczekiwania na zmianę. |
can_delete |
Tylko dane wyjściowe. Wskazuje, czy lokalizację można usunąć przy użyciu interfejsu API. |
can_operate_local_post |
Tylko dane wyjściowe. Wskazuje, czy w wizytówce można zarządzać lokalnymi wpisami. |
can_modify_service_list |
Tylko dane wyjściowe. Wskazuje, czy strona może modyfikować listę usług. |
can_have_food_menus |
Tylko dane wyjściowe. Wskazuje, czy oferta kwalifikuje się do wykorzystania w menu. |
can_operate_health_data |
Tylko dane wyjściowe. Wskazuje, czy lokalizacja może korzystać z danych dotyczących zdrowia. |
can_operate_lodging_data |
Tylko dane wyjściowe. Wskazuje, czy lokalizacja może przeprowadzać operacje na danych dotyczących kwater. |
place_id |
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 |
Tylko dane wyjściowe. Zasób z lokalizacją, który jest duplikatem tej lokalizacji. |
maps_uri |
Tylko dane wyjściowe. link do lokalizacji w Mapach Google, |
new_review_uri |
Tylko dane wyjściowe. Link do strony w wyszukiwarce Google, na której klient może dodać opinię o lokalizacji. |
can_have_business_calls |
Tylko dane wyjściowe. Wskazuje, czy w przypadku wizytówki można nawiązywać połączenia telefoniczne. |
has_voice_of_merchant |
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 |
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[] |
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 |
Tylko dane wyjściowe. Stabilny identyfikator podany przez Google dla tego rodzaju godzin pracy. |
display_name |
Tylko dane wyjściowe. Czytelna dla człowieka angielska nazwa wyświetlana typu godzin. |
localized_display_name |
Tylko dane wyjściowe. Czytelna dla człowieka zlokalizowana nazwa wyświetlana typu godzin. |
OpenInfo
Informacje dotyczące stanu otwarcia firmy.
Pola | |
---|---|
status |
To pole jest wymagane. Wskazuje, czy lokalizacja jest obecnie otwarta. Wszystkie lokalizacje są domyślnie otwarte, chyba że zostaną zaktualizowane. |
can_reopen |
Tylko dane wyjściowe. Wskazuje, czy firma kwalifikuje się do ponownego otwarcia. |
opening_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 |
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[] |
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 |
To pole jest wymagane. Zlokalizowana nazwa miejsca. Na przykład: |
place_id |
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[] |
Obszary reprezentowane przez identyfikatory miejsc. Maksymalnie 20 miejsc. |
Profil
Wszystkie informacje związane z profilem lokalizacji.
Pola | |
---|---|
description |
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 |
Lokalizacja nadrzędna, z którą jest powiązana ta lokalizacja. |
children_locations[] |
Lista lokalizacji podrzędnych, z którymi jest powiązana ta lokalizacja. |
parent_chain |
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 |
To pole jest wymagane. Określ lokalizację po drugiej stronie relacji, podając jej identyfikator miejsca. |
relation_type |
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[] |
Wylicz ustawione wartości. |
unset_values[] |
Wartości w polu Enum, które nie są skonfigurowane. |
SearchChainsRequest
Prośba o wiadomość dotyczącą Locations.SearchChains.
Pola | |
---|---|
chain_name |
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 |
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[] |
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 |
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 |
Lokalizacja do wyszukania. Jeśli je podasz, zostaną udostępnione lokalizacje pasujące do podanych szczegółów. |
query |
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[] |
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 |
To pole jest wymagane. Wskazuje [typ] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] firmy działającej na określonym obszarze. |
places |
Obszar, na którym działa ta firma, określony przez zbiór miejsc. |
region_code |
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 |
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 |
Opcjonalnie. To pole zawiera w polu przypadku uporządkowanych danych usług. |
free_form_service_item |
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 |
To pole jest wymagane. To pole zawiera nazwę kategorii (tzn. jej stały identyfikator). Wartości |
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 |
To pole jest wymagane. Pole |
description |
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 |
Tylko dane wyjściowe. Stabilny identyfikator (podany przez Google) usługi tego typu. |
display_name |
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 |
To pole jest wymagane. Data kalendarzowa rozpoczęcia obowiązywania specjalnych godzin pracy. |
open_time |
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 |
end_date |
Opcjonalnie. Data kalendarzowa zakończenia obowiązywania specjalnych godzin pracy. Jeśli pole |
close_time |
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 |
Opcjonalnie. Jeśli ma wartość true (prawda), |
SpecialHours
To zestaw okresów, w których godziny pracy lokalizacji różnią się od typowych godzin otwarcia.
Pola | |
---|---|
special_hour_periods[] |
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 |
To pole jest wymagane. Wskazuje |
open_time |
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 |
To pole jest wymagane. Wskazuje |
close_time |
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 |
Zbiór atrybutów, które wymagają aktualizacji. |
attribute_mask |
To pole jest wymagane. Nazwa atrybutu dla atrybutów, które chcesz zaktualizować. Reprezentowane przez: Aktualizacje: wszystkie atrybuty podane w polu atrybutów, które chcesz zaktualizować, muszą być ustawione w Usunięcia: jeśli chcesz usunąć określone atrybuty, musisz je określić w |
UpdateLocationRequest
Prośba o wiadomość dotyczącą Locations.UpdateLocation.
Pola | |
---|---|
location |
To pole jest wymagane. Zaktualizowane informacje o lokalizacji. |
update_mask |
To pole jest wymagane. Określone pola do zaktualizowania. |
validate_only |
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 |
To pole jest wymagane. Proponowana wartość identyfikatora URI dla tego atrybutu. |