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,
  "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 tej lokalizacji w formacie: accounts/{accountId}/locations/{locationId}

W kontekście dopasowań to pole nie będzie wypełnione.
languageCode

string

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

string

Zewnętrzny identyfikator tej lokalizacji, który musi być unikalny w obrębie danego konta. W ten sposób możemy powiązać lokalizację z własnymi danymi.
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 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”).
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 dwa numery telefonu (komórkowe lub stacjonarne, bez faksu), pod które można zadzwonić do firmy oprócz podstawowego numeru telefonu.
address

object (PostalAddress)

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

object (Category)

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

object (Category)

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

string

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)

Godziny pracy firmy.
specialHours

object (SpecialHours)

Niestandardowe godziny otwarcia firmy. Godziny otwarcia zwykle obejmują dni wolne od pracy, a czasami poza standardowymi godzinami pracy. Zastępują one standardowe 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, w tym polu opisano obsługiwane przez nią obszary.
locationKey

object (LocationKey)

Zbiór kluczy łączących firmę z innymi usługami Google, takimi jak strona Google+ i Miejsca w Mapach Google.
labels[]

string

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

object (AdWordsLocationExtensions)

Dodatkowe informacje w AdWords.
latlng

object (LatLng)

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. Nie można zaktualizować tego pola.
openInfo

object (OpenInfo)

Flaga wskazująca, czy dana lokalizacja jest obecnie otwarta dla firm.
locationState

object (LocationState)

Tylko dane wyjściowe. Zestaw wartości logicznych, które odzwierciedlają 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 dla tej lokalizacji.
profile

object (Profile)

Opisuje Twoją firmę własnymi słowami i przedstawia użytkownikom wyjątkową historię o Twojej firmie i jej ofercie.
relationshipData

object (RelationshipData)

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

object (MoreHours)

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

BusinessHours

Określa okresy, w których dana lokalizacja jest otwarta. Przechowuje kolekcję TimePeriod instancji.

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

object (TimePeriod)

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

enum (DayOfWeek)

Wskazuje, kiedy (day of the week) rozpoczyna się ten okres.
openTime

string

Czas w rozszerzonym formacie ISO 8601 (gg:mm) w ciągu 24 godzin. Prawidłowe wartości to 00:00–24:00, gdzie 24:00 oznacza północ pod koniec określonego pola dnia.
closeDay

enum (DayOfWeek)

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

string

Czas w rozszerzonym formacie ISO 8601 (gg:mm) w ciągu 24 godzin. 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

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)

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

object (Date)

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

string

Czas działania w startDate po otwarciu lokalizacji wyrażony w 24-godzinnym formacie rozszerzonym ISO 8601. (gg:mm) 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 isClosed ma wartość fałsz.
endDate

object (Date)

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

string

Czas zamknięcia lokalizacji w endDate wyrażony w 24-godzinnym formacie ISO 8601. (gg:mm) 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 isClosed ma wartość fałsz.
isClosed

boolean

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.

ServiceAreaBusiness

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

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 identyfikator type firmy działającej na określonym obszarze.
Pole sumy coverageArea. Wskazuje obszar, na którym firma oferuje usługi. coverageArea może mieć tylko jedną z tych wartości:
radius

object (PointRadius)

Tylko dane wyjściowe. Obszar, w którym firma prowadzi działalność w okolicy punktu.
places

object (Places)

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

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).
CUSTOMER_AND_BUSINESS_LOCATION Oferuje usługi pod adresem firmy i w pobliżu.

PointRadius

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

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

object (LatLng)

Długość i szerokość geograficzna, która określa środek obszaru.
radiusKm

