REST Resource: locations

Ресурс: местоположение

местоположение; Подробное описание этих полей можно найти в статье Справочного центра, а список допустимых видов деятельности – в конечной точке категории.

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)
    }
  ]
}
Поля
name

string

Идентификатор. Идентификатор Google для этого местоположения в форме: locations/{locationId}.
languageCode

string

Не меняется. Язык местоположения. Задается при создании и не может быть изменено.
storeCode

string

Необязательное поле. Внешний идентификатор адреса. Должен быть уникальным в рамках аккаунта. Это позволяет сопоставить адрес с вашими собственными записями.
title

string

Обязательно. Название адреса должно соответствовать фактическому названию компании, которое используется на вывеске, сайте и в документах и известно клиентам. Любую дополнительную информацию, если она уместна, можно указать в других полях ресурса (например, Address, Categories). Не добавляйте в название лишнюю информацию (например, вместо "Google Inc. – штаб-квартира в Маунтин-Вью" лучше написать "Google"). Не добавляйте рекламные слоганы, коды магазинов, специальные символы, часы работы, статус "открыто/закрыто", номера телефонов, URL сайтов, информацию о товарах и услугах, адреса, маршруты и сведения о местоположении (например, "Банкомат Сбербанка в магазине "Пятерочка").
phoneNumbers

object (PhoneNumbers)

Необязательное поле. Номера телефонов, по которым клиенты могут связаться с компанией.
categories

object (Categories)

Необязательное поле. Категории, к которым относится компания.
storefrontAddress

object (PostalAddress)

Необязательное поле. Укажите адрес своей компании как можно точнее и понятнее. Нельзя использовать номер абонентского ящика или адрес почтового ящика, находящегося в другом месте. В настоящее время в адресе можно указать не более пяти значений addressLines. Это поле следует заполнять только для компаний, у которых есть магазин. Для местоположений типа CUSTOMER_LOCATION_ONLY это поле не должно быть заполнено. Если оно заполнено, то указанное значение будет удалено.
websiteUri

string

Необязательное поле. URL сайта компании. Желательно, чтобы это был URL филиала, а не сайт/URL, который представляет бренд или компанию в целом.
regularHours

object (BusinessHours)

Необязательное поле. Часы работы компании.
specialHours

object (SpecialHours)

Необязательное поле. Измененный график работы компании. Обычно это праздничные дни и другие периоды, когда компания не работает. Они заменяют обычные часы работы. Это поле нельзя заполнить, если не указан обычный график работы.
serviceArea

object (ServiceAreaBusiness)

Необязательное поле. Компании, обслуживающие определенную территорию, предоставляют услуги по адресу клиента. Если компания обслуживает определенную территорию, в этом поле указывается ее название.
labels[]

string

Необязательное поле. Набор строк свободного формата, в которые можно добавить теги для компании. Эти ярлыки не видны пользователям. Допустимое количество символов в ярлыке – от 1 до 255.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Необязательное поле. Дополнительная информация, которая показывается в Google Рекламе.
latlng

object (LatLng)

Необязательное поле. Широта и долгота, указанные пользователем. При создании адреса это поле игнорируется, если геокодирование указанного адреса выполнено успешно. Это поле возвращается в GET-запросах, только если значение latlng, указанное пользователем, было принято при создании или latlng обновлено на сайте профиля компании в Google. Это поле могут изменять только одобренные клиенты.
openInfo

object (OpenInfo)

Необязательное поле. Флаг, указывающий, работает ли компания в настоящее время.
metadata

object (Metadata)

Только для вывода. Дополнительная информация, которую пользователь не может изменить.
profile

object (Profile)

Необязательное поле. Расскажите о компании в своем стиле. Поделитесь с пользователями уникальной историей своего бренда, товаров и услуг.

Это поле обязательно для всех категорий, кроме гостиничного бизнеса (например, отелей, мотелей, гостиниц).
relationshipData

object (RelationshipData)

Необязательное поле. Все адреса и сети, связанные с этим.
moreHours[]

object (MoreHours)

Необязательное поле. Дополнительные часы работы для разных отделов или определенных клиентов.
serviceItems[]

object (ServiceItem)

Необязательное поле. Список сервисов, поддерживаемых продавцами. Примеры услуг: стрижка, установка водонагревателя и т. д. Повторяющиеся услуги будут удалены автоматически.

Методы

delete

 Удаляет адрес.

get

 Возвращает указанное местоположение, заданное продавцом.

getAttributes

 Получает атрибуты для адреса, заданные продавцом.

getGoogleUpdated

 Возвращает указанный адрес в том виде, в котором он отображается на Google Картах и в Поиске.

patch

 Обновление указанного адреса.

updateAttributes

 Обновление атрибутов для указанного адреса.