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

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

string

Opcjonalnie. 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.
title

string

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

object (PhoneNumbers)

Opcjonalnie. różne numery telefonów, których klienci mogą używać do kontaktowania się z firmą.
categories

object (Categories)

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

object (PostalAddress)

Opcjonalnie. 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. To pole należy ustawiać tylko dla firm, które mają placówkę stacjonarną. To pole nie powinno być ustawione dla lokalizacji typu CUSTOMER_LOCATION_ONLY, ale jeśli jest ustawione, każda podana wartość zostanie odrzucona.
websiteUri

string

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

Opcjonalnie. Godziny otwarcia firmy.
specialHours

object (SpecialHours)

Opcjonalnie. 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. W tym polu nie można ustawić regularnych 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, to pole opisuje obsługiwane przez nią obszary.
labels[]

string

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

object (AdWordsLocationExtensions)

Opcjonalnie. Dodatkowe informacje wyświetlane w AdWords.
latlng

object (LatLng)

Opcjonalnie. 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 w Google. To pole może aktualizować tylko zatwierdzeni klienci.
openInfo

object (OpenInfo)

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

object (Metadata)

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

object (Profile)

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

To pole jest wymagane w przypadku wszystkich kategorii oprócz kategorii zakwaterowania (np. hoteli, moteli, zajazdów).
relationshipData

object (RelationshipData)

Opcjonalnie. Wszystkie powiązane z nią lokalizacje i sieci.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

Opcjonalnie. Lista usług obsługiwanych przez sprzedawców. Może to być np. strzyżenie lub instalacja podgrzewacza wody. Zduplikowane usługi będą usuwane automatycznie.

Metody

delete

 Usuwa lokalizację.

get

 Zwraca określoną lokalizację.

getAttributes

 Wyszukuje wszystkie atrybuty ustawione dla danej lokalizacji.

getGoogleUpdated

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

patch

 Aktualizuje określoną lokalizację.

updateAttributes

 Aktualizowanie atrybutów danej lokalizacji.