number

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

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

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 
{
  "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 kluczowe odwołania do lokalizacji.

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

string

Tylko dane wyjściowe. Jeśli z lokalizacją jest powiązana strona Google+, w tym polu pojawia się identyfikator strony Google+ tej lokalizacji.
placeId

string

Jeśli ta lokalizacja została zweryfikowana i jest połączona z Mapami Google lub jest widoczna w Mapach Google, w tym polu znajduje się identyfikator lokalizacji. Ten identyfikator może być używany w różnych interfejsach API Miejsc.

Jeśli ta lokalizacja nie jest zweryfikowana, to pole może być wypełnione, jeśli została powiązana z miejscem wyświetlanym w Mapach Google.

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

Dodatkowa wartość logiczna explicitNoPlaceId określa, czy nieskonfigurowany identyfikator miejsca jest celowy.
explicitNoPlaceId

boolean

Tylko dane wyjściowe. Wartość true wskazuje, że nieustawiony identyfikator miejsca jest celowy. Różni się to od tego, że nie utworzono jeszcze powiązania.
requestId

string

Tylko dane wyjściowe. Do utworzenia tej lokalizacji użyto: requestId. To 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 w AdWords.

Zapis JSON 
{
  "adPhone": string
}
Pola
adPhone

string

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

OpenInfo

Informacje związane ze stanem otwarcia firmy.

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

enum (OpenForBusiness)

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)

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

LocationState

Zawiera zestaw wartości logicznych, które odzwierciedlają 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, zapoznaj się z tym artykułem w Centrum pomocy.
canUpdate

boolean

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

boolean

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

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja jest 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 miejsca w Mapach Google.
isLocalPostApiDisabled

boolean

Tylko dane wyjściowe. Wskazuje, czy w przypadku tej lokalizacji usługa accounts.locations.localPosts jest wyłączona.
canModifyServiceList

boolean

Tylko dane wyjściowe. Wskazuje, czy strona może modyfikować ServiceList.
canHaveFoodMenus

boolean

Tylko dane wyjściowe. Wskazuje, czy wizytówka kwalifikuje się do menu z jedzeniem.
hasPendingEdits

boolean

Tylko dane wyjściowe. Wskazuje, czy właściwości danej lokalizacji są w stanie oczekiwania na edycję.
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 operować na danych dotyczących zdrowia.
canOperateLodgingData

boolean

Tylko dane wyjściowe. Wskazuje, czy lokalizacja może wykorzystywać dane dotyczące 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ć lub usuwać bez 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 zawartej w tym atrybucie. Należy go użyć do określenia sposobu interpretacji wartości.
values[]

value (Value format)

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

object (RepeatedEnumAttributeValue)

Gdy typem wartości atrybutu jest REPEATED_ENUM, ta wartość zawiera wartość atrybutu, a pozostałe 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 atrybutu z valueType o wartości REPEATED_ENUM. Składa się on z 2 list identyfikatorów wartości: tych, które mają wartość „true” (prawda) i tych, które nie są ustawione (fałsz). Brak wartości są uznawane za nieznane. Musisz podać co najmniej jedną wartość.

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

string

Ustawione wartości typu enum.
unsetValues[]

string

Wartości typu enum, które nie są skonfigurowane.

UrlAttributeValue

Wartości atrybutu z valueType o adresie 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 duplikowanej przez tę lokalizację. Występuje tylko wtedy, gdy locationState.is_duplicate ma wartość true (prawda). Wycofane: nie obsługujemy już szczegółowych informacji o duplikatach.
mapsUrl

string

link do lokalizacji w Mapach,
newReviewUrl

string

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

Duplikuj

Informacje o lokalizacji duplikowanej przez tę lokalizację.

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

string

Nazwa zasobu lokalizacji duplikowanej. To pole jest wypełniane tylko wtedy, gdy uwierzytelniony użytkownik ma prawa dostępu do tej lokalizacji, a lokalizacja nie jest usunięta.
placeId

string

Identyfikator miejsca duplikatu lokalizacji.
access

enum (Access)

Wskazuje, czy użytkownik ma dostęp do duplikatu lokalizacji.

Dostęp

