REST Resource: accounts.locations

Zasób: lokalizacja

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

Zapis JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Pola
name

string

Identyfikator. Identyfikator Google tej lokalizacji w formacie: locations/{locationId}.
languageCode

string

Wartość niezmienna. Język lokalizacji. Ustawiana podczas tworzenia i nie można jej aktualizować.
storeCode

string

Opcjonalnie: Identyfikator zewnętrzny tej lokalizacji, który musi być unikalny w obrębie danego konta. To sposób na powiązanie lokalizacji z Twoimi danymi.
title

string

Wymagane. Nazwa lokalizacji powinna odzwierciedlać rzeczywistą nazwę firmy, która jest używana na witrynie sklepowej, stronie internetowej i materiałach firmowych oraz jest znana klientom. Wszelkie dodatkowe informacje, jeśli są istotne, można umieścić w innych polach zasobu (np. Address, Categories). Nie dodawaj do nazwy niepotrzebnych informacji (np. zamiast „Google Inc. – siedziba główna w Mountain View” użyj „Google”). Nie podawaj haseł marketingowych, kodów sklepów, znaków specjalnych, godzin otwarcia, informacji o tym, czy firma jest otwarta, numerów telefonów, adresów URL witryn, informacji o produkcie lub usługach, lokalizacji, adresów, wskazówek dojazdu ani informacji o tym, gdzie znajduje się firma (np. „Bankomat Chase w Duane Reade”).
phoneNumbers

object (PhoneNumbers)

Opcjonalnie: Różne numery telefonów, pod którymi klienci mogą kontaktować się z firmą.
categories

object (Categories)

Opcjonalnie: Różne kategorie, które opisują firmę.
storefrontAddress

object (PostalAddress)

Opcjonalnie: dokładny i poprawny adres firmy; Podawanie skrytek pocztowych i skrzynek pocztowych znajdujących się w odległych lokalizacjach jest niedozwolone. Obecnie w adresie możesz podać maksymalnie 5 wartości addressLines. To pole powinno być ustawione tylko w przypadku firm, które mają witrynę sklepową. To pole nie powinno być ustawione w przypadku lokalizacji typu CUSTOMER_LOCATION_ONLY, ale jeśli jest ustawione, podana wartość zostanie odrzucona.
websiteUri

string

Opcjonalnie: URL tej firmy. Jeśli to możliwe, użyj adresu URL, który reprezentuje tę konkretną lokalizację firmy, zamiast ogólnego adresu URL witryny, który reprezentuje wszystkie lokalizacje lub markę.
regularHours

object (BusinessHours)

Opcjonalnie: Godziny otwarcia firmy.
specialHours

object (SpecialHours)

Opcjonalnie: Niestandardowe godziny otwarcia firmy. Zwykle obejmuje to godziny otwarcia w święta i inne godziny poza regularnymi godzinami otwarcia. Zastępują one zwykłe godziny otwarcia. Tego pola nie można ustawić bez podania standardowych godzin otwarcia.
serviceArea

object (ServiceAreaBusiness)

Opcjonalnie: Firmy działające na określonym obszarze świadczą usługi w lokalizacji klienta. Jeśli firma działa na określonym obszarze, to pole zawiera opis obszarów, na których firma świadczy usługi.
labels[]

string

Opcjonalnie: Zbiór ciągów znaków w formie swobodnej, które umożliwiają dodawanie tagów do firmy. Te etykiety NIE są widoczne dla użytkowników – tylko Ty możesz je zobaczyć. Każda etykieta musi mieć od 1 do 255 znaków.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opcjonalnie: Dodatkowe informacje, które są wyświetlane w AdWords.
latlng

object (LatLng)

