REST Resource: accounts.locations

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 (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

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

string

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

string

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

object (PhoneNumbers)

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

object (Categories)

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

object (PostalAddress)

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

string

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

object (BusinessHours)

Opcjonalnie. Godziny otwarcia firmy.
specialHours

object (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

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, to pole opisuje obsługiwane przez nią obszary.
labels[]

string

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

object (AdWordsLocationExtensions)

Opcjonalnie. Dodatkowe informacje wyświetlane w AdWords.
latlng

object (LatLng)

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

object (OpenInfo)

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

object (Metadata)

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

object (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

object (RelationshipData)

Opcjonalnie. Wszystkie powiązane z nią lokalizacje i sieci.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

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

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

string

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

string

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

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 (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Pola
primaryCategory

object (Category)

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

object (Category)

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

Kategoria

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

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

string

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

string

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

object (ServiceType)

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

object (MoreHoursType)

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

string

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

string

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

string

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

string

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

string

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

integer

Wersja schematu elementu PostalAddress. Musi być ustawiona wartość 0, czyli najnowsza wersja.

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

string

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

string

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

string

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

string

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

string

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

string

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

string

Opcjonalnie. Dzielnica adresu. Mogą to być dzielnice, dystrykty, dzielnice.
addressLines[]

string

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

string

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

string

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 (TimePeriod)
    }
  ]
}
Pola
periods[]

object (TimePeriod)

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

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 (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Pola
openDay

enum (DayOfWeek)

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

object (TimeOfDay)

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

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

integer

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

integer

Minuty w ciągu dnia. Wymagana wartość z zakresu od 0 do 59.
seconds

integer

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

integer

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 (SpecialHourPeriod)
    }
  ]
}
Pola
specialHourPeriods[]

object (SpecialHourPeriod)

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

object (Date)

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

object (TimeOfDay)

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

object (Date)

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

object (TimeOfDay)

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

boolean

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

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:

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

integer

Rok daty. Należy podać wartość z zakresu od 1 do 9999 lub 0, aby określić datę bez roku.
month

integer

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

integer

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 (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Pola
businessType

enum (BusinessType)

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

object (Places)

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

string

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

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

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

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

BusinessType

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

Wartości w polu enum
BUSINESS_TYPE_UNSPECIFIED Tylko dane wyjściowe. Nie określono.
CUSTOMER_LOCATION_ONLY Usługa działa tylko w okolicy (nie pod adresem firmy). Jeśli firma jest aktualizowana z lokalizacji CUSTOMER_AND_BUSINESS_LOCATION na CUSTOMER_LOCATION_ONLY, aktualizacja lokalizacji musi zawierać maskę pola 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 (PlaceInfo)
    }
  ]
}
Pola
placeInfos[]

object (PlaceInfo)

Obszary reprezentowane przez identyfikatory miejsc. Maksymalnie 20 miejsc.

PlaceInfo

Określa obszar reprezentowany przez identyfikator miejsca.

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

string

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

string

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

string

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

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 dotyczące stanu otwarcia firmy.

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

enum (OpenForBusiness)

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

boolean

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

object (Date)

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

OpenForBusiness

Wskazuje stan lokalizacji.

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

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ą ma aktualizacje, które klient musi zaktualizować lub odrzucić. Jeśli ta wartość logiczna jest ustawiona, do wyszukiwania informacji, które wymagają weryfikacji, należy wywołać metodę getGoogleUpdated.
hasPendingEdits

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

string

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

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

string

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

string

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

string

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

boolean

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

boolean

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

string

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

RelationshipData

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

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

object (RelevantLocation)

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

object (RelevantLocation)

Lista lokalizacji podrzędnych, z którymi jest powiązana 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 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 (RelationType)
}
Pola
placeId

string

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

enum (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 (TimePeriod)
    }
  ]
}
Pola
hoursTypeId

string

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

object (TimePeriod)

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

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 (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. 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

object (StructuredServiceItem)

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

object (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

string

To pole jest wymagane. Pole serviceTypeId zawiera 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 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 (Label)
  }
}
Pola
category

string

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

object (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

string

To pole jest 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 jeden zestaw etykiet.

Pieniądze

Reprezentuje kwotę pieniędzy wraz z typem 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 np. currencyCode to "USD", to 1 jednostka to 1 dolar amerykański.
nanos

integer

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 units ma wartość dodatnią, nanos musi być liczbą dodatnią lub 0. Jeśli units ma wartość 0, nanos może mieć wartość dodatnią, 0 lub ujemną. Jeśli units ma wartość ujemną, nanos musi być liczbą ujemną lub 0. Na przykład wartość -1,75 USD będzie widoczna w postaci units=-1 i nanos=-750 000 000.

Metody

create

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

list

 Zawiera listę lokalizacji określonego konta.