REST Resource: accounts.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)

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

PhoneNumbers

Номера телефонов компании. При обновлении необходимо задать оба поля. Клиенты не могут обновлять только основные или дополнительные номера телефонов с помощью маски обновления. Рекомендуется использовать международный формат, например +1 415 555 0132. Подробнее: https://developers.google.com/style/phone-numbers#international-phone-numbers).

JSON-представление 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
Поля
primaryPhone

string

Обязательно. Номер телефона, по которому можно связаться с конкретным адресом компании напрямую. По возможности используйте местный номер телефона вместо централизованного номера горячей линии кол-центра.
additionalPhones[]

string

Необязательное поле. Один или два дополнительных номера телефона (мобильного или стационарного, не факс), по которым можно связаться с представителями вашей компании.

Категории

Набор категорий, описывающих компанию. При обновлении необходимо задать оба поля. Клиентам запрещено обновлять основные или дополнительные категории по отдельности с помощью маски обновления.

JSON-представление 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Поля
primaryCategory

object (Category)

Обязательно. Категория, которая лучше всего описывает основную деятельность компании по этому адресу.
additionalCategories[]

object (Category)

Необязательное поле. Дополнительные категории, описывающие вашу компанию. Классификация компаний по категориям позволяет потенциальным клиентам легко находить нужные товары и услуги. Следите за точностью указанной информации и опишите сферу деятельности компании, указав как можно меньше категорий. Укажите категории с максимально узким смыслом, которые вам подходят.

Категория

Категория, описывающая, что представляет собой компания (а не то, чем она занимается). Список допустимых идентификаторов категорий и их сопоставление с человекочитаемыми названиями можно найти в categories.list.

JSON-представление 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Поля
name

string

Обязательно. Постоянный идентификатор (предоставляется Google) для этой категории. Значение необходимо указывать при изменении категории (при создании или обновлении адреса).
displayName

string

Только для вывода. Человекочитаемое название категории. Это значение задается при считывании местоположения. При изменении местоположения необходимо задать category_id.
serviceTypes[]

object (ServiceType)

Только для вывода. Список всех типов услуг, доступных для этого вида деятельности.
moreHoursTypes[]

object (MoreHoursType)

Только для вывода. Другие типы часов работы, доступные для этого вида деятельности.

ServiceType

Сообщение с описанием типа услуг, которые предлагает компания.

JSON-представление 
{
  "serviceTypeId": string,
  "displayName": string
}
Поля
serviceTypeId

string

Только для вывода. Постоянный идентификатор (предоставляется Google) для этого типа услуг.
displayName

string

Только для вывода. Человекочитаемое отображаемое название типа услуги.

MoreHoursType

Дополнительные часы работы, которые может предлагать компания, помимо обычных.

JSON-представление 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Поля
hoursTypeId

string

Только для вывода. Постоянный идентификатор, предоставленный Google для этого типа часов работы.
displayName

string

Только для вывода. Человекочитаемое отображаемое название типа часов работы на английском языке.
localizedDisplayName

string

Только для вывода. Человекочитаемое локализованное отображаемое название типа графика работы.

PostalAddress

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

Обычно адрес создается на основе данных, введенных пользователем или импортированных из существующих источников, в зависимости от типа процесса.

Советы по вводу и изменению адреса:

  • Используйте виджет адреса, поддерживающий интернационализацию, например https://github.com/google/libaddressinput.
  • Пользователям не должны показываться элементы интерфейса для ввода или редактирования полей, которые не используются в их стране.

Подробнее о том, как использовать эту схему, читайте на странице https://support.google.com/business/answer/6397478.

JSON-представление 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Поля
revision

integer

Версия схемы PostalAddress. Необходимо указать значение 0, которое соответствует последней версии.

Все новые версии должны быть обратно совместимы со старыми.
regionCode

string