Opcjonalnie: Szerokość i długość geograficzna podane przez użytkownika. Podczas tworzenia lokalizacji to pole jest ignorowane, jeśli podany adres zostanie pomyślnie geokodowany. To pole jest zwracane w żądaniach GET tylko wtedy, gdy podana przez użytkownika wartość latlng została zaakceptowana podczas tworzenia lub gdy wartość latlng została zaktualizowana w witrynie Profilu Firmy w Google. To pole mogą aktualizować tylko zatwierdzeni klienci.
openInfo

object (OpenInfo)

Opcjonalnie: Flaga wskazująca, czy lokalizacja jest obecnie otwarta.
metadata

object (Metadata)

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

object (Profile)

Opcjonalnie: Opisuje Twoją firmę własnymi słowami i przedstawia użytkownikom unikalną historię Twojej firmy i jej oferty.

To pole jest wymagane we wszystkich kategoriach z wyjątkiem kategorii związanych z zakwaterowaniem (np. hotele, motele, zajazdy).
relationshipData

object (RelationshipData)

Opcjonalnie: Wszystkie lokalizacje i sieci powiązane z tą lokalizacją.
moreHours[]

object (MoreHours)

Opcjonalnie: Dodatkowe godziny otwarcia różnych działów firmy lub dla konkretnych klientów.
serviceItems[]

object (ServiceItem)

Opcjonalnie: Lista usług obsługiwanych przez sprzedawców. Usługą może być strzyżenie, instalacja podgrzewacza wody itp. Zduplikowane usługi zostaną automatycznie usunięte.

PhoneNumbers

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

Zapis JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
Pola
primaryPhone

string

Wymagane. Numer telefonu, który umożliwia jak najbardziej bezpośredni kontakt z konkretną lokalizacją firmy. W miarę możliwości użyj lokalnego numeru telefonu zamiast numeru infolinii centrum obsługi telefonicznej.
additionalPhones[]

string

Opcjonalnie: Oprócz podstawowego numeru telefonu możesz dodać maksymalnie 2 numery telefonu (komórkowego lub stacjonarnego, nie faks), pod którymi można się skontaktować z Twoją firmą.

Kategorie

Zbiór kategorii opisujących firmę. Podczas aktualizacji oba pola muszą być wypełnione. Klienci nie mogą indywidualnie aktualizować kategorii podstawowych ani dodatkowych za pomocą maski aktualizacji.

Zapis JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Pola
primaryCategory

object (Category)

Wymagane. Kategoria, która najlepiej opisuje podstawową działalność prowadzoną w tej lokalizacji.
additionalCategories[]

object (Category)

Opcjonalnie: dodatkowe kategorie opisujące Twoją firmę; Kategorie pomagają klientom znaleźć dokładne i konkretne wyniki dotyczące usług, którymi są zainteresowani. Aby informacje o firmie były dokładne i aktualne, do opisu podstawowej działalności firmy użyj jak najmniejszej liczby kategorii. Wybierz kategorie, które są jak najbardziej szczegółowe, ale reprezentatywne dla Twojej głównej działalności.

Kategoria

Kategoria opisująca, czym jest ta firma (a nie czym się zajmuje). Listę prawidłowych identyfikatorów kategorii i ich mapowań na nazwy zrozumiałe dla człowieka znajdziesz w categories.list.

Zapis JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Pola
name

string

Wymagane. Niezmienny identyfikator (podany przez Google) tej kategorii. Wartość musi być określona podczas modyfikowania kategorii (podczas tworzenia lub aktualizowania lokalizacji).
displayName

string

Tylko dane wyjściowe. Zrozumiała dla człowieka nazwa kategorii. Ta wartość jest ustawiana podczas odczytywania lokalizacji. Podczas modyfikowania lokalizacji należy ustawić parametr category_id.
serviceTypes[]

object (ServiceType)

Tylko dane wyjściowe. Lista wszystkich rodzajów usług dostępnych w przypadku tej kategorii działalności.
moreHoursTypes[]

object (MoreHoursType)

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

ServiceType

Wiadomość opisująca typ usługi oferowanej przez firmę.

Zapis JSON 
{
  "serviceTypeId": string,
  "displayName": string
}
Pola
serviceTypeId