Poziom dostępu użytkownika do duplikatu lokalizacji. Zastępuje ona własność. Należy jej użyć.

Wartości w polu enum
ACCESS_UNSPECIFIED Nie określono.
ACCESS_UNKNOWN Nie udało się określić, czy użytkownik ma dostęp do duplikatu lokalizacji.
ALLOWED Użytkownik ma dostęp do lokalizacji, którą duplikuje.
INSUFFICIENT Użytkownik nie ma dostępu do lokalizacji, którą duplikuje.

PriceList

Wycofane: lista informacji o cenie produktu. Ceny mają strukturę co najmniej 1 cennik, z którego każda zawiera co najmniej 1 sekcję z co najmniej 1 produktem. Na przykład ceny produktów spożywczych mogą przedstawiać menu śniadaniowe, obiadowe i kolacje z sekcjami zawierającymi burgery, steki lub owoce morza.

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

string

Wymagane. Identyfikator cennika. Identyfikatory cen, sekcji i produktów nie mogą być zduplikowane w tej lokalizacji.
labels[]

object (Label)

Wymagane. Etykiety językowe z cennikiem.
sourceUrl

string

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

object (Section)

Wymagane. Sekcje z tym cennikiem. Każdy cennik musi zawierać co najmniej 1 sekcję.

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.

Sekcja

Sekcja cennika zawierająca co najmniej 1 produkt.

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

string

Wymagane. Identyfikator sekcji. Identyfikatory cen, sekcji i produktów nie mogą być zduplikowane w tej lokalizacji.
labels[]

object (Label)

Wymagane. Etykiety językowe sekcji. Długość nazw i opisów sekcji nie powinna przekraczać 140 znaków. Wymagany jest co najmniej 1 zestaw etykiet.
sectionType

enum (SectionType)

Opcjonalnie: Typ sekcji bieżącego cennika. Wartość domyślna to JEDZENIE.
items[]

object (Item)

Produkty zawarte w tej sekcji cennika.

SectionType

Typ sekcji.

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

Element

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

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

string

Wymagane. Identyfikator produktu. Identyfikatory cen, sekcji i produktów nie mogą być zduplikowane w tej lokalizacji.
labels[]

object (Label)

Wymagane. Etykiety językowe z elementem. Zalecamy, aby nazwa produktu miała maksymalnie 140 znaków, a opis – 250 znaków. Wymagany jest co najmniej 1 zestaw etykiet.
price

object (Money)

Opcjonalnie: Cena produktu.

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.

Profil

Wszystkie informacje związane z profilem lokalizacji.

Zapis JSON 
{
  "description": string
}
Pola
description

string

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

string

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

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.

Metody

associate

 Przypisuje lokalizację do identyfikatora miejsca.

batchGet

 Pobiera wszystkie określone lokalizacje z danego konta.

batchGetReviews

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

clearAssociation

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

create

 Tworzy i zwraca nowy plik location, który należy do podanego konta.

delete

 Usuwa lokalizację.

fetchVerificationOptions

 Zgłasza wszystkie opcje weryfikacji dostępne dla danej lokalizacji w wybranym języku.

findMatches

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

get

 Pobiera określoną lokalizację.

getFoodMenus

 Wyświetla menu jedzenia w konkretnej lokalizacji.

getGoogleUpdated

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

getHealthProviderAttributes

 Zwraca atrybuty dostawcy usług medycznych określonej lokalizacji.

getServiceList

 Pobieranie określonej listy usług dla lokalizacji.

list

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

patch

 Aktualizuje podaną 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 zarządza ten sam użytkownik;

updateFoodMenus

 Aktualizuje menu dań w konkretnej lokalizacji.

updateHealthProviderAttributes

 Aktualizuje atrybuty dostawcy usług medycznych określonej lokalizacji.

updateServiceList

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

verify

 Rozpoczyna proces weryfikacji lokalizacji.