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,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Pola
name

string

Identyfikator Google dla tej lokalizacji w formacie: accounts/{accountId}/locations/{locationId}

W przypadku dopasowań to pole nie będzie wypełniane.

languageCode

string

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

storeCode

string

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.

locationName

string

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”).

primaryPhone

string

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

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

address

object (PostalAddress)

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.

primaryCategory

object (Category)

Kategoria najlepiej opisująca główną działalność, w której działa ta lokalizacja.

additionalCategories[]

object (Category)

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.

websiteUrl

string

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)

Godziny otwarcia firmy.

specialHours

object (SpecialHours)

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.

serviceArea

object (ServiceAreaBusiness)

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.

locationKey

object (LocationKey)

Zestaw kluczy łączących firmę z innymi usługami Google, np. stroną Google+ i miejscami w Mapach Google.

labels[]

string

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. Limit wynosi 255 znaków (na etykietę).

adWordsLocationExtensions

object (AdWordsLocationExtensions)

Dodatkowe informacje wyświetlane w AdWords.

latlng

object (LatLng)

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. Tego pola nie można zaktualizować.

openInfo

object (OpenInfo)

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

locationState

object (LocationState)

Tylko dane wyjściowe. Zestaw wartości logicznych odzwierciedlających stan lokalizacji.

attributes[]

object (Attribute)

Atrybuty tej lokalizacji.

metadata

object (Metadata)

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

priceLists[]
(deprecated)

object (PriceList)

Wycofane: informacje o cenniku dotyczące tej lokalizacji.

profile

object (Profile)

Osobiście opisują Twoją firmę i przedstawiają użytkownikom niepowtarzalną historię jej firmy i jej oferty.

relationshipData

object (RelationshipData)

Wszystkie powiązane z nią lokalizacje i sieci.

moreHours[]

object (MoreHours)

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

BusinessHours

Określa przedziały czasu, w których firma jest otwarta. Przechowuje kolekcję TimePeriod instancji.

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

object (TimePeriod)

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

enum (DayOfWeek)

Wskazuje day of the week, od którego rozpoczyna się ten okres.

openTime

string

Czas w 24-godzinnym formacie ISO 8601 (gg:mm). 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)

Wskazuje day of the week, do którego ten okres kończy się.

closeTime

string

Czas w 24-godzinnym formacie ISO 8601 (gg:mm). 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

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)

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

object (Date)

Data kalendarzowa rozpoczęcia obowiązywania specjalnych godzin pracy.

openTime

string

Czas wyświetlania na ekranie urządzenia w dniu startDate po otwarciu lokalizacji, wyrażony w rozszerzonym formacie ISO 8601 (24 godziny). (gg:mm) Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ przypadającą na koniec określonego pola dnia. Ta wartość musi być określona, jeśli isClosed ma wartość fałsz.

endDate

object (Date)

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

string

Czas wyświetlania na ekranie urządzenia w dniu endDate, gdy lokalizacja jest zamknięta, wyrażony w rozszerzonym formacie ISO 8601 (24 godziny). (gg:mm) Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ przypadającą na koniec określonego pola dnia. Ta wartość musi być określona, jeśli isClosed ma wartość fałsz.

isClosed

boolean

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

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),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Pola
businessType

enum (BusinessType)

Wskazuje type firmy działającej na określonym obszarze.

Pole sumy coverageArea. Wskazuje obszar zasięgu, w którym firma oferuje usługi. coverageArea może mieć tylko jedną z tych wartości:
radius

object (PointRadius)

Tylko dane wyjściowe. Obszar, na którym firma świadczy usługi, skupiony wokół jednego punktu.

places

object (Places)

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

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).
CUSTOMER_AND_BUSINESS_LOCATION Świadczy usługi pod adresem firmy i w jej okolicy.

PointRadius

Promień wokół określonego punktu (szerokość/długość geograficzna).

Zapis JSON
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Pola
latlng

object (LatLng)

Szerokość/długość geograficzna określająca środek obszaru wyznaczonego przez promień.

radiusKm

number

