REST Resource: 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,
  "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

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

string

Opcjonalnie: Zewnętrzny identyfikator lokalizacji, który musi być niepowtarzalny w obrębie danego konta. W ten sposób możemy powiązać lokalizację z własnymi danymi.
title

string

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

object (PhoneNumbers)

Opcjonalnie: różne numery telefonów, za pomocą których klienci mogą kontaktować się z firmą.
categories

object (Categories)

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

object (PostalAddress)

Opcjonalnie: 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. To pole należy ustawiać tylko dla firm, które mają sklep. To pole nie powinno być ustawione dla lokalizacji typu CUSTOMER_LOCATION_ONLY, ale jeśli jest ustawione, wszystkie podane wartości będą odrzucane.
websiteUri

string

Opcjonalnie: 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)

Opcjonalnie: Godziny pracy firmy.
specialHours

object (SpecialHours)

Opcjonalnie: Niestandardowe godziny otwarcia firmy. Godziny otwarcia zwykle obejmują dni wolne od pracy, a czasami poza standardowymi godzinami pracy. Zastępują one standardowe godziny otwarcia. Nie można ustawić tego pola bez zwykłych 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, w tym polu opisano obsługiwane przez nią obszary.
labels[]

string

Opcjonalnie: 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. Każda etykieta musi zawierać od 1 do 255 znaków.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Opcjonalnie: Dodatkowe informacje w AdWords.
latlng

object (LatLng)

Opcjonalnie: 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 w Google. To pole mogą aktualizować tylko zatwierdzeni klienci.
openInfo

object (OpenInfo)

Opcjonalnie: Flaga wskazująca, czy dana lokalizacja jest obecnie otwarta dla firm.
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 wyjątkową historię o Twojej firmie i jej ofercie.

To pole jest wymagane w przypadku wszystkich kategorii z wyjątkiem kategorii noclegów (np. hotele, motele, zajazdy).
relationshipData

object (RelationshipData)

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

object (MoreHours)

Opcjonalnie: Więcej godzin dla różnych działów firmy lub dla poszczególnych 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 elementy usługi są automatycznie usuwane.

Metody

delete

 Usuwa lokalizację.

get

 Zwraca podaną lokalizację.

getAttributes

 Przeszukuje wszystkie atrybuty ustawione dla danej lokalizacji.

getGoogleUpdated

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

patch

 Aktualizuje podaną lokalizację.

updateAttributes

 Aktualizowanie atrybutów danej lokalizacji.