string

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

string

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

MoreHoursType

Typy dodatkowych godzin otwarcia, które firma może oferować oprócz standardowych godzin otwarcia.

Zapis JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Pola
hoursTypeId

string

Tylko dane wyjściowe. Identyfikator podany przez Google dla tego typu godzin.
displayName

string

Tylko dane wyjściowe. Zrozumiała dla człowieka wyświetlana nazwa typu godzin w języku angielskim.
localizedDisplayName

string

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

PostalAddress

Reprezentuje adres pocztowy, np. adres do dostawy pocztowej lub adres do płatności. Dzięki adresowi pocztowemu usługa pocztowa może dostarczać przesyłki do lokalu, skrytki pocztowej lub podobnego miejsca. Adres pocztowy nie służy do modelowania położeń geograficznych, takich jak drogi, miasta czy góry.

W typowym przypadku adres jest tworzony na podstawie danych wprowadzonych przez użytkownika lub zaimportowanych z istniejących danych, w zależności od typu procesu.

Wskazówki dotyczące wpisywania lub edytowania adresu:

  • Użyj widżetu adresu przygotowanego do internacjonalizacji, takiego jak https://github.com/google/libaddressinput.
  • Użytkownicy nie powinni widzieć elementów interfejsu do wprowadzania lub edytowania pól poza krajami, w których dane pole jest używane.

Więcej informacji o korzystaniu z tego schematu znajdziesz na stronie 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

integer

Wersja schematu: PostalAddress. Musi mieć wartość 0, czyli najnowszą wersję.

Wszystkie nowe wersje muszą być zgodne wstecznie ze starymi wersjami.
regionCode

string

Wymagane. Kod regionu CLDR kraju lub regionu adresu. Ta wartość nigdy nie jest określana automatycznie, a użytkownik musi upewnić się, że jest prawidłowa. 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

string

Opcjonalnie: Kod języka BCP-47 treści tego adresu (jeśli jest znany). Często jest to język interfejsu formularza wejściowego lub powinien odpowiadać jednemu z języków używanych w kraju/regionie adresu albo ich transliterowanym odpowiednikom. Może to mieć wpływ na formatowanie w niektórych krajach, ale nie jest to kluczowe dla poprawności danych i nigdy nie wpłynie na weryfikację ani inne operacje niezwiązane z formatowaniem.

Jeśli ta wartość jest nieznana, należy ją pominąć (zamiast podawać potencjalnie nieprawidłową wartość domyślną).

Przykłady: „zh-Hant”, „ja”, „ja-Latn”, „en”.
postalCode

string

Opcjonalnie: Kod pocztowy w adresie. Nie wszystkie kraje używają kodów pocztowych lub ich wymagają, ale tam, gdzie są one używane, mogą powodować dodatkową weryfikację z innymi częściami adresu (np. weryfikację stanu lub kodu pocztowego w Stanach Zjednoczonych).
sortingCode

string

Opcjonalnie: Dodatkowy kod banku zależny od kraju. W większości regionów nie jest on używany. Wartość jest ciągiem znaków, np. „CEDEX”, po którym opcjonalnie może następować liczba (np. „CEDEX 7”), lub samą liczbą, która reprezentuje „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (Malawi) lub „wskaźnik urzędu pocztowego” (Wybrzeże Kości Słoniowej).
administrativeArea

string

Opcjonalnie: Najwyższy poziom podziału administracyjnego, który jest używany w adresach pocztowych kraju lub regionu. Może to być na przykład stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. „Barcelona”, a nie „Katalonia”). W wielu krajach nie używa się regionu w adresach pocztowych. Na przykład w Szwajcarii to pole powinno pozostać puste.
locality

string

Opcjonalnie: Zwykle odnosi się do miasta lub miejscowości w adresie. Przykłady: miasto w USA, gmina we Włoszech, miasto pocztowe w Wielkiej Brytanii. W regionach świata, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, pozostaw pole locality puste i użyj pola addressLines.
sublocality

string

Opcjonalnie: Dzielnica w adresie. Może to być na przykład dzielnica, okręg lub okręg szkolny.
addressLines[]

string

Nieuporządkowane wiersze adresu opisujące niższe poziomy adresu.

Wartości w pliku addressLines nie zawierają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), dlatego ważne jest, aby kolejność wierszy była jasna. Kolejność wierszy adresu powinna być zgodna z „kolejnością na kopercie” w kraju lub regionie adresu. W miejscach, gdzie może to być różne (np. w Japonii), używany jest parametr address_language, aby jednoznacznie określić kolejność (np. „ja” w przypadku kolejności od największego do najmniejszego i „ja-Latn” lub „en” w przypadku kolejności od najmniejszego do największego). W ten sposób można wybrać najbardziej szczegółowy wiersz adresu na podstawie języka.

Minimalna dozwolona reprezentacja strukturalna adresu składa się z pola regionCode, a wszystkie pozostałe informacje są umieszczone w polu addressLines. Możliwe byłoby sformatowanie takiego adresu w przybliżeniu bez geokodowania, ale nie można by było wyciągnąć żadnych wniosków semantycznych dotyczących żadnego z komponentów adresu, dopóki nie zostałby on przynajmniej częściowo rozpoznany.

Utworzenie adresu zawierającego tylko regionCode i addressLines, a następnie geokodowanie to zalecany sposób postępowania z całkowicie nieustrukturyzowanymi adresami (w przeciwieństwie do zgadywania, które części adresu powinny być miejscowościami lub regionami administracyjnymi).
recipients[]

string

Opcjonalnie: Odbiorca pod adresem. W niektórych okolicznościach to pole może zawierać informacje w kilku wierszach. Może na przykład zawierać informacje o osobie, do której ma być dostarczona przesyłka.
organization

string

Opcjonalnie: Nazwa organizacji pod adresem.

BusinessHours

Określa godziny otwarcia danej lokalizacji. Zawiera kolekcję instancji [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

Zapis JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Pola
periods[]

object (TimePeriod)

Wymagane. Zbiór godzin, w których ta lokalizacja jest otwarta. Każdy okres reprezentuje zakres godzin, w których lokalizacja jest otwarta w ciągu tygodnia.

TimePeriod

Reprezentuje przedział czasu, w którym firma jest otwarta, zaczynając od określonego dnia i godziny otwarcia, a kończąc na określonym dniu i godzinie zamknięcia. Godzina zamknięcia musi być późniejsza niż godzina otwarcia, np. później tego samego dnia lub następnego dnia.

Zapis JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Pola
openDay

enum (DayOfWeek)

Wymagane. Wskazuje day of the week, w którym rozpoczyna się ten okres.
openTime

object (TimeOfDay)

Wymagane. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego dnia. Uwaga: w mapowaniu JSON Proto3 domyślne wartości zerowe (00:00) są pomijane, co daje {} dla openTime.
closeDay

enum (DayOfWeek)

Wymagane. Wskazuje day of the week, w którym kończy się ten okres.
closeTime

object (TimeOfDay)

Wymagane. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego dnia. Uwaga: w mapowaniu JSON Proto3 domyślne wartości zerowe (00:00) są pomijane, co daje {} dla closeTime.

DzieńTygodnia

Reprezentuje dzień tygodnia.

Wartości w polu enum
DAY_OF_WEEK_UNSPECIFIED Dzień tygodnia nie został określony.
MONDAY Poniedziałek
TUESDAY Tuesday (wtorek)
WEDNESDAY Wednesday (środa)
THURSDAY Thursday (czwartek)
FRIDAY Friday (piątek)
SATURDAY Saturday (sobota)
SUNDAY Niedziela

TimeOfDay

Reprezentuje porę dnia. Data i strefa czasowa nie mają znaczenia lub są określone w innym miejscu. Interfejs API może zezwalać na sekundy przestępne. Powiązane typy to google.type.Date i google.protobuf.Timestamp.

Zapis JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Pola
hours

integer

Godziny w formacie 24-godzinnym. Wartość musi być równa lub większa niż 0 i zwykle nie może być większa niż 23. Interfejs API może zezwalać na wartość „24:00:00” w przypadku takich scenariuszy jak godzina zamknięcia firmy.
minutes

integer

Minuty w godzinie. Wartość musi być równa lub większa niż 0 i równa lub mniejsza niż 59.
seconds

integer

Sekundy w minucie. Wartość musi być równa lub większa niż 0 i zwykle nie może być większa niż 59. Interfejs API może zezwalać na wartość 60, jeśli dopuszcza sekundy przestępne.
nanos

integer

Ułamki sekund w nanosekundach. Wartość musi być równa lub większa niż 0 i mniejsza lub równa 999 999 999.

SpecialHours

Reprezentuje zbiór przedziałów czasu, w których godziny otwarcia lokalizacji różnią się od jej standardowych godzin pracy.

Zapis JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Pola
specialHourPeriods[]

object (SpecialHourPeriod)

Wymagane. Lista wyjątków od standardowych godzin pracy firmy.

SpecialHourPeriod

Reprezentuje pojedynczy okres, w którym godziny otwarcia lokalizacji różnią się od standardowych godzin otwarcia. Niestandardowe godziny otwarcia muszą obejmować zakres krótszy niż 24 godziny. Wartości openTime i startDate muszą być wcześniejsze niż closeTime i endDate. closeTime i endDate mogą zostać przedłużone do godziny 11:59 dnia następującego po określonym startDate. Prawidłowe dane wejściowe to na przykład:

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 (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Pola
startDate

object (Date)

Wymagane. Data rozpoczęcia okresu niestandardowych godzin otwarcia.
openTime

object (TimeOfDay)

Opcjonalnie: Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego dnia. Musi być określony, jeśli closed ma wartość false.
endDate

object (Date)

Opcjonalnie: Data zakończenia niestandardowych godzin otwarcia. Jeśli pole endDate nie jest ustawione, domyślnie używana jest data określona w polu startDate. Jeśli to pole jest ustawione, musi być równe startDate lub przypadać maksymalnie 1 dzień po tej dacie.
closeTime

object (TimeOfDay)

Opcjonalnie: Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ na końcu określonego dnia. Musi być określony, jeśli parametr closed ma wartość „fałsz”.
closed

boolean

Opcjonalnie: Jeśli ma wartość „true”, parametry endDate, openTime i closeTime są ignorowane, a data podana w parametrze startDate jest traktowana jako dzień, w którym lokalizacja jest zamknięta przez cały dzień.

Data

Reprezentuje pełną lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:

  • Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
  • Miesiąc i dzień z rokiem zerowym (np. rocznica).
  • Sam rok z miesiącem i dniem zerowym.
  • Rok i miesiąc z dniem zerowym (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę bez roku.
month

integer

Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz sam rok lub rok i miesiąc, gdy dzień nie jest istotny.

ServiceAreaBusiness

Firmy działające na określonym obszarze świadczą usługi w lokalizacji klienta (np. ślusarz lub hydraulik).

Zapis JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Pola
businessType

enum (BusinessType)

Wymagane. Wskazuje [typ] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] firmy działającej na określonym obszarze.
places

object (Places)

Opcjonalnie: Obszar, na którym działa ta firma, określony przez zestaw miejsc.
regionCode

string

Wartość niezmienna. Kod regionu CLDR kraju lub regionu, w którym znajduje się firma działająca na określonym obszarze. Więcej informacji znajdziesz na stronach http://cldr.unicode.org/ i http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH” dla Szwajcarii.

To pole jest wymagane w przypadku firm, które świadczą usługi wyłącznie w lokalizacji klienta. W pozostałych przypadkach jest ignorowane.

Region podany tutaj może się różnić od regionów, w których firma świadczy usługi (np. firmy działające na określonym obszarze, które świadczą usługi w regionach innych niż ten, w którym mają siedzibę).

Jeśli ta lokalizacja wymaga weryfikacji po utworzeniu, adres podany do celów weryfikacji musi znajdować się w tym regionie, a właściciel firmy lub jego upoważniony przedstawiciel musi mieć możliwość odbierania poczty pod podanym adresem weryfikacyjnym.

BusinessType

Wskazuje, czy firma oferuje usługi tylko na miejscu u klienta (np. pomoc drogowa) czy zarówno pod adresem, jak i na miejscu (np. pizzeria z salą dla gości, która oferuje też dostawę do klientów).

Wartości w polu enum
BUSINESS_TYPE_UNSPECIFIED Tylko dane wyjściowe. Nie określono.
CUSTOMER_LOCATION_ONLY świadczy usługi tylko w okolicznym obszarze (nie pod adresem firmy). Jeśli firma jest aktualizowana z CUSTOMER_AND_BUSINESS_LOCATION na CUSTOMER_LOCATION_ONLY, informacja o zmianie lokalizacji musi zawierać maskę pola storefrontAddress i ustawić pole jako puste.
CUSTOMER_AND_BUSINESS_LOCATION Oferuje usługi pod adresem firmy i w okolicy.

Miejsca

Definiuje sumę obszarów reprezentowanych przez zbiór miejsc.

Zapis JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Pola
placeInfos[]

object (PlaceInfo)

Opcjonalnie: Obszary reprezentowane przez identyfikatory miejsc. Możesz dodać maksymalnie 20 miejsc.

PlaceInfo

Definiuje obszar reprezentowany przez identyfikator miejsca.

Zapis JSON 
{
  "placeName": string,
  "placeId": string
}
Pola
placeName

string

Wymagane. Zlokalizowana nazwa miejsca. Na przykład: Scottsdale, AZ.
placeId

string

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

string

Wymagane. Alternatywny numer telefonu, który ma być wyświetlany w rozszerzeniach lokalizacji AdWords zamiast głównego numeru telefonu lokalizacji.

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest ona wyrażona jako para liczb zmiennoprzecinkowych podwójnej precyzji, które reprezentują stopnie szerokości i długości geograficznej. O ile nie określono 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

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0].
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [-180,0, +180,0].

OpenInfo

Informacje o stanie otwarcia firmy.

Zapis JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Pola
status

enum (OpenForBusiness)

Wymagane. Wskazuje, czy lokalizacja jest obecnie otwarta. Domyślnie wszystkie lokalizacje są otwarte, chyba że zostaną zaktualizowane jako zamknięte.
canReopen

boolean

Tylko dane wyjściowe. Wskazuje, czy tę firmę można ponownie otworzyć.
openingDate

object (Date)

Opcjonalnie: Data otwarcia lokalizacji. Jeśli dokładny dzień nie jest znany, można 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,
  "isParticularlyPersonalPlace": boolean
}
Pola
hasGoogleUpdated

boolean

Tylko dane wyjściowe. Wskazuje, czy identyfikator miejsca powiązany z tą lokalizacją ma aktualizacje, które klient musi zaakceptować lub odrzucić. Jeśli ta wartość logiczna jest ustawiona, wywołaj metodę getGoogleUpdated, aby wyszukać informacje, które należy zweryfikować.
hasPendingEdits

boolean

Tylko dane wyjściowe. Wskazuje, czy którekolwiek z właściwości tej lokalizacji są w stanie oczekiwania na edycję.
canDelete

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizację można usunąć za pomocą interfejsu API.
canOperateLocalPost
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: to pole nie jest już wypełniane i zostanie usunięte w przyszłej wersji.
canModifyServiceList

boolean

Tylko dane wyjściowe. Wskazuje, czy wizytówka może modyfikować listę usług.
canHaveFoodMenus

boolean

Tylko dane wyjściowe. Wskazuje, czy wizytówka kwalifikuje się do wyświetlania menu.
canOperateHealthData

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja może działać na danych dotyczących zdrowia.
canOperateLodgingData

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja może działać na danych dotyczących noclegów.
placeId

string

Tylko dane wyjściowe. Jeśli ta lokalizacja pojawia się w Mapach Google, to pole jest wypełniane identyfikatorem miejsca dla tej lokalizacji. Tego identyfikatora można używać w różnych interfejsach Places API.

To pole można ustawić podczas wywołań Create, ale nie Update.
duplicateLocation

string

Tylko dane wyjściowe. Zasób lokalizacji, który jest duplikowany przez tę lokalizację.
mapsUri

string

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

string

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

boolean

Tylko dane wyjściowe. Wskazuje, czy wizytówka kwalifikuje się do połączeń z firmą.
hasVoiceOfMerchant

boolean

Tylko dane wyjściowe. Wskazuje, czy informacje o firmie zawierają opinie sprzedawców. Jeśli ta wartość logiczna jest fałszywa, wywołaj interfejs API locations.getVoiceOfMerchantState, aby dowiedzieć się, dlaczego nie mają dostępu do Voice of Merchant.
isParticularlyPersonalPlace

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja jest sklasyfikowana jako miejsce o charakterze szczególnie osobistym. Oznacza to, że funkcje historii lokalizacji są ograniczone. Jeśli uważasz, że to pomyłka, przeczytaj artykuł w Centrum pomocy.

Profil

Wszystkie informacje dotyczące profilu lokalizacji.

Zapis JSON 
{
  "description": string
}
Pola
description

string

Wymagane. Opis lokalizacji własnymi słowami, którego nikt inny nie może edytować.

RelationshipData

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

Zapis JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Pola
parentLocation

object (RelevantLocation)

Opcjonalnie: Lokalizacja nadrzędna, z którą powiązana jest ta lokalizacja.
childrenLocations[]

object (RelevantLocation)

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

string

Opcjonalnie: Nazwa zasobu sieci, do której należy ta lokalizacja. [How to find Chain ID] [Locations.SearchChains]

RelevantLocation

Informacje o innej lokalizacji, która jest powiązana z bieżącą. Relacja może być DEPARTMENT_OF lub INDEPENDENT_ESTABLISHMENT_OF, a określona tutaj lokalizacja może być po dowolnej stronie (nadrzędnej lub podrzędnej) lokalizacji.

Zapis JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Pola
placeId

string

Wymagane. Określ lokalizację, która znajduje się po drugiej stronie relacji, podając jej identyfikator miejsca.
relationType

enum (RelationType)

Wymagane. Typ relacji.

RelationType

Relacje typu, które mają zostać określone.

Wartości w polu enum
RELATION_TYPE_UNSPECIFIED Nie określono typu.
DEPARTMENT_OF Reprezentuje relację między 2 lokalizacjami, które znajdują się na tym samym obszarze fizycznym, mają tę samą markę, zarząd lub organizację, ale różnią się kluczowymi atrybutami, takimi jak godziny otwarcia czy numery telefonów. Na przykład apteka Costco jest działem w sklepie Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN Dotyczy to przypadków, gdy 2 lokalizacje znajdują się w tym samym miejscu, ale należą do różnych firm (np. Starbucks w Safeway, sklepy w centrum handlowym).

MoreHours

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

Zapis JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Pola
hoursTypeId

string

Wymagane. Rodzaj godzin. Klienci powinni wywołać metodę {#link businessCategories:BatchGet}, aby uzyskać obsługiwane typy godzin dla kategorii swoich lokalizacji.
periods[]

object (TimePeriod)

Wymagane. Zbiór godzin, w których ta lokalizacja jest otwarta. Każdy okres reprezentuje zakres godzin, w których lokalizacja jest otwarta w ciągu tygodnia.

ServiceItem

Wiadomość opisująca pojedynczy element usługi. Służy do opisywania rodzaju usługi świadczonej przez sprzedawcę. Usługą może być na przykład strzyżenie.

Zapis JSON 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Pola
price

object (Money)

Opcjonalnie: Reprezentuje cenę usługi. Zalecamy, aby podczas podawania ceny ustawić currencyCode i units. Będzie ona traktowana jako stała cena usługi.
Zawsze powinno być ustawione jedno z tych pól. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
structuredServiceItem

object (StructuredServiceItem)

Opcjonalnie: To pole zostanie ustawione w przypadku uporządkowanych danych usług.
freeFormServiceItem

object (FreeFormServiceItem)

Opcjonalnie: To pole zostanie ustawione w przypadku danych usług w formie swobodnej.
Koniec pól wykluczających się wzajemnie.

StructuredServiceItem

Reprezentuje ustrukturyzowaną usługę oferowaną przez sprzedawcę. Na przykład: toilet_installation.

Zapis JSON 
{
  "serviceTypeId": string,
  "description": string
}
Pola
serviceTypeId

string

Wymagane. Pole serviceTypeId to unikalny identyfikator podany przez Google, który można znaleźć w ServiceType. Te informacje są dostarczane przez usługę RPC categories.batchGet.
description

string

Opcjonalnie: Opis uporządkowanego elementu usługi. Limit znaków wynosi 300.

FreeFormServiceItem

Reprezentuje usługę o dowolnej formie oferowaną przez sprzedawcę. Są to usługi, które nie są udostępniane w ramach danych usługi dotyczących struktury. Sprzedawca ręcznie wpisuje nazwy takich usług, korzystając z interfejsu geomerchant.

Zapis JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Pola
category

string

Wymagane. To pole reprezentuje nazwę kategorii (czyli jej stały identyfikator). Wartości category i serviceTypeId powinny być zgodne z możliwymi kombinacjami podanymi w komunikacie Category.
label

object (Label)

Wymagane. Etykiety z tagami językowymi dla elementu. Zalecamy, aby nazwy produktów miały maksymalnie 140 znaków, a opisy – 250 znaków. To pole należy ustawić tylko wtedy, gdy dane wejściowe są niestandardową usługą. Standaryzowane typy usług należy aktualizować za pomocą parametru serviceTypeId.

Etykieta

Etykieta, która ma być używana podczas wyświetlania cennika, sekcji lub pozycji.

Zapis JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Pola
displayName

string

Wymagane. Wyświetlana nazwa cennika, sekcji lub pozycji.
description

string

Opcjonalnie: Opis cennika, sekcji lub pozycji.
languageCode

string

Opcjonalnie: Kod języka w standardzie BCP-47, do którego odnoszą się te ciągi tekstowe. Dla każdego języka można ustawić tylko jeden zestaw etykiet.

Pieniądze

Reprezentuje kwotę pieniężną z rodzajem waluty.

Zapis JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Pola
currencyCode

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.
units

string (int64 format)

Całe jednostki kwoty. Jeśli na przykład currencyCode to "USD", 1 jednostka to 1 USD.
nanos

integer

Liczba jednostek nano (10^-9) kwoty. Wartość musi się zawierać w przedziale od -999 999 999 do +999 999 999 (włącznie). Jeśli units jest dodatnia, nanos musi być dodatnia lub wynosić zero. Jeśli units wynosi zero, nanos może być liczbą dodatnią, ujemną lub zerem. Jeśli parametr units ma wartość ujemną, parametr nanos musi mieć wartość ujemną lub wynosić zero. Na przykład kwota -1,75 USD jest reprezentowana jako units=-1 i nanos=-750 000 000.

Metody

create

 Tworzy nową lokalizację, której właścicielem będzie zalogowany użytkownik.

list

 Wyświetla listę lokalizacji dla określonego konta.