Odległość w kilometrach obszaru wokół punktu.

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

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
{
  "name": string,
  "placeId": string
}
Pola
name

string

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

placeId

string

Identyfikator miejsca. Musi odpowiadać regionowi.

LocationKey

Alternatywne/zastępcze odwołania do lokalizacji.

Zapis JSON
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Pola
plusPageId

string

Tylko dane wyjściowe. Jeśli z tą lokalizacją jest powiązana strona Google+, to pole jest wypełniane identyfikatorem strony Google+ tej lokalizacji.

placeId

string

Jeśli ta lokalizacja została zweryfikowana, jest powiązana z Mapami Google lub się z nią wyświetla, w tym polu pojawia się identyfikator miejsca powiązany z tą lokalizacją. Tego identyfikatora można używać w różnych interfejsach API Miejsc.

Jeśli ta lokalizacja nie jest zweryfikowana, to pole może być wypełnione, jeśli jest powiązana z miejscem, które pojawia się w Mapach Google.

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

Dodatkowa wartość logiczna explicitNoPlaceId kwalifikuje się, czy nieustawiony identyfikator miejsca jest zamierzony.

explicitNoPlaceId

boolean

Tylko dane wyjściowe. Wartość „true” (prawda) wskazuje, że nieustawiony identyfikator miejsca jest zamierzony i różni się od tego, że nie utworzono jeszcze żadnego powiązania.

requestId

string

Tylko dane wyjściowe. requestId użyte do utworzenia tej lokalizacji. Pole może być puste, jeśli ta lokalizacja została utworzona poza interfejsem Google Moja Firma API lub Lokalizacjami w Profilu Firmy.

AdWordsLocationExtensions

Dodatkowe informacje wyświetlane w AdWords.

Zapis JSON
{
  "adPhone": string
}
Pola
adPhone

string

Alternatywny numer telefonu wyświetlany w rozszerzeniach lokalizacji AdWords zamiast głównego numeru telefonu lokalizacji.

OpenInfo

Informacje dotyczące stanu otwarcia firmy.

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

enum (OpenForBusiness)

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)

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. Tę wartość można stosować tylko do opublikowanych lokalizacji (np. locationState.is_published = true). Podczas aktualizowania pola stanu do tej wartości klienci muszą ustawić updateMask na openInfo.status. Podczas tego połączenia nie można ustawić innych masek aktualizacji. To jest tymczasowe ograniczenie, które wkrótce zostanie złagodzone.

LocationState

Zawiera zestaw wartości logicznych odzwierciedlających stan lokalizacji.

Zapis JSON
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
Pola
isGoogleUpdated

boolean

Tylko dane wyjściowe. Wskazuje, czy identyfikator miejsca powiązany z tą lokalizacją jest aktualizowany.

isDuplicate

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja jest duplikatem innej lokalizacji.

isSuspended

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja jest zawieszona. Zawieszone lokalizacje nie są widoczne dla użytkowników w usługach Google. Jeśli uważasz, że to pomyłka, przeczytaj ten artykuł w Centrum pomocy.

canUpdate

boolean

Tylko dane wyjściowe. Wskazuje, czy można aktualizować lokalizację.

canDelete

boolean

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

isVerified

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja została zweryfikowana.

needsReverification

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja wymaga ponownej weryfikacji.

isPendingReview

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja oczekuje na sprawdzenie.

isDisabled

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja jest wyłączona.

isPublished

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja została opublikowana.

isDisconnected

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja jest odłączona od danego miejsca w Mapach Google.

isLocalPostApiDisabled

boolean

Tylko dane wyjściowe. Wskazuje, czy opcja accounts.locations.localPosts jest wyłączona dla tej lokalizacji.

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.

hasPendingEdits

boolean

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

hasPendingVerification

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja ma oczekujące prośby o weryfikację.

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.

Atrybut

Atrybut lokalizacji. Atrybuty zawierają dodatkowe informacje o lokalizacji. Atrybuty, które można ustawić dla lokalizacji, mogą się różnić w zależności od jej właściwości (np. kategorii). Dostępne atrybuty są określane przez Google i można je dodawać oraz usuwać bez wprowadzania zmian w interfejsie API.

