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 dla tej lokalizacji w formularzu: 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 produktach lub usługach, lokalizacji, adresu, wskazówek dojazdu ani informacji o tym, że firma znajduje się w innym obiekcie (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ę.

getExtended

 Zwraca określoną lokalizację z rozszerzonymi metadanymi.

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.