- Zasób: Location
- Zapis JSON
- PhoneNumbers
- Kategorie
- Kategoria
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours (Godziny pracy)
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours (Godziny specjalne)
- SpecialHourPeriod
- Data
- ServiceAreaBusiness
- BusinessType
- Miejsca
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- Metadane
- Profil
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Etykieta
- Pieniądze
- Metody
Zasób: Location
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.
Zapis JSON |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
Pola | |
---|---|
name |
Identyfikator Google dla tej lokalizacji w formacie: |
languageCode |
Niezmienne. Język lokalizacji. Ustawiona podczas tworzenia i niemożliwa do zaktualizowania. |
storeCode |
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. |
phoneNumbers |
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ę. |
storefrontAddress |
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 |
websiteUri |
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ę. |
regularHours |
Opcjonalnie. Godziny otwarcia firmy. |
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. |
serviceArea |
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. |
adWordsLocationExtensions |
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ść |
openInfo |
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). |
relationshipData |
Opcjonalnie. Wszystkie powiązane z nią lokalizacje i sieci. |
moreHours[] |
Opcjonalnie. Więcej godzin dla różnych działów firmy lub poszczególnych klientów. |
serviceItems[] |
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. |
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).
Zapis JSON |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
Pola | |
---|---|
primaryPhone |
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. |
additionalPhones[] |
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). |
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.
Zapis JSON |
---|
{ "primaryCategory": { object ( |
Pola | |
---|---|
primaryCategory |
To pole jest wymagane. Kategoria najlepiej opisująca główną działalność, w której działa ta lokalizacja. |
additionalCategories[] |
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
.
Zapis JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
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). |
displayName |
Tylko dane wyjściowe. Czytelna dla człowieka nazwa kategorii. Ta opcja jest ustawiana podczas odczytywania lokalizacji. Podczas modyfikowania lokalizacji należy ustawić |
serviceTypes[] |
Tylko dane wyjściowe. Lista wszystkich typów usług dostępnych w tej kategorii działalności. |
moreHoursTypes[] |
Tylko dane wyjściowe. Więcej typów godzin otwarcia dostępnych dla tej kategorii działalności. |
ServiceType
Komunikat opisujący typ usług świadczonych przez firmę.
Zapis JSON |
---|
{ "serviceTypeId": string, "displayName": string } |
Pola | |
---|---|
serviceTypeId |
Tylko dane wyjściowe. Stabilny identyfikator (podany przez Google) usługi tego typu. |
displayName |
Tylko dane wyjściowe. Czytelna dla człowieka nazwa wyświetlana typu usługi. |
MoreHoursType
Więcej typów godzin pracy, które firma oferuje (oprócz zwykłych godzin pracy).
Zapis JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
Pola | |
---|---|
hoursTypeId |
Tylko dane wyjściowe. Stabilny identyfikator podany przez Google dla tego rodzaju godzin pracy. |
displayName |
Tylko dane wyjściowe. Czytelna dla człowieka angielska nazwa wyświetlana typu godzin. |
localizedDisplayName |
Tylko dane wyjściowe. Czytelna dla człowieka zlokalizowana nazwa wyświetlana typu godzin. |
PostalAddress
Reprezentuje adres pocztowy, na przykład adres dostawy lub płatności. Podany adres pocztowy pozwala na dostarczenie przesyłek do lokalu, skrytki pocztowej itp. Nie służy do modelowania lokalizacji geograficznych (dróg, miast, gór).
W typowym użyciu adres jest tworzony na podstawie danych wejściowych użytkownika lub importu istniejących danych, w zależności od typu procesu.
Wskazówki dotyczące wpisywania / edytowania adresu: – Używaj widżetu adresu gotowego do internacjonalizacji, np. https://github.com/google/libaddressinput). – Użytkownicy nie powinni widzieć elementów interfejsu do wprowadzania lub edytowania pól poza krajami, w których to pole jest używane.
Więcej wskazówek dotyczących korzystania z tego schematu znajdziesz na https://support.google.com/business/answer/6397478.
Zapis JSON |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Pola | |
---|---|
revision |
Wersja schematu elementu Wszystkie nowe wersje muszą być zgodne wstecznie ze starymi. |
regionCode |
To pole jest wymagane. Kod regionu CLDR kraju lub regionu adresu. Nigdy nie jest to wywnioskowane i to użytkownik decyduje o tym, czy wartość jest poprawna. Szczegółowe informacje znajdziesz na stronach https://cldr.unicode.org/ i https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH” w przypadku Szwajcarii. |
languageCode |
Opcjonalnie. Kod języka BCP-47 treści tego adresu (jeśli jest znany). Jest to często język interfejsu formularza do wprowadzania danych lub powinien odpowiadać jednemu z języków używanych w kraju/regionie adresu lub ich transliteracji. Może to wpływać na formatowanie w niektórych krajach, ale nie jest niezbędne dla poprawności danych oraz nie ma wpływu na weryfikację ani inne operacje związane z formatowaniem. Jeśli ta wartość jest nieznana, pomiń ją (zamiast określać potencjalnie nieprawidłową wartość domyślną). Przykłady: „zh-Hant”, „ja”, „ja-Latn”, „pl”. |
postalCode |
Opcjonalnie. Kod pocztowy adresu. Nie we wszystkich krajach stosuje się kod pocztowy lub go nie wymaga, ale tam, gdzie są one używane, mogą wymagać dodatkowej weryfikacji w innych częściach adresu (np. w Stanach Zjednoczonych). |
sortingCode |
Opcjonalnie. Dodatkowy kod rozliczeniowy zależny od kraju. Ta funkcja nie jest używana w większości regionów. Ta wartość jest ciągiem znaków typu „CEDEX”, opcjonalnie po którym następuje liczba (np. „CEDEX 7”), lub sama liczba reprezentująca „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (malawi) lub „wskaźnik poczty” (np. Wybrzeże Kości Słoniowej). |
administrativeArea |
Opcjonalnie. Najwyższy podział administracyjny używany w przypadku adresów pocztowych w kraju lub regionie. Może to być na przykład stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie społeczność autonomiczna (np. „Barcelona”, a nie „Katalonia”). W wielu krajach nie używa się obszaru administracyjnego w adresach pocztowych. Na przykład w Szwajcarii to pole powinno pozostać puste. |
locality |
Opcjonalnie. Zwykle odnosi się do miasta/miasta adresu. Przykłady: miasto w USA, gmina IT, brytyjska poczta. W regionach świata, gdzie miejscowości nie są dobrze zdefiniowane lub nie mieszczą się w tej strukturze, pozostaw pole rejonu puste i użyj pola addressLines. |
sublocality |
Opcjonalnie. Dzielnica adresu. Mogą to być dzielnice, dystrykty, dzielnice. |
addressLines[] |
Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu. Ponieważ wartości w wierszach addressLines nie mają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), kolejność wierszy musi być jasna. Kolejność wierszy adresu powinna być określona jako „kolejność kopert” dla kraju lub regionu adresu. Tam, gdzie może się to różnić (np. w Japonii), używany jest atrybut „address_language”, aby był zrozumiały (np. „ja” to małe i duże uporządkowanie oraz „ja-Latn” lub „pl” w przypadku małych i dużych rozmiarów). Dzięki temu można wybrać najwęższy wiersz adresu na podstawie języka. Minimalna dozwolona reprezentacja strukturalna adresu składa się z kodu regionCode, a wszystkie pozostałe informacje są umieszczone w wierszach adresu. Taki adres można sformatować mniej więcej bez użycia geokodowania, ale nie można myśleć semantycznie na temat żadnego elementu adresu, dopóki nie zostanie rozwiązany przynajmniej częściowo. Utworzenie adresu zawierającego tylko kod regionu i pole adresowe, a następnie geokodowanie jest zalecanym sposobem obsługi całkowicie nieuporządkowanych adresów (zamiast zgadywania, które części adresu powinny być miejscowością lub obszarem administracyjnych). |
recipients[] |
Opcjonalnie. Odbiorca pod tym adresem. W pewnych okolicznościach to pole może zawierać informacje wielowierszowe. Na przykład może zawierać informacje związane z dbaniem o nie. |
organization |
Opcjonalnie. Nazwa organizacji pod adresem. |
BusinessHours
Określa przedziały czasu, w których firma jest otwarta. Przechowuje kolekcję [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
Zapis JSON |
---|
{
"periods": [
{
object ( |
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. |
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.
Zapis JSON |
---|
{ "openDay": enum ( |
Pola | |
---|---|
openDay |
To pole jest wymagane. Wskazuje |
openTime |
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. |
closeDay |
To pole jest wymagane. Wskazuje |
closeTime |
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. |
DayOfWeek
Reprezentuje dzień tygodnia.
Wartości w polu enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Dzień tygodnia nie jest określony. |
MONDAY |
poniedziałek |
TUESDAY |
Wtorek |
WEDNESDAY |
Środa |
THURSDAY |
Thursday (czwartek) |
FRIDAY |
piątek |
SATURDAY |
Saturday (sobota) |
SUNDAY |
niedziela |
TimeOfDay
Reprezentuje porę dnia. Data i strefa czasowa są nieistotne lub zostały określone w innym miejscu. Interfejs API może zezwolić na sekundy przestępne. Pokrewne rodzaje treści: google.type.Date
i google.protobuf.Timestamp
.
Zapis JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Pola | |
---|---|
hours |
Godziny dnia w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23. W przypadku takich sytuacji jak godzina zamknięcia firmy interfejs API może zezwolić na wartość „24:00:00”. |
minutes |
Minuty w ciągu dnia. Wymagana wartość z zakresu od 0 do 59. |
seconds |
Sekundy minut czasu. Zwykle musi mieścić się w zakresie od 0 do 59. Interfejs API może zezwolić na wartość 60, jeśli zezwala na sekundy przestępne. |
nanos |
Ułamki sekund w nanosekundach. Wartość musi mieścić się w zakresie od 0 do 999 999 999. |
SpecialHours
To zestaw okresów, w których godziny pracy lokalizacji różnią się od typowych godzin otwarcia.
Zapis JSON |
---|
{
"specialHourPeriods": [
{
object ( |
Pola | |
---|---|
specialHourPeriods[] |
To pole jest wymagane. Lista wyjątków od standardowych godzin otwarcia firmy. |
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 openTime
i startDate
muszą być wcześniejsze niż closeTime
i endDate
. Zasady closeTime
i endDate
mogą zostać wydłużone do godziny 11:59 w dniu następującym po określonym dniu startDate
. Prawidłowe są na przykład te dane wejściowe:
startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59
Te dane wejściowe są nieprawidłowe:
startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
Zapis JSON |
---|
{ "startDate": { object ( |
Pola | |
---|---|
startDate |
To pole jest wymagane. Data kalendarzowa rozpoczęcia obowiązywania specjalnych godzin pracy. |
openTime |
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 |
endDate |
Opcjonalnie. Data kalendarzowa zakończenia obowiązywania specjalnych godzin pracy. Jeśli pole |
closeTime |
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), |
Data
Reprezentuje całą datę kalendarzową lub jej część, na przykład datę urodzin. Pora dnia i strefa czasowa są podane w innym miejscu lub są nieistotne. Data odnosi się do kalendarza gregoriańskiego. Może to być:
- Pełna data oraz wartości roku, miesiąca i dnia inne niż zero.
- Miesiąc i dzień z zerowym rokiem (na przykład rocznica).
- Jeden rok z zerowym miesiącem i dniem zerowym.
- Rok i miesiąc z zerowym dniem (na przykład data ważności karty kredytowej).
Podobne typy:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Zapis JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Pola | |
---|---|
year |
Rok daty. Należy podać wartość z zakresu od 1 do 9999 lub 0, aby określić datę bez roku. |
month |
Miesiąc w roku. Należy podać wartość z zakresu od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia. |
day |
Dzień miesiąca. Należy podać wartość z zakresu od 1 do 31 i ważną dla roku i miesiąca lub 0, aby określić sam rok lub rok i miesiąc, w którym dzień nie jest istotny. |
ServiceAreaBusiness
Firmy świadczące usługi na określonym obszarze świadczą usługi w lokalizacji klienta (np. są to ślusarze lub hydraulicy).
Zapis JSON |
---|
{ "businessType": enum ( |
Pola | |
---|---|
businessType |
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. |
regionCode |
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 storefrontAddress i ustawić to pole na puste. |
CUSTOMER_AND_BUSINESS_LOCATION |
Świadczy usługi pod adresem firmy i w jej okolicy. |
Miejsca
Określa sumę obszarów reprezentowanych przez zbiór miejsc.
Zapis JSON |
---|
{
"placeInfos": [
{
object ( |
Pola | |
---|---|
placeInfos[] |
Obszary reprezentowane przez identyfikatory miejsc. Maksymalnie 20 miejsc. |
PlaceInfo
Określa obszar reprezentowany przez identyfikator miejsca.
Zapis JSON |
---|
{ "placeName": string, "placeId": string } |
Pola | |
---|---|
placeName |
To pole jest wymagane. Zlokalizowana nazwa miejsca. Na przykład: |
placeId |
To pole jest wymagane. Identyfikator miejsca. Musi odpowiadać regionowi. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
Dodatkowe informacje wyświetlane w AdWords.
Zapis JSON |
---|
{ "adPhone": string } |
Pola | |
---|---|
adPhone |
To pole jest wymagane. Alternatywny numer telefonu wyświetlany w rozszerzeniach lokalizacji AdWords zamiast głównego numeru telefonu lokalizacji. |
LatLng
Obiekt reprezentujący parę szerokości i długości geograficznej. Wartość ta jest wyrażana jako para podwójnej wartości reprezentującej stopnie szerokości i długości geograficznej w stopniach. O ile nie wskazano inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych zakresach.
Zapis JSON |
---|
{ "latitude": number, "longitude": number } |
Pola | |
---|---|
latitude |
Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0; +90,0]. |
longitude |
Długość geograficzna w stopniach. Musi mieścić się w zakresie [-180,0; +180,0]. |
OpenInfo
Informacje dotyczące stanu otwarcia firmy.
Zapis JSON |
---|
{ "status": enum ( |
Pola | |
---|---|
status |
To pole jest wymagane. Wskazuje, czy lokalizacja jest obecnie otwarta. Wszystkie lokalizacje są domyślnie otwarte, chyba że zostaną zaktualizowane. |
canReopen |
Tylko dane wyjściowe. Wskazuje, czy firma kwalifikuje się do ponownego otwarcia. |
openingDate |
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. |
Metadane
dodatkowe informacje o lokalizacji, których użytkownik nie może edytować.
Zapis JSON |
---|
{ "hasGoogleUpdated": boolean, "hasPendingEdits": boolean, "canDelete": boolean, "canOperateLocalPost": boolean, "canModifyServiceList": boolean, "canHaveFoodMenus": boolean, "canOperateHealthData": boolean, "canOperateLodgingData": boolean, "placeId": string, "duplicateLocation": string, "mapsUri": string, "newReviewUri": string, "canHaveBusinessCalls": boolean, "hasVoiceOfMerchant": boolean } |
Pola | |
---|---|
hasGoogleUpdated |
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ę |
hasPendingEdits |
Tylko dane wyjściowe. Wskazuje, czy któraś z właściwości tej lokalizacji jest w stanie oczekiwania na zmianę. |
canDelete |
Tylko dane wyjściowe. Wskazuje, czy lokalizację można usunąć przy użyciu interfejsu API. |
canOperateLocalPost |
Tylko dane wyjściowe. Wskazuje, czy w wizytówce można zarządzać lokalnymi wpisami. |
canModifyServiceList |
Tylko dane wyjściowe. Wskazuje, czy strona może modyfikować listę usług. |
canHaveFoodMenus |
Tylko dane wyjściowe. Wskazuje, czy oferta kwalifikuje się do wykorzystania w menu. |
canOperateHealthData |
Tylko dane wyjściowe. Wskazuje, czy lokalizacja może korzystać z danych dotyczących zdrowia. |
canOperateLodgingData |
Tylko dane wyjściowe. Wskazuje, czy lokalizacja może przeprowadzać operacje na danych dotyczących kwater. |
placeId |
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. |
duplicateLocation |
Tylko dane wyjściowe. Zasób z lokalizacją, który jest duplikatem tej lokalizacji. |
mapsUri |
Tylko dane wyjściowe. link do lokalizacji w Mapach Google, |
newReviewUri |
Tylko dane wyjściowe. Link do strony w wyszukiwarce Google, na której klient może dodać opinię o lokalizacji. |
canHaveBusinessCalls |
Tylko dane wyjściowe. Wskazuje, czy w przypadku wizytówki można nawiązywać połączenia telefoniczne. |
hasVoiceOfMerchant |
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. |
Profil
Wszystkie informacje związane z profilem lokalizacji.
Zapis JSON |
---|
{ "description": string } |
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ą.
Zapis JSON |
---|
{ "parentLocation": { object ( |
Pola | |
---|---|
parentLocation |
Lokalizacja nadrzędna, z którą jest powiązana ta lokalizacja. |
childrenLocations[] |
Lista lokalizacji podrzędnych, z którymi jest powiązana ta lokalizacja. |
parentChain |
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.
Zapis JSON |
---|
{
"placeId": string,
"relationType": enum ( |
Pola | |
---|---|
placeId |
To pole jest wymagane. Określ lokalizację po drugiej stronie relacji, podając jej identyfikator miejsca. |
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). |
MoreHours
Okresy, w których dana lokalizacja jest otwarta dla określonych rodzajów działalności.
Zapis JSON |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Pola | |
---|---|
hoursTypeId |
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. |
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ą.
Zapis JSON |
---|
{ "price": { object ( |
Pola | |
---|---|
price |
Opcjonalnie. Reprezentuje cenę pieniężną usługi. W przypadku uwzględniania ceny zalecamy ustawienie wartości parametru currencyCode oraz jednostek. 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: |
|
structuredServiceItem |
Opcjonalnie. To pole zawiera w polu przypadku uporządkowanych danych usług. |
freeFormServiceItem |
Opcjonalnie. W tym polu należy określić wielkość liter danych usług swobodnych. |
StructuredServiceItem
Reprezentuje uporządkowaną usługę oferowaną przez sprzedawcę. Na przykład: instalacja_toalet.
Zapis JSON |
---|
{ "serviceTypeId": string, "description": string } |
Pola | |
---|---|
serviceTypeId |
To pole jest wymagane. Pole |
description |
Opcjonalnie. Opis umieszczonej w witrynie usługi. Limit znaków wynosi 300. |
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.
Zapis JSON |
---|
{
"category": string,
"label": {
object ( |
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. Ujednolicone typy usług należy zaktualizować za pomocą parametru serviceTypeId. |
Etykieta
Etykieta używana do wyświetlania cennika, sekcji lub produktu.
Zapis JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
Pola | |
---|---|
displayName |
To pole jest wymagane. Wyświetlana nazwa cennika, sekcji lub produktu. |
description |
Opcjonalnie. Opis cennika, sekcji lub produktu. |
languageCode |
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. |
Pieniądze
Reprezentuje kwotę pieniędzy wraz z typem waluty.
Zapis JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Pola | |
---|---|
currencyCode |
Trzyliterowy kod waluty zdefiniowany w normie ISO 4217. |
units |
Całe jednostki kwoty. Jeśli np. |
nanos |
Liczba nano (10^-9) jednostek ilości. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 włącznie. Jeśli |
Metody |
|
---|---|
|
Tworzy nową lokalizację, która będzie własnością zalogowanego użytkownika. |
|
Zawiera listę lokalizacji określonego konta. |