Zapis JSON
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Pola
attributeId

string

Identyfikator atrybutu. Identyfikatory atrybutów są dostarczane przez Google.

valueType

enum (AttributeValueType)

Tylko dane wyjściowe. Typ wartości tego atrybutu. Pomaga określić sposób interpretacji wartości.

values[]

value (Value format)

Wartości tego atrybutu. Typ podanych wartości musi być zgodny z oczekiwanym dla danego atrybutu. Zobacz AttributeValueType. Jest to pole powtarzane, w którym można podać wiele wartości atrybutu. Typy atrybutów obsługują tylko jedną wartość.

repeatedEnumValue

object (RepeatedEnumAttributeValue)

Gdy typ wartości atrybutu to REPEATED_ENUM, zawiera on wartość atrybutu, a inne pola wartości muszą być puste.

urlValues[]

object (UrlAttributeValue)

Gdy typem wartości atrybutu jest URL, to pole zawiera wartości tego atrybutu, a pozostałe pola wartości muszą być puste.

RepeatedEnumAttributeValue

Wartości dla atrybutu z valueType o wartości REPEATED_ENUM. Składa się z 2 list identyfikatorów wartości – tych, które są ustawione (prawda) i nieskonfigurowane (fałsz). Brak wartości jest uznawany za nieznany. Musisz podać co najmniej 1 wartość.

Zapis JSON
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
Pola
setValues[]

string

Wylicz ustawione wartości.

unsetValues[]

string

Wartości w polu Enum, które nie są skonfigurowane.

UrlAttributeValue

Wartości atrybutu z parametrem valueType adresu URL.

Zapis JSON
{
  "url": string
}
Pola
url

string

Adres URL.

Metadane

dodatkowe informacje o lokalizacji, których użytkownik nie może edytować.

Zapis JSON
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Pola
duplicate
(deprecated)

object (Duplicate)

Informacje o lokalizacji, która jest duplikatem. Widoczny tylko wtedy, gdy zasada locationState.is_duplicate ma wartość prawda. Wycofane: szczegółowe informacje o duplikatach nie są już obsługiwane.

mapsUrl

string

link do lokalizacji w Mapach Google,

newReviewUrl

string

Link do strony w wyszukiwarce Google, na której klient może dodać opinię o lokalizacji.

Powiel

Informacje o lokalizacji, która jest duplikatem.

Zapis JSON
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
Pola
locationName

string

Nazwa zasobu lokalizacji, która jest duplikowana. Wartość jest wypełniana tylko wtedy, gdy uwierzytelniony użytkownik ma uprawnienia dostępu do tej lokalizacji i lokalizacja nie zostanie usunięta.

placeId

string

Identyfikator miejsca lokalizacji, która jest duplikatem.

access

enum (Access)

Wskazuje, czy użytkownik ma dostęp do lokalizacji, którą duplikuje.

Dostęp

Poziom dostępu użytkownika do lokalizacji, która została zduplikowana. Zastępuje ona własność i powinna być używana.

Wartości w polu enum
ACCESS_UNSPECIFIED Nie określono.
ACCESS_UNKNOWN Nie można ustalić, czy użytkownik ma dostęp do lokalizacji, która jest duplikatem.
ALLOWED Użytkownik ma dostęp do lokalizacji, która została zduplikowana.
INSUFFICIENT Użytkownik nie ma dostępu do lokalizacji, która została zduplikowana.

PriceList

Wycofane: lista informacji o cenach produktów. Listy cen składają się z jednego lub kilku list, z których każdy zawiera co najmniej 1 sekcję zawierającą co najmniej 1 produkt. Na przykład listy cen żywności mogą obejmować menu na śniadanie, obiad lub kolację z sekcjami zawierającymi burgery, steki i owoce morza.

Zapis JSON
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Pola
priceListId

string

To pole jest wymagane. Identyfikator cennika. Identyfikatory cen, sekcji i produktów nie mogą się powtarzać w tej lokalizacji.

labels[]