Обязательно. Идентификатор CLDR для страны или региона, где находится адрес. Это значение не определяется автоматически, и пользователь должен убедиться, что оно указано правильно. Подробную информацию можно найти на страницах https://cldr.unicode.org/ и https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Пример: CH для Швейцарии.
languageCode

string

Необязательное поле. Код языка по стандарту BCP-47 для содержимого этого адреса (если известен). Часто это язык интерфейса формы ввода или один из языков, используемых в стране/регионе адреса, или их транслитерированные эквиваленты. Это может повлиять на форматирование в некоторых странах, но не критично для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

Если это значение неизвестно, его следует опустить (а не указывать возможно неверное значение по умолчанию).

Примеры: zh-Hant, ja, ja-Latn, en.
postalCode

string

Необязательное поле. Почтовый индекс. Почтовые индексы используются не во всех странах, но там, где они есть, может потребоваться дополнительная проверка других частей адреса (например, штата или почтового индекса в США).
sortingCode

string

Необязательное поле. Дополнительный код банка, зависящий от страны. В большинстве регионов не используется. В качестве значения используется либо строка, например CEDEX, за которой может следовать число (например, CEDEX 7), либо просто число, представляющее код сектора (Ямайка), индикатор зоны доставки (Малави) или индикатор почтового отделения (Кот-д'Ивуар).
administrativeArea

string

Необязательное поле. Высшая административная единица для почтовых адресов в стране или регионе. Например, это может быть штат, провинция, область или префектура. Для Испании это провинция, а не автономное сообщество (например, "Барселона", а не "Каталония"). Во многих странах административный район не указывается в почтовых адресах. Например, в Швейцарии это поле должно оставаться пустым.
locality

string

Необязательное поле. Обычно это часть адреса, определяющая город. Примеры: город в США, коммуна в Италии, город с почтовым отделением в Великобритании. В регионах, где населенные пункты не имеют четких границ или не вписываются в эту структуру, оставьте поле locality пустым и используйте поле addressLines.
sublocality

string

Необязательное поле. Район. Например, это может быть район или округ.
addressLines[]

string

Неструктурированные строки адреса, описывающие нижние уровни адреса.

Поскольку значения в файле addressLines не содержат информации о типе и иногда могут содержать несколько значений в одном поле (например, "Austin, TX"), важно, чтобы порядок строк был понятным. Строки адреса должны быть указаны в порядке, принятом в стране или регионе, где он находится. В странах, где порядок может быть разным (например, в Японии), address_language используется для явного указания (например, "ja" для порядка от большего к меньшему и "ja-Latn" или "en" для порядка от меньшего к большему). Таким образом, наиболее точная строка адреса может быть выбрана на основе языка.

Минимально допустимое структурное представление адреса состоит из элемента regionCode, а вся остальная информация помещается в элемент addressLines. Такой адрес можно было бы отформатировать очень приблизительно без геокодирования, но никакие семантические рассуждения не могли бы быть сделаны в отношении любого из компонентов адреса, пока он не был бы хотя бы частично разрешен.

Если у вас есть только неструктурированные адреса, рекомендуем создать адрес, содержащий только regionCode и addressLines, а затем выполнить геокодирование. Это лучше, чем пытаться угадать, какие части адреса относятся к населенным пунктам или административным районам.
recipients[]

string

Необязательное поле. Получатель по адресу. В некоторых случаях это поле может содержать многострочную информацию. Например, в ней может быть указано, кому передать посылку.
organization

string

Необязательное поле. Название организации по указанному адресу.

BusinessHours

Периоды времени, в которые компания открыта. Содержит набор экземпляров [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

JSON-представление 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Поля
periods[]

object (TimePeriod)

Обязательно. Часы работы компании. Каждый период представляет собой диапазон часов, в течение которых местоположение открыто в течение недели.

TimePeriod

Представляет собой период времени, в течение которого компания открыта, начиная с указанного дня/времени открытия и заканчивая указанным днем/временем закрытия. Время закрытия должно быть позже времени открытия, например в тот же день или на следующий.

JSON-представление 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Поля
openDay

enum (DayOfWeek)

Обязательно. Указывает day of the week, с которого начинается этот период.
openTime

object (TimeOfDay)

Обязательно. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Примечание. При сопоставлении JSON в Proto3 нулевые значения по умолчанию (00:00) опускаются, в результате чего для openTime получается {}.
closeDay

enum (DayOfWeek)

Обязательно. Указывает day of the week, когда заканчивается этот период.
closeTime

object (TimeOfDay)

Обязательно. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Примечание. В сопоставлении JSON Proto3 нулевые значения по умолчанию (00:00) опускаются, в результате чего для closeTime получается {}.

День недели

Представляет день недели.

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Tuesday (вторник)
WEDNESDAY Wednesday (среда)
THURSDAY Thursday (четверг)
FRIDAY Friday (пятница)
SATURDAY Saturday (суббота)
SUNDAY Воскресенье

TimeOfDay

Представляет время суток. Дата и часовой пояс либо не имеют значения, либо указаны в другом месте. В API могут быть разрешены секунды координации. Похожие типы: google.type.Date и google.protobuf.Timestamp.

JSON-представление 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Поля
hours

integer

Часы в 24-часовом формате. Значение должно быть больше или равно 0 и обычно меньше или равно 23. В API допустимо значение "24:00:00" для таких сценариев, как время закрытия компании.
minutes

integer

Минуты часа. Значение должно быть больше или равно 0 и меньше или равно 59.
seconds

integer

Секунды. Значение должно быть больше или равно 0 и меньше или равно 59. В API допустимо значение "60", если разрешены секунды координации.
nanos

integer

Доли секунды в наносекундах. Значение должно быть больше или равно 0 и меньше или равно 999 999 999.

SpecialHours

Представляет собой набор периодов времени, когда часы работы адреса отличаются от обычных часов работы.

JSON-представление 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Поля
specialHourPeriods[]

object (SpecialHourPeriod)

Обязательно. Список исключений из обычного графика работы компании.

SpecialHourPeriod

Представляет собой один период времени, когда часы работы адреса отличаются от обычных часов работы. Период измененного графика должен быть меньше 24 часов. Значения openTime и startDate должны предшествовать значениям closeTime и endDate. closeTime и endDate могут продлеваться до 11:59 дня, следующего за указанной startDate. Например, допустимы следующие входные данные:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

Недопустимые входные данные:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON-представление 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Поля
startDate

object (Date)

Обязательно. Дата начала периода с измененным графиком работы.
openTime

object (TimeOfDay)

Необязательное поле. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Обязательно, если для свойства closed задано значение false.
endDate

object (Date)

Необязательное поле. Дата окончания периода, в течение которого действует измененный график. Если поле endDate не заполнено, по умолчанию используется дата, указанная в поле startDate. Если это поле заполнено, то указанная в нем дата должна совпадать с датой startDate или быть не более чем на один день позже нее.
closeTime

object (TimeOfDay)

Необязательное поле. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Обязательно, если для свойства closed задано значение false.
closed

boolean

Необязательное поле. Если указано значение true, то endDate, openTime и closeTime игнорируются, а дата, указанная в startDate, считается днем, когда адрес закрыт.

Дата

Представляет полную или частичную календарную дату, например день рождения. Время суток и часовой пояс либо указаны в другом месте, либо не имеют значения. Дата указывается по григорианскому календарю. Это может быть:

  • Полная дата с ненулевыми значениями года, месяца и дня.
  • Месяц и день с нулевым годом (например, годовщина).
  • Год без указания месяца и дня.
  • Год и месяц с нулевым днем (например, дата окончания срока действия кредитной карты).

Связанные типы:

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год. Допустимые значения: от 1 до 9999. Чтобы указать дату без года, введите 0.
month

integer

Месяц года. Должно быть от 1 до 12 или 0, чтобы указать год без месяца и дня.
day

integer

День месяца. Должно быть от 1 до 31 и соответствовать году и месяцу или быть равно 0, чтобы указать только год или год и месяц, когда день не имеет значения.

ServiceAreaBusiness

Компании, обслуживающие определенную территорию, предоставляют услуги по адресу клиента (например, слесари или сантехники).

JSON-представление 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Поля
businessType

enum (BusinessType)

Обязательно. Указывает [тип] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] компании, обслуживающей определенную территорию.
places

object (Places)

Необязательное поле. Территория обслуживания компании, определенная набором мест.
regionCode

string

Не меняется. Код региона CLDR для страны или региона, где находится компания, обслуживающая определенную территорию. Подробную информацию можно найти на страницах http://cldr.unicode.org/ и http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Пример: CH для Швейцарии.

Это поле обязательно для компаний типа CUSTOMER_LOCATION_ONLY и игнорируется в остальных случаях.

Регион, указанный здесь, может отличаться от регионов, которые обслуживает эта компания (например, компании, обслуживающие территорию, могут предоставлять услуги в регионах, отличных от того, в котором они расположены).

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

BusinessType

Указывает, предлагает ли компания услуги только на территории клиента (например, эвакуатор) или как по адресу, так и на территории клиента (например, пиццерия с обеденной зоной, которая также доставляет пиццу клиентам).

Перечисления
BUSINESS_TYPE_UNSPECIFIED Только для вывода. Не указано.
CUSTOMER_LOCATION_ONLY Компания обслуживает только определенную территорию (не по адресу компании). Если тип компании меняется с CUSTOMER_AND_BUSINESS_LOCATION на CUSTOMER_LOCATION_ONLY, то при обновлении адреса необходимо включить маску поля storefrontAddress и оставить поле пустым.
CUSTOMER_AND_BUSINESS_LOCATION Услуги предоставляются по адресу компании и в окрестностях.

Places

Определяет объединение областей, представленных набором мест.

JSON-представление 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Поля
placeInfos[]

object (PlaceInfo)

Необязательное поле. Области, представленные идентификаторами мест. Максимальное количество мест – 20.

PlaceInfo

Определяет область, представленную идентификатором места.

JSON-представление 
{
  "placeName": string,
  "placeId": string
}
Поля
placeName

string

Обязательно. Локализованное название места. например Scottsdale, AZ (2-е издание).
placeId

string

Обязательно. Идентификатор места. Должен соответствовать региону. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

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

JSON-представление 
{
  "adPhone": string
}
Поля
adPhone

string

Обязательно. Альтернативный номер телефона, который будет показываться в адресах AdWords вместо основного номера телефона.

LatLng

Объект, содержащий географические координаты в виде значений широты и долготы. Это выражается в виде пары значений с плавающей запятой (double), представляющих градусы широты и градусы долготы. Если не указано иное, координаты задаются в системе WGS84. Также они должны попадать в нормализованные диапазоны значений.

JSON-представление 
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Градусная мера широты. Должна попадать в диапазон [-90,0, +90,0].
longitude

number

Градусная мера долготы. Должна попадать в диапазон [-180,0, +180,0].

OpenInfo

Информация о статусе компании.

JSON-представление 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Поля
status

enum (OpenForBusiness)

Обязательно. Указывает, работает ли компания по определенному адресу. По умолчанию все местоположения открыты, если не указано иное.
canReopen

boolean

Только для вывода. Указывает, можно ли снова открыть компанию.
openingDate

object (Date)

Необязательное поле. Дата, когда адрес был впервые открыт. Если точный день неизвестен, можно указать только месяц и год. Дата должна быть в прошлом или не более чем через год в будущем.

OpenForBusiness

Указывает статус адреса.

Перечисления
OPEN_FOR_BUSINESS_UNSPECIFIED Не указано.
OPEN Указывает, что местоположение открыто.
CLOSED_PERMANENTLY Указывает, что адрес закрыт навсегда.
CLOSED_TEMPORARILY Указывает, что место временно закрыто.

Метаданные

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

JSON-представление 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
Поля
hasGoogleUpdated

boolean

Только для вывода. Указывает, есть ли для идентификатора места, связанного с этим адресом, обновления, которые клиент должен принять или отклонить. Если это логическое значение задано, вызовите метод getGoogleUpdated, чтобы найти информацию, которую нужно подтвердить.
hasPendingEdits

boolean

Только для вывода. Указывает, находятся ли свойства адреса на проверке.
canDelete

boolean

Только для вывода. Указывает, можно ли удалить местоположение с помощью API.
canOperateLocalPost
(deprecated)

boolean

Только для вывода. Поддержка прекращена. Это поле больше не заполняется и будет удалено в одной из следующих версий.
canModifyServiceList

boolean

Только для вывода. Указывает, можно ли изменить список услуг в данных о компании.
canHaveFoodMenus

boolean

Только для вывода. Указывает, можно ли добавить меню в данные о компании.
canOperateHealthData

boolean

Только для вывода. Указывает, может ли местоположение работать с данными о здоровье.
canOperateLodgingData

boolean

Только для вывода. Указывает, может ли местоположение работать с данными о жилье.
placeId

string

Только для вывода. Если адрес показывается в Google Картах, поле соответствует идентификатору места для адреса. Этот идентификатор можно использовать в различных Places API.

Это поле можно задать при вызовах Create, но не Update.
duplicateLocation

string

Только для вывода. Ресурс адреса, который дублирует этот адрес.
mapsUri

string

Только для вывода. Ссылка на местоположение на Картах.
newReviewUri

string

Только для вывода. Ссылка на страницу в Google Поиске, где клиент может оставить отзыв об адресе.
canHaveBusinessCalls

boolean

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

boolean

Только для вывода. Указывает, есть ли у информации о компании статус управления продавцом. Если возвращается значение false, вызовите метод locations.getVoiceOfMerchantState, чтобы узнать, почему у продавца нет права на управление.
isParticularlyPersonalPlace

boolean

Только для вывода. Указывает, классифицируется ли местоположение как особо конфиденциальное место. Это значит, что на функции истории местоположений наложены ограничения. Если вы считаете, что произошла ошибка, ознакомьтесь со статьей Справочного центра.

Профиль

Вся информация, относящаяся к профилю адреса.

JSON-представление 
{
  "description": string
}
Поля
description

string

Обязательно. Описание места, которое вы добавили сами и которое никто не может изменить.

RelationshipData

Информация обо всех родительских и дочерних местоположениях, связанных с этим.

JSON-представление 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Поля
parentLocation

object (RelevantLocation)

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

object (RelevantLocation)

Необязательное поле. Список дочерних местоположений, с которыми связано это местоположение.
parentChain

string

Необязательное поле. Название ресурса сети, к которой относится этот адрес. [Как найти идентификатор сети] [Locations.SearchChains]

RelevantLocation

Сведения о других адресах, которые связаны с этим. Отношение может быть DEPARTMENT_OF или INDEPENDENT_ESTABLISHMENT_OF, а указанное здесь местоположение может быть с любой стороны (родительское/дочернее) местоположения.

JSON-представление 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Поля
placeId

string

Обязательно. Укажите местоположение, которое находится на другой стороне отношения, по его идентификатору placeID.
relationType

enum (RelationType)

Обязательно. Тип связи.

RelationType

Тип отношений, которые нужно указать.

Перечисления
RELATION_TYPE_UNSPECIFIED Тип не указан.
DEPARTMENT_OF Это связь между двумя адресами, которые находятся в одном физическом месте, принадлежат одному бренду, руководству или организации, но имеют разные ключевые атрибуты, например часы работы или номера телефонов. Например, аптека Costco Pharmacy – это отдел в магазине Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN Это относится к случаям, когда два заведения разных компаний находятся в одном и том же месте (например, Starbucks в Safeway или магазины в торговом центре).

MoreHours

Периоды времени, в течение которых адрес открыт для определенных видов деятельности.

JSON-представление 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Поля
hoursTypeId

string

Обязательно. Тип графика работы. Чтобы получить типы часов работы, поддерживаемые для категорий адресов, клиенты должны вызвать {#link businessCategories:BatchGet}.
periods[]

object (TimePeriod)

Обязательно. Часы работы этого места. Каждый период представляет собой диапазон часов, когда местоположение открыто в течение недели.

ServiceItem

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

JSON-представление 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
Поля
price

object (Money)

Необязательное поле. Цена услуги. Рекомендуем указывать currencyCode и units, когда вы добавляете цену. Она будет считаться фиксированной ценой за услугу.
Всегда должно быть задано одно из следующих полей: Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
structuredServiceItem

object (StructuredServiceItem)

Необязательное поле. Это поле будет задано в случае структурированных данных об услугах.
freeFormServiceItem

object (FreeFormServiceItem)

Необязательное поле. Это поле будет заполнено в случае данных об услугах в свободной форме.
Конец взаимоисключающих полей.

StructuredServiceItem

Структурированная услуга, предлагаемая продавцом. Пример: toilet_installation.

JSON-представление 
{
  "serviceTypeId": string,
  "description": string
}
Поля
serviceTypeId

string

Обязательно. Поле serviceTypeId содержит уникальный идентификатор, предоставленный Google, который можно найти в файле ServiceType. Эта информация предоставляется сервисом RPC categories.batchGet.
description

string

Необязательное поле. Описание структурированной услуги. Ограничение на количество символов – 300.

FreeFormServiceItem

Представляет услугу, предлагаемую продавцом, в свободной форме. Это сервисы, которые не представлены в структурированных данных. Продавец вручную вводит названия таких сервисов, используя интерфейс geomerchant.

JSON-представление 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Поля
category

string

Обязательно. Это поле содержит название категории (т.е. ее постоянный идентификатор). Значения category и serviceTypeId должны соответствовать возможным комбинациям, указанным в сообщении Category.
label

object (Label)

Обязательно. Ярлыки с языковыми тегами для объекта. Рекомендуем использовать названия длиной не более 140 символов и описания длиной не более 250 символов. Это поле следует заполнять, только если входные данные представляют собой пользовательский элемент сервиса. Стандартизированные типы услуг следует обновлять с помощью serviceTypeId.

Ярлык

Ярлык, который будет использоваться при показе прейскуранта, раздела или позиции.

JSON-представление 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Поля
displayName

string

Обязательно. Отображаемое название прейскуранта, раздела или позиции.
description

string

Необязательное поле. Описание прейскуранта, раздела или позиции.
languageCode

string

Необязательное поле. Код языка по стандарту BCP-47, к которому относятся эти строки. Для каждого языка можно задать только один набор ярлыков.

Деньги

Представляет денежную сумму с указанием валюты.

JSON-представление 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Поля
currencyCode

string

Трехбуквенный код валюты по стандарту ISO 4217.
units

string (int64 format)

Целые единицы суммы. Например, если currencyCode – это "USD", то одна единица равна одному доллару США.
nanos

integer

Количество нано-единиц (10^-9) суммы. Значение должно быть в диапазоне от -999 999 999 до +999 999 999 включительно. Если значение units положительное, то значение nanos должно быть положительным или нулевым. Если значение units нулевое, то значение nanos может быть положительным, отрицательным или нулевым. Если значение units отрицательное, то значение nanos должно быть отрицательным или нулевым. Например, -1,75 доллара США будет представлено как units=-1 и nanos=-750 000 000.

Методы

create

 Создает новый адрес, который будет принадлежать вошедшему в аккаунт пользователю.

list

 Вы можете получить список адресов для определенного аккаунта.