REST Resource: locations

Zasób: lokalizacja

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

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

string

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

string

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

string

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

string

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

object (PhoneNumbers)

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

object (Categories)

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

object (PostalAddress)

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

string

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

object (BusinessHours)

Opcjonalnie: Godziny otwarcia firmy.
specialHours

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

string

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

object (AdWordsLocationExtensions)

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

object (LatLng)

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

object (OpenInfo)

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

object (Metadata)

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

object (Profile)

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

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

object (RelationshipData)

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

object (MoreHours)

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

object (ServiceItem)

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

Metody

delete

 Usuwa lokalizację.

get

 Zwraca określoną lokalizację zgodnie z ostatnim ustawieniem sprzedawcy.

getAttributes

 Pobiera atrybuty lokalizacji ostatnio ustawione przez sprzedawcę.

getGoogleUpdated

 Zwraca określoną lokalizację w postaci, w jakiej jest ona widoczna w Mapach Google i wyszukiwarce.

patch

 Aktualizuje określoną lokalizację.

updateAttributes

 Zaktualizuj atrybuty danej lokalizacji.