object (Label)

To pole jest wymagane. Etykiety w cenniku z otagowanymi językami.

sourceUrl

string

Opcjonalny źródłowy adres URL, z którego pobrano cennik. Może to być na przykład URL strony, która została automatycznie pobrana w celu wypełnienia informacji w menu.

sections[]

object (Section)

To pole jest wymagane. Sekcje tego cennika. Każdy cennik musi zawierać co najmniej 1 sekcję.

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.

Sekcja

Sekcja cennika zawierająca co najmniej 1 element.

Zapis JSON
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Pola
sectionId

string

To pole jest wymagane. Identyfikator sekcji. Identyfikatory cen, sekcji i produktów nie mogą się powtarzać w tej lokalizacji.

labels[]

object (Label)

To pole jest wymagane. Etykiety sekcji z tagami języka. Zalecamy, aby długość nazw i opisów sekcji nie przekraczała 140 znaków. Wymagany jest co najmniej jeden zestaw etykiet.

sectionType

enum (SectionType)

Opcjonalnie. Typ bieżącej sekcji cennika. Wartość domyślna to JEDZENIE.

items[]

object (Item)

Elementy zawarte w tej sekcji cennika.

SectionType

Typ sekcji.

Wartości w polu enum
SECTION_TYPE_UNSPECIFIED Nie określono.
FOOD Sekcja zawiera produkty reprezentujące jedzenie.
SERVICES Sekcja zawiera elementy reprezentujące usługi.

Element

Jeden element listy. Każda wersja produktu z cennika powinna mieć własny produkt z własnymi danymi o cenie.

Zapis JSON
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Pola
itemId

string

To pole jest wymagane. Identyfikator produktu. Identyfikatory cen, sekcji i produktów nie mogą się powtarzać w tej lokalizacji.

labels[]

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. Wymagany jest co najmniej jeden zestaw etykiet.

price

object (Money)

Opcjonalnie. Cena produktu.

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.

Profil

Wszystkie informacje związane z profilem lokalizacji.

Zapis JSON
{
  "description": string
}
Pola
description

string

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
{
  "parentChain": string
}
Pola
parentChain

string

Nazwa zasobu sieci, do której należy ta lokalizacja. How to find Chain ID

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.

Metody

associate

Przypisuje lokalizację do identyfikatora miejsca.

batchGet

Pobiera wszystkie lokalizacje określone na danym koncie.

batchGetReviews

Zwraca podzieloną na strony listę opinii dla wszystkich określonych lokalizacji.

clearAssociation

Usuwa powiązanie między lokalizacją a jej identyfikatorem miejsca.

create

Tworzy nowy element location należący do określonego konta i zwraca go.

delete

Usuwa lokalizację.

fetchVerificationOptions

Raportuje wszystkie kwalifikujące się opcje weryfikacji dla lokalizacji w określonym języku.

findMatches

Znajduje wszystkie możliwe lokalizacje pasujące do określonej lokalizacji.

get

Pobiera określoną lokalizację.

getFoodMenus

Zwraca menu potraw z określonej lokalizacji.

getGoogleUpdated

Pobiera zaktualizowaną przez Google wersję określonej lokalizacji.

getHealthProviderAttributes

Zwraca atrybuty podmiotu medycznego dla określonej lokalizacji.

getServiceList

Pobierz określoną listę usług dla lokalizacji.

list

Zawiera listę lokalizacji określonego konta.

patch

Aktualizuje określoną lokalizację.

reportInsights

Zwraca raport zawierający statystyki dotyczące co najmniej jednego rodzaju danych według lokalizacji.

transfer
(deprecated)

Przenosi lokalizację z konta należącego do użytkownika na inne konto, którym administruje ten sam użytkownik.

updateFoodMenus

Aktualizuje menu potraw w konkretnej lokalizacji.

updateHealthProviderAttributes

Aktualizuje atrybuty dostawcy zdrowia dla konkretnej lokalizacji.

updateServiceList

Aktualizuje określoną listę usług lokalizacji.

verify

Rozpoczyna proces weryfikacji lokalizacji.