REST Resource: accounts.locations

Zasób: lokalizacja

Lokalizacja. Szczegółowy opis tych pól znajdziesz w tym artykule w Centrum pomocy. W przypadku punktu końcowego kategorii znajdziesz listę prawidłowych kategorii działalności.

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 Google dla tej lokalizacji w formacie: locations/{locationId}.
languageCode

string

Stały. Język lokalizacji. Ustawia się podczas tworzenia i nie można go aktualizować.
storeCode

string

Opcjonalnie: Zewnętrzny identyfikator lokalizacji, który musi być niepowtarzalny w obrębie danego konta. W ten sposób możemy powiązać lokalizację z własnymi danymi.
title

string

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 w razie potrzeby umieścić w innych polach zasobu (na przykład Address, Categories). Nie dodawaj zbędnych informacji do swojej nazwy (np. używaj określenia „Google”, a nie „Google Inc. – Centrum korporacyjne w Mountain View”). Nie podawaj sloganów marketingowych, kodów sklepów, znaków specjalnych, godzin otwarcia, stanu „otwarte/zamknięte”, numerów telefonów, adresów URL witryn, informacji o usługach/produktach, lokalizacji, adresu lub wskazówek dojazdu ani informacji o ograniczeniu (np. „Bankomat PKO BP w Duhanie”).
phoneNumbers

object (PhoneNumbers)

Opcjonalnie: różne numery telefonów, za pomocą których klienci mogą kontaktować się z firmą.
categories

object (Categories)

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

object (PostalAddress)

Opcjonalnie: Dokładny adres opisujący lokalizację firmy. Skrytki pocztowe i skrzynki pocztowe w odległych lokalizacjach są niedozwolone. Obecnie możesz określić maksymalnie 5 wartości addressLines w adresie. To pole należy ustawiać tylko dla firm, które mają sklep. To pole nie powinno być ustawione dla lokalizacji typu CUSTOMER_LOCATION_ONLY, ale jeśli jest ustawione, wszystkie podane wartości będą odrzucane.
websiteUri

string

Opcjonalnie: Adres URL tej firmy. W miarę możliwości użyj adresu URL reprezentującego daną lokalizację firmy zamiast ogólnego adresu URL witryny lub adresu URL reprezentującego wszystkie lokalizacje bądź marki.
regularHours

object (BusinessHours)

Opcjonalnie: Godziny pracy firmy.
specialHours

object (SpecialHours)

Opcjonalnie: Niestandardowe godziny otwarcia firmy. Godziny otwarcia zwykle obejmują dni wolne od pracy, a czasami poza standardowymi godzinami pracy. Zastępują one standardowe godziny otwarcia. Nie można ustawić tego pola bez zwykłych godzin pracy.
serviceArea

object (ServiceAreaBusiness)

Opcjonalnie: Firmy działające na określonym obszarze świadczą usługi w lokalizacji klienta. Jeśli firma świadczy usługi na określonym obszarze, w tym polu opisano obsługiwane przez nią obszary.
labels[]

string

Opcjonalnie: Zbiór dowolnych ciągów tekstowych, które umożliwiają otagowanie firmy. Te etykiety NIE są widoczne dla użytkowników. widoczne tylko dla Ciebie. Każda etykieta musi zawierać od 1 do 255 znaków.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opcjonalnie: Dodatkowe informacje w AdWords.
latlng

object (LatLng)

Opcjonalnie: Długość i szerokość geograficzna podane przez użytkownika. Podczas tworzenia lokalizacji to pole jest ignorowane, jeśli podane dane geograficzne zostaną przetworzone. To pole jest zwracane w przypadku żądań odbierania tylko wtedy, gdy podana przez użytkownika wartość latlng została zaakceptowana podczas tworzenia lub 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 dana lokalizacja jest obecnie otwarta dla firm.
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 wyjątkową historię o Twojej firmie i jej ofercie.

To pole jest wymagane w przypadku wszystkich kategorii z wyjątkiem kategorii noclegów (np. hotele, motele, zajazdy).
relationshipData

object (RelationshipData)

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

object (MoreHours)

Opcjonalnie: Więcej godzin dla różnych działów firmy lub dla poszczególnych 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 elementy usługi są automatycznie usuwane.

PhoneNumbers

Zbiór numerów telefonów do firmy. Podczas aktualizacji musisz ustawić oba pola. Klienci nie mogą aktualizować przy użyciu maski aktualizacji tylko podstawowych ani dodatkowych numerów telefonów. Preferowany format międzynarodowego numeru telefonu, np. „+1 415 555 0132”, zawiera więcej informacji tutaj: https://developers.google.com/style/phone-numbers#international-phone-numbers).

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

string

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[]

string

Opcjonalnie: Maksymalnie dwa numery telefonu (komórkowe lub stacjonarne, bez faksu), pod które 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 głównych ani dodatkowych za pomocą maski aktualizacji.

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

object (Category)

Wymagane. Kategoria, która najlepiej opisuje główną działalność, jaką prowadzi dana lokalizacja.
additionalCategories[]

object (Category)

Opcjonalnie: Dodatkowe kategorie opisujące Twoją firmę. Dzięki kategoriom klienci mogą znaleźć dokładne wyniki wyszukiwania usług, którymi są zainteresowani. Aby informacje o firmie były dokładne i nieaktualne, do opisania podstawowej działalności firmy używaj 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 charakter firmy (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 (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Pola
name

string

Wymagane. Stały identyfikator (udostępniony przez Google) dla 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 opcja jest ustawiana przy odczytywaniu lokalizacji. Podczas modyfikowania lokalizacji musisz ustawić category_id.
serviceTypes[]

object (ServiceType)

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

object (MoreHoursType)

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

ServiceType

Komunikat opisujący typ usługi oferowanej przez firmę.

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

string

Tylko dane wyjściowe. Stabilny identyfikator (udostępniony 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

Inne typy godzin, które firma może oferować oprócz zwykłych godzin pracy.

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

string

Tylko dane wyjściowe. Stabilny identyfikator udostępniony przez Google dla tego typu godzin pracy.
displayName

string

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

string

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

PostalAddress

Reprezentuje adres pocztowy, np. adresów dostawy lub płatności. Jeśli podasz adres pocztowy, firma pocztowa może dostarczyć przesyłki do placówki Twojej firmy. Box lub podobnego. Nie służy on do modelowania lokalizacji geograficznych (dróg, miast, gór).

W większości przypadków adres jest tworzony na podstawie danych wejściowych użytkownika lub importowanych istniejących danych, w zależności od typu procesu.

Porady dotyczące wpisywania / edytowania adresu: – skorzystaj z widżetu z adresem do internacjonalizacji, np. https://github.com/google/libaddressinput – nie należy wyświetlać użytkownikom elementów interfejsu do wprowadzania lub edytowania pól spoza krajów, w których takie pole jest używane.

Więcej wskazówek dotyczących korzystania 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 tabeli PostalAddress. Wartość ta musi wynosić 0, co jest najnowszą wersją.

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

string

Wymagane. Kod regionu CLDR kraju lub regionu adresu. Nie są one nigdy wnioskowane i to użytkownik musi upewnić się, że wartość jest prawidłowa. Szczegółowe informacje można znaleźć na stronach https://cldr.unicode.org/ i https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Przykład: „CH”. dla Szwajcarii.
languageCode

string

Opcjonalnie: Kod języka BCP-47 treści adresu (jeśli jest znany). Często jest to język interfejsu formularza wejściowego lub prawdopodobnie jeden z języków używanych w adresie kraj/region lub ich transliterowane odpowiedniki. Może to wpłynąć na formatowanie w niektórych krajach, ale nie ma wpływu na prawidłowość danych i nigdy nie wpływa na weryfikację ani inne operacje związane z nieformatowaniem.

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

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

string

Opcjonalnie: Kod pocztowy adresu. Nie wszystkie kraje używają kodów pocztowych lub ich wymagają, ale tam, gdzie są używane, mogą powodować dodatkową weryfikację innych części adresu (np. stan lub kod pocztowy w Stanach Zjednoczonych).
sortingCode

string

Opcjonalnie: Dodatkowy kod sortowniczy specyficzny dla kraju. Nie jest on używany w większości regionów. Ta wartość jest ciągiem znaków takim jak „CEDEX”, po którym może występować liczba (np. „CEDEX 7”), lub samej liczby reprezentującej „kod sektora” (Jamajka), „wskaźnik obszaru dostawy” (Malawi) lub „wskaźnik urzędu pocztowego” (np. Wybrzeże Kości Słoniowej).
administrativeArea

string

Opcjonalnie: Najwyższy podział administracyjny stosowany w przypadku adresów pocztowych kraju lub regionu. Na przykład stan, prowincja, obwód lub prefektura. W przypadku Hiszpanii jest to prowincja, a nie wspólnota autonomiczna (np. „Barcelona”, nie „Katalonia”). Wiele krajów nie używa regionu w adresach pocztowych. Na przykład: w Szwajcarii pole musi być puste.
locality

string

Opcjonalnie: Zasadniczo odnosi się do części miejscowości lub miejscowości. Przykłady: USA, gmina IT, poczta polska. W regionach, w których miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury, zostaw pole Rejon puste, a następnie użyj addressLines.
sublocality

string

Opcjonalnie: Okręg, w którym znajduje się adres. Na przykład mogą to być dzielnice, dystrykty, okręgi.
addressLines[]

string

Nieuporządkowane wiersze adresu opisujące dolne poziomy adresu.

Wartości w addressLine nie mają informacji o typie i czasami mogą zawierać wiele wartości w jednym polu (np. „Austin, TX”), ważne jest, aby kolejność wierszy była jasna. Kolejność wierszy adresu powinna być określona jako „kolejność danych koperty”. zgodnie z krajem/regionem adresu. Tam, gdzie może być to inne (np. w Japonii), słowo address_language jest używane do jednoznacznego określenia (np. „ja” dla sortowania w dużym i małym porządku oraz „ja-Latn” lub „en” dla małych i dużych). Dzięki temu można wybrać najbardziej precyzyjny wiersz adresu na podstawie języka.

Minimalna dozwolona reprezentacja strukturalna adresu składa się z kodu regionu RegionCode, a wszystkie pozostałe informacje są umieszczane w elemencie addressLines. Sformatowanie takiego adresu w przybliżeniu bez geokodowania byłoby możliwe, ale semantyczne rozumowanie nie byłoby możliwe w odniesieniu do żadnego ze składników adresu, dopóki nie zostanie przynajmniej częściowo rozpatrzone.

Zalecanym sposobem obsługi adresów całkowicie nieuporządkowanych
recipients[]

string

Opcjonalnie: Adresat pod adresem. W pewnych okolicznościach to pole może zawierać informacje obejmujące wiele wierszy. Może na przykład zawierać hasło „opieka” i informacjami o nich.
organization

string

Opcjonalnie: Nazwa organizacji pod adresem.

BusinessHours

Określa okresy, w których dana lokalizacja jest otwarta. Przechowuje kolekcję instancji [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

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

object (TimePeriod)

Wymagane. Zbiór godzin otwarcia danej lokalizacji. Każdy okres oznacza zakres godzin, w których dana lokalizacja jest otwarta w ciągu tygodnia.

TimePeriod

Reprezentuje przedział czasu, w którym firma jest otwarta, począwszy od określonego dnia i godziny otwarcia, a kończyła w określonym dniu i o określonej godzinie zamknięcia. Godzina zamknięcia musi przypadać po godzinie otwarcia, np. 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, kiedy (day of the week) rozpoczyna się ten okres.
openTime

object (TimeOfDay)

Wymagane. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ pod koniec określonego pola dnia.
closeDay

enum (DayOfWeek)

Wymagane. Wskazuje, kiedy day of the week kończy się bieżący okres.
closeTime

object (TimeOfDay)

Wymagane. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ pod koniec określonego pola dnia.

DzieńTygodnia

Przedstawia dzień tygodnia.

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

TimeOfDay

Przedstawia 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. Podobne typy to google.type.Date i google.protobuf.Timestamp.

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

integer

Godziny dnia w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23. Interfejs API może zezwolić na wartość „24:00:00” w takich sytuacjach jak zamknięcie firmy.
minutes

integer

Minuty dnia. Wartość musi mieścić się w przedziale od 0 do 59.
seconds

integer

Sekundy czasu trwania. Zwykle musi mieścić się w zakresie od 0 do 59. Interfejs API może akceptować wartość 60, jeśli zezwala na użycie sekund przestępnych.
nanos

integer

Ułamki sekund w nanosekundach. Musi mieścić się w przedziale od 0 do 999 999 999.

SpecialHours

Odzwierciedla zestaw okresów, w których godziny pracy lokalizacji różnią się od zwykłych godzin pracy.

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

object (SpecialHourPeriod)

Wymagane. Lista wyjątków od zwykłych godzin pracy firmy.

SpecialHourPeriod

Oznacza jeden okres, w którym godziny pracy lokalizacji różnią się od zwykłych godzin otwarcia. Specjalny przedział godzinowy musi mieścić się w zakresie poniżej 24 godzin. openTime i startDate muszą być starsze niż closeTime i endDate. closeTime i endDate mogą przedłużyć się do godziny 11:59 w jeden dzień po określonej wartości 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 (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Pola
startDate

object (Date)

Wymagane. Data kalendarzowa, w której rozpoczyna się ten okres o specjalnej godzinie.
openTime

object (TimeOfDay)

Opcjonalnie: Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ pod koniec określonego pola dnia. Wartość ta musi być określona, jeśli closed ma wartość fałsz.
endDate

object (Date)

Opcjonalnie: Data kalendarzowa, w której kończy się ten okres. Jeśli pole endDate nie jest skonfigurowane, domyślnie jest używana data określona w polu startDate. Jeśli to pole jest skonfigurowane, może przypadać nie później niż 1 dzień po startDate.
closeTime

object (TimeOfDay)

Opcjonalnie: Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ pod koniec określonego pola dnia. Wartość ta musi być określona, jeśli closed ma wartość fałsz.
closed

boolean

Opcjonalnie: Jeśli ma wartość true (prawda), endDate, openTime i closeTime są ignorowane, a data określona w polu startDate jest traktowana jako zamknięta na cały dzień lokalizacja.

Data

Reprezentuje całą datę lub jej część, na przykład datę urodzin. Pora dnia i strefa czasowa zostały określone w innym miejscu lub są nieistotne. Data zależy od kalendarza gregoriańskiego. Może to być jedna z tych wartości:

  • Pełna data z wartościami niezerowymi dotyczącymi roku, miesiąca i dnia.
  • Miesiąc i dzień bez roku (np. rocznica).
  • Sam rok z zerowym miesiącem i zerowym dniem.
  • Rok i miesiąc z zerową datą ważności (np. data ważności karty kredytowej).

Podobne typy:

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

integer

Rok daty. Wartość musi mieścić się w zakresie od 1 do 9999 lub od 0 do określenia daty bez roku.
month

integer

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

integer

Dzień miesiąca. Wartość musi należeć do zakresu od 1 do 31 i jest ważna dla roku i miesiąca. Wartość 0 pozwala określić pojedynczy rok lub rok i miesiąc, w którym dzień nie jest istotny.

ServiceAreaBusiness

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

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

enum (BusinessType)

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

object (Places)

Obszar działalności tej firmy określony za pomocą zestawu miejsc.
regionCode

string

Stały. Kod regionu CLDR kraju lub regionu, w którym znajduje się firma, która świadczy usługi na określonym obszarze. Szczegółowe informacje można znaleźć 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 CUSTOMER_LOCATION_ONLY. W przeciwnym razie jest ignorowane.

Określony tutaj region może się różnić od regionów na obszarach, na których działa ta firma (np. firmy świadczące usługi w regionach innych niż ten, w którym znajduje się Twoja firma).

Jeśli 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 przesyłek pocztowych na podany adres weryfikacyjny.

BusinessType

Informuje, czy ta firma oferuje usługi tylko na miejscu u klienta (np. laweta) czy pod podanym adresem i na miejscu (np. pizzeria z jadalnią, która dostarcza też produkty do klientów).

Wartości w polu enum
BUSINESS_TYPE_UNSPECIFIED Tylko dane wyjściowe. Nie określono.
CUSTOMER_LOCATION_ONLY Oferuje usługi tylko w okolicy (nie pod adresem firmy). Jeśli dane firmy są aktualizowane 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 Oferuje usługi pod adresem firmy i w pobliżu.

Miejsca

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

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

object (PlaceInfo)

Obszary reprezentowane przez identyfikatory miejsc. 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 w AdWords.

Zapis JSON 
{
  "adPhone": string
}
Pola
adPhone

string

Wymagane. Alternatywny numer telefonu wyświetlany w rozszerzeniach lokalizacji AdWords zamiast podstawowego numeru telefonu lokalizacji.

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest ona wyrażona jako para podwójnej precyzji reprezentująca stopnie szerokości i długości geograficznej. 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

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 od -180,0 do +180,0].

OpenInfo

Informacje związane ze stanem otwarcia firmy.

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

enum (OpenForBusiness)

Wymagane. Wskazuje, czy lokalizacja jest obecnie otwarta dla firm. Wszystkie lokalizacje są domyślnie otwarte, dopóki nie zostaną zamknięte.
canReopen

boolean

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

object (Date)

Opcjonalnie: Data pierwszego otwarcia lokalizacji. Jeśli nie znasz dokładnego dnia, 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

boolean

Tylko dane wyjściowe. Wskazuje, czy identyfikator miejsca powiązany z tą lokalizacją zawiera aktualizacje, które klient musi zaktualizować 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 właściwości danej lokalizacji są w stanie oczekiwania na edycję.
canDelete

boolean

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

boolean

Tylko dane wyjściowe. Wskazuje, czy wizytówka może zarządzać wpisami lokalnymi.
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 menu z jedzeniem.
canOperateHealthData

boolean

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

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja może wykorzystywać dane dotyczące kwater.
placeId

string

Tylko dane wyjściowe. Jeśli ta lokalizacja wyświetla się w Mapach Google, w tym polu znajduje się identyfikator tej lokalizacji. Ten identyfikator może być używany w różnych interfejsach API Miejsc.

To pole można ustawić podczas tworzenia połączeń, ale nie w przypadku aktualizacji.
duplicateLocation

string

Tylko dane wyjściowe. Zasób lokalizacji duplikatem tej lokalizacji.
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 dodać opinię o danej lokalizacji.
canHaveBusinessCalls

boolean

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

boolean

Tylko dane wyjściowe. Wskazuje, czy wizytówka zawiera Voice of Merchant. Jeśli ta wartość logiczna ma wartość fałsz, należy wywołać interfejs locations.getVoiceOfMerchantState API, aby uzyskać szczegółowe informacje o tym, dlaczego nie ma on usługi Voice of Merchant.

Profil

Wszystkie informacje związane z profilem lokalizacji.

Zapis JSON 
{
  "description": string
}
Pola
description

string

Wymagane. Opis lokalizacji wyrażony przez Ciebie i nie można go 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)

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

object (RelevantLocation)

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

string

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

RelevantLocation

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

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

string

Wymagane. Określ lokalizację znajdującą się po drugiej stronie relacji przez jego identyfikator miejsca.
relationType

enum (RelationType)

Wymagane. Typ relacji.

RelationType

Relacje typu do określenia.

Wartości w polu enum
RELATION_TYPE_UNSPECIFIED Nie określono typu.
DEPARTMENT_OF Ten obraz przedstawia związek między 2 lokalizacjami, które mają ten sam obszar fizyczny, są to same marki, kierownictwo lub organizacja, ale mają różne kluczowe atrybuty, takie jak godziny otwarcia czy numery telefonów. Przykład: Apteka w Costco jest działem sprzedaży hurtowej Costco.
INDEPENDENT_ESTABLISHMENT_IN Odnosi się to do sytuacji, w których 2 lokalizacje znajdują się w tej samej lokalizacji fizycznej, ale pochodzą od różnych firm (np. Starbucks w centrum handlowym lub w centrum handlowym).

MoreHours

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

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

string

Wymagane. Rodzaj godzin. Klienci powinni zadzwonić pod numer {#link businessKategorie:BatchGet}, aby uzyskać obsługiwane typy godzin pracy dla kategorii lokalizacji.
periods[]

object (TimePeriod)

Wymagane. Zbiór godzin otwarcia tej lokalizacji. Każdy okres oznacza zakres godzin, w których dana lokalizacja jest otwarta w ciągu tygodnia.

ServiceItem

Komunikat opisujący pojedynczy element usługi. Służy do opisania rodzaju usługi świadczonej przez sprzedawcę. Przykładem może być strzyżenie.

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

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
Pola
price

object (Money)

Opcjonalnie: Reprezentuje cenę pieniężną usługi. Zalecamy ustawienie kodu currencyCode i jednostek wraz z ceną. Będzie ona traktowana jako stała cena produktu objętego usługą.
Pole sumy service_item_info. Jedno z pól poniżej powinno być zawsze ustawione. service_item_info może mieć tylko jedną z tych wartości:
structuredServiceItem

object (StructuredServiceItem)

Opcjonalnie: W tym polu zostanie ustawiona wielkość liter uporządkowanych danych usług.
freeFormServiceItem

object (FreeFormServiceItem)

Opcjonalnie: W tym polu będzie ustawiana wielkość liter dowolnych danych usług.

StructuredServiceItem

Reprezentuje uporządkowaną 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ądkowanych danych usługi. Limit znaków wynosi 300.

FreeFormServiceItem

Reprezentuje swobodną usługę oferowaną przez sprzedawcę. Są to usługi, które nie są udostępniane w ramach naszych uporządkowanych danych. Sprzedawca ręcznie wpisuje nazwy takich usług za pomocą platformy sprzedawcy danych geograficznych.

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

string

Wymagane. To pole zawiera nazwę kategorii (tj. jej stały identyfikator). Wartości category i serviceTypeId powinny odpowiadać możliwym kombinacjom zawartym w komunikacie Category.
label

object (Label)

Wymagane. Etykiety językowe z elementem. Zalecamy, aby nazwa produktu miała maksymalnie 140 znaków, a opis – 250 znaków. To pole należy ustawiać tylko wtedy, gdy dane wejściowe to niestandardowy element usługi. Standardowe typy usług należy aktualizować za pomocą parametru serviceTypeId.

Etykieta

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

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

string

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

string

Opcjonalnie: Opis cennika, sekcji lub produktu.
languageCode

string

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

Pieniądze

Reprezentuje kwotę za pomocą jej typu 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łkowita jednostka kwoty. Jeśli na przykład currencyCode to "USD", 1 jednostka to 1 zł.
nanos

integer

Liczba jednostek nano (10^-9) ilości. Wartość musi mieścić się w zakresie od -999 999 999 do +999 999 999 włącznie. Jeśli units ma wartość dodatnią, nanos musi być liczbą dodatnią lub zero. Jeśli units ma wartość 0, nanos może być liczbą dodatnią, zerową lub ujemną. Jeśli units ma wartość ujemną, nanos musi mieć wartość ujemną lub zero. Na przykład -1,75 zł jest przedstawione jako units=-1 i nanos=-750 000 000.

Metody

create

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

list

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