- Ресурс: местоположение
- JSON-представление
- PhoneNumbers
- Категории
- Категория
- ServiceType
- MoreHoursType
- BusinessHours
- TimePeriod
- SpecialHours
- SpecialHourPeriod
- ServiceAreaBusiness
- BusinessType
- Места
- PlaceInfo
- AdWordsLocationExtensions
- OpenInfo
- OpenForBusiness
- Метаданные
- Профиль
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Ярлык
- Методы
Ресурс: местоположение
местоположение; Подробное описание этих полей можно найти в статье Справочного центра, а список допустимых видов деятельности – в конечной точке категории.
| JSON-представление |
|---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
| Поля | |
|---|---|
name |
Идентификатор. Идентификатор Google для этого местоположения в форме: |
languageCode |
Не меняется. Язык местоположения. Задается при создании и не может быть изменено. |
storeCode |
Необязательное поле. Внешний идентификатор адреса. Должен быть уникальным в рамках аккаунта. Это позволяет сопоставить адрес с вашими собственными записями. |
title |
Обязательно. Название адреса должно соответствовать фактическому названию компании, которое используется на вывеске, сайте и в документах и известно клиентам. Любую дополнительную информацию, если она уместна, можно указать в других полях ресурса (например, |
phoneNumbers |
Необязательное поле. Номера телефонов, по которым клиенты могут связаться с компанией. |
categories |
Необязательное поле. Категории, к которым относится компания. |
storefrontAddress |
Необязательное поле. Укажите адрес своей компании как можно точнее и понятнее. Нельзя использовать номер абонентского ящика или адрес почтового ящика, находящегося в другом месте. В настоящее время в адресе можно указать не более пяти значений |
websiteUri |
Необязательное поле. URL сайта компании. Желательно, чтобы это был URL филиала, а не сайт/URL, который представляет бренд или компанию в целом. |
regularHours |
Необязательное поле. Часы работы компании. |
specialHours |
Необязательное поле. Измененный график работы компании. Обычно это праздничные дни и другие периоды, когда компания не работает. Они заменяют обычные часы работы. Это поле нельзя заполнить, если не указан обычный график работы. |
serviceArea |
Необязательное поле. Компании, обслуживающие определенную территорию, предоставляют услуги по адресу клиента. Если компания обслуживает определенную территорию, в этом поле указывается ее название. |
labels[] |
Необязательное поле. Набор строк свободного формата, в которые можно добавить теги для компании. Эти ярлыки не видны пользователям. Допустимое количество символов в ярлыке – от 1 до 255. |
adWordsLocationExtensions |
Необязательное поле. Дополнительная информация, которая показывается в Google Рекламе. |
latlng |
Необязательное поле. Широта и долгота, указанные пользователем. При создании адреса это поле игнорируется, если геокодирование указанного адреса выполнено успешно. Это поле возвращается в GET-запросах, только если значение |
openInfo |
Необязательное поле. Флаг, указывающий, работает ли компания в настоящее время. |
metadata |
Только для вывода. Дополнительная информация, которую пользователь не может изменить. |
profile |
Необязательное поле. Расскажите о компании в своем стиле. Поделитесь с пользователями уникальной историей своего бренда, товаров и услуг. Это поле обязательно для всех категорий, кроме гостиничного бизнеса (например, отелей, мотелей, гостиниц). |
relationshipData |
Необязательное поле. Все адреса и сети, связанные с этим. |
moreHours[] |
Необязательное поле. Дополнительные часы работы для разных отделов или определенных клиентов. |
serviceItems[] |
Необязательное поле. Список сервисов, поддерживаемых продавцами. Примеры услуг: стрижка, установка водонагревателя и т. д. Повторяющиеся услуги будут удалены автоматически. |
PhoneNumbers
Номера телефонов компании. При обновлении необходимо задать оба поля. Клиенты не могут обновлять только основные или дополнительные номера телефонов с помощью маски обновления. Рекомендуется использовать международный формат, например +1 415 555 0132. Подробнее: https://developers.google.com/style/phone-numbers#international-phone-numbers).
| JSON-представление |
|---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
| Поля | |
|---|---|
primaryPhone |
Обязательно. Номер телефона, по которому можно связаться с конкретным адресом компании напрямую. По возможности используйте местный номер телефона вместо централизованного номера горячей линии кол-центра. |
additionalPhones[] |
Необязательное поле. Один или два дополнительных номера телефона (мобильного или стационарного, не факс), по которым можно связаться с представителями вашей компании. |
Категории
Набор категорий, описывающих компанию. При обновлении необходимо задать оба поля. Клиентам запрещено обновлять основные или дополнительные категории по отдельности с помощью маски обновления.
| JSON-представление |
|---|
{ "primaryCategory": { object ( |
| Поля | |
|---|---|
primaryCategory |
Обязательно. Категория, которая лучше всего описывает основную деятельность компании по этому адресу. |
additionalCategories[] |
Необязательное поле. Дополнительные категории, описывающие вашу компанию. Классификация компаний по категориям позволяет потенциальным клиентам легко находить нужные товары и услуги. Следите за точностью указанной информации и опишите сферу деятельности компании, указав как можно меньше категорий. Укажите категории с максимально узким смыслом, которые вам подходят. |
Категория
Категория, описывающая, что представляет собой компания (а не то, чем она занимается). Список допустимых идентификаторов категорий и их сопоставление с человекочитаемыми названиями можно найти в categories.list.
| JSON-представление |
|---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
| Поля | |
|---|---|
name |
Обязательно. Постоянный идентификатор (предоставляется Google) для этой категории. Значение необходимо указывать при изменении категории (при создании или обновлении адреса). |
displayName |
Только для вывода. Человекочитаемое название категории. Это значение задается при считывании местоположения. При изменении местоположения необходимо задать |
serviceTypes[] |
Только для вывода. Список всех типов услуг, доступных для этого вида деятельности. |
moreHoursTypes[] |
Только для вывода. Другие типы часов работы, доступные для этого вида деятельности. |
ServiceType
Сообщение с описанием типа услуг, которые предлагает компания.
| JSON-представление |
|---|
{ "serviceTypeId": string, "displayName": string } |
| Поля | |
|---|---|
serviceTypeId |
Только для вывода. Постоянный идентификатор (предоставляется Google) для этого типа услуг. |
displayName |
Только для вывода. Человекочитаемое отображаемое название типа услуги. |
MoreHoursType
Дополнительные часы работы, которые может предлагать компания, помимо обычных.
| JSON-представление |
|---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
| Поля | |
|---|---|
hoursTypeId |
Только для вывода. Постоянный идентификатор, предоставленный Google для этого типа часов работы. |
displayName |
Только для вывода. Человекочитаемое отображаемое название типа часов работы на английском языке. |
localizedDisplayName |
Только для вывода. Человекочитаемое локализованное отображаемое название типа графика работы. |
BusinessHours
Периоды времени, в которые компания открыта. Содержит набор экземпляров [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
| JSON-представление |
|---|
{
"periods": [
{
object ( |
| Поля | |
|---|---|
periods[] |
Обязательно. Часы работы компании. Каждый период представляет собой диапазон часов, когда местоположение открыто в течение недели. |
TimePeriod
Представляет собой период времени, в течение которого компания открыта, начиная с указанного дня/времени открытия и заканчивая указанным днем/временем закрытия. Время закрытия должно быть позже времени открытия, например в тот же день или на следующий.
| JSON-представление |
|---|
{ "openDay": enum ( |
| Поля | |
|---|---|
openDay |
Обязательно. Указывает |
openTime |
Обязательно. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Примечание. При сопоставлении JSON в Proto3 нулевые значения по умолчанию (00:00) опускаются, в результате чего для openTime получается |
closeDay |
Обязательно. Указывает |
closeTime |
Обязательно. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Примечание. В сопоставлении JSON Proto3 нулевые значения по умолчанию (00:00) опускаются, в результате чего для closeTime получается |
SpecialHours
Представляет собой набор периодов времени, когда часы работы адреса отличаются от обычных часов работы.
| JSON-представление |
|---|
{
"specialHourPeriods": [
{
object ( |
| Поля | |
|---|---|
specialHourPeriods[] |
Обязательно. Список исключений из обычного графика работы компании. |
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 ( |
| Поля | |
|---|---|
startDate |
Обязательно. Дата начала периода с измененным графиком работы. |
openTime |
Необязательное поле. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Обязательно, если для свойства |
endDate |
Необязательное поле. Дата окончания периода, в течение которого действует измененный график. Если поле |
closeTime |
Необязательное поле. Допустимые значения: 00:00–24:00, где 24:00 – это полночь в конце указанного дня. Обязательно, если для свойства |
closed |
Необязательное поле. Если указано значение true, то |
ServiceAreaBusiness
Компании, обслуживающие определенную территорию, предоставляют услуги по адресу клиента (например, слесари или сантехники).
| JSON-представление |
|---|
{ "businessType": enum ( |
| Поля | |
|---|---|
businessType |
Обязательно. Указывает [тип] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] компании, обслуживающей определенную территорию. |
places |
Необязательное поле. Территория обслуживания компании, определенная набором мест. |
regionCode |
Не меняется. Код региона 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 ( |
| Поля | |
|---|---|
placeInfos[] |
Необязательное поле. Области, представленные идентификаторами мест. Максимальное количество мест – 20. |
PlaceInfo
Определяет область, представленную идентификатором места.
| JSON-представление |
|---|
{ "placeName": string, "placeId": string } |
| Поля | |
|---|---|
placeName |
Обязательно. Локализованное название места. например |
placeId |
Обязательно. Идентификатор места. Должен соответствовать региону. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
Дополнительная информация, которая показывается в Google Рекламе.
| JSON-представление |
|---|
{ "adPhone": string } |
| Поля | |
|---|---|
adPhone |
Обязательно. Альтернативный номер телефона, который будет показываться в адресах AdWords вместо основного номера телефона. |
OpenInfo
Информация о статусе компании.
| JSON-представление |
|---|
{ "status": enum ( |
| Поля | |
|---|---|
status |
Обязательно. Указывает, работает ли компания по определенному адресу. По умолчанию все местоположения открыты, если не указано иное. |
canReopen |
Только для вывода. Указывает, можно ли снова открыть компанию. |
openingDate |
Необязательное поле. Дата, когда адрес был впервые открыт. Если точный день неизвестен, можно указать только месяц и год. Дата должна быть в прошлом или не более чем через год в будущем. |
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 |
Только для вывода. Указывает, есть ли для идентификатора места, связанного с этим адресом, обновления, которые клиент должен принять или отклонить. Если это логическое значение задано, вызовите метод |
hasPendingEdits |
Только для вывода. Указывает, находятся ли свойства адреса на проверке. |
canDelete |
Только для вывода. Указывает, можно ли удалить местоположение с помощью API. |
canOperateLocalPost |
Только для вывода. Поддержка прекращена. Это поле больше не заполняется и будет удалено в одной из следующих версий. |
canModifyServiceList |
Только для вывода. Указывает, можно ли изменить список услуг в данных о компании. |
canHaveFoodMenus |
Только для вывода. Указывает, можно ли добавить меню в данные о компании. |
canOperateHealthData |
Только для вывода. Указывает, может ли местоположение работать с данными о здоровье. |
canOperateLodgingData |
Только для вывода. Указывает, может ли местоположение работать с данными о жилье. |
placeId |
Только для вывода. Если адрес показывается в Google Картах, поле соответствует идентификатору места для адреса. Этот идентификатор можно использовать в различных Places API. Это поле можно задать при вызовах Create, но не Update. |
duplicateLocation |
Только для вывода. Ресурс адреса, который дублирует этот адрес. |
mapsUri |
Только для вывода. Ссылка на местоположение на Картах. |
newReviewUri |
Только для вывода. Ссылка на страницу в Google Поиске, где клиент может оставить отзыв об адресе. |
canHaveBusinessCalls |
Только для вывода. Указывает, можно ли звонить по номеру телефона, указанному в информации о компании. |
hasVoiceOfMerchant |
Только для вывода. Указывает, есть ли у информации о компании статус управления продавцом. Если возвращается значение false, вызовите метод locations.getVoiceOfMerchantState, чтобы узнать, почему у продавца нет права на управление. |
isParticularlyPersonalPlace |
Только для вывода. Указывает, классифицируется ли местоположение как особо конфиденциальное место. Это значит, что на функции истории местоположений наложены ограничения. Если вы считаете, что произошла ошибка, ознакомьтесь со статьей Справочного центра. |
Профиль
Вся информация, относящаяся к профилю адреса.
| JSON-представление |
|---|
{ "description": string } |
| Поля | |
|---|---|
description |
Обязательно. Описание места, которое вы добавили сами и которое никто не может изменить. |
RelationshipData
Информация обо всех родительских и дочерних местоположениях, связанных с этим.
| JSON-представление |
|---|
{ "parentLocation": { object ( |
| Поля | |
|---|---|
parentLocation |
Необязательное поле. Родительское местоположение, с которым связано это местоположение. |
childrenLocations[] |
Необязательное поле. Список дочерних местоположений, с которыми связано это местоположение. |
parentChain |
Необязательное поле. Название ресурса сети, к которой относится этот адрес. [Как найти идентификатор сети] [Locations.SearchChains] |
RelevantLocation
Сведения о других адресах, которые связаны с этим. Отношение может быть DEPARTMENT_OF или INDEPENDENT_ESTABLISHMENT_OF, а указанное здесь местоположение может быть с любой стороны (родительское/дочернее) местоположения.
| JSON-представление |
|---|
{
"placeId": string,
"relationType": enum ( |
| Поля | |
|---|---|
placeId |
Обязательно. Укажите местоположение, которое находится на другой стороне отношения, по его идентификатору placeID. |
relationType |
Обязательно. Тип связи. |
RelationType
Тип отношений, которые нужно указать.
| Перечисления | |
|---|---|
RELATION_TYPE_UNSPECIFIED |
Тип не указан. |
DEPARTMENT_OF |
Это связь между двумя адресами, которые находятся в одном физическом месте, принадлежат одному бренду, руководству или организации, но имеют разные ключевые атрибуты, например часы работы или номера телефонов. Например, аптека Costco Pharmacy – это отдел в магазине Costco Wholesale. |
INDEPENDENT_ESTABLISHMENT_IN |
Это относится к случаям, когда два заведения разных компаний находятся в одном и том же месте (например, Starbucks в Safeway или магазины в торговом центре). |
MoreHours
Периоды времени, в течение которых адрес открыт для определенных видов деятельности.
| JSON-представление |
|---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
| Поля | |
|---|---|
hoursTypeId |
Обязательно. Тип графика работы. Чтобы получить типы часов работы, поддерживаемые для категорий адресов, клиенты должны вызвать {#link businessCategories:BatchGet}. |
periods[] |
Обязательно. Часы работы этого места. Каждый период представляет собой диапазон часов, когда местоположение открыто в течение недели. |
ServiceItem
Сообщение с описанием одной услуги. Оно используется для описания типа услуг, которые предоставляет продавец. Например, стрижка может быть услугой.
| JSON-представление |
|---|
{ "price": { object ( |
| Поля | |
|---|---|
price |
Необязательное поле. Цена услуги. Рекомендуем указывать currencyCode и units, когда вы добавляете цену. Она будет считаться фиксированной ценой за услугу. |
| Всегда должно быть задано одно из следующих полей: Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей: | |
structuredServiceItem |
Необязательное поле. Это поле будет задано в случае структурированных данных об услугах. |
freeFormServiceItem |
Необязательное поле. Это поле будет заполнено в случае данных об услугах в свободной форме. |
| Конец взаимоисключающих полей. | |
StructuredServiceItem
Структурированная услуга, предлагаемая продавцом. Пример: toilet_installation.
| JSON-представление |
|---|
{ "serviceTypeId": string, "description": string } |
| Поля | |
|---|---|
serviceTypeId |
Обязательно. Поле |
description |
Необязательное поле. Описание структурированной услуги. Ограничение на количество символов – 300. |
FreeFormServiceItem
Представляет услугу, предлагаемую продавцом, в свободной форме. Это сервисы, которые не представлены в структурированных данных. Продавец вручную вводит названия таких сервисов, используя интерфейс geomerchant.
| JSON-представление |
|---|
{
"category": string,
"label": {
object ( |
| Поля | |
|---|---|
category |
Обязательно. Это поле содержит название категории (т.е. ее постоянный идентификатор). Значения |
label |
Обязательно. Ярлыки с языковыми тегами для объекта. Рекомендуем использовать названия длиной не более 140 символов и описания длиной не более 250 символов. Это поле следует заполнять, только если входные данные представляют собой пользовательский элемент сервиса. Стандартизированные типы услуг следует обновлять с помощью serviceTypeId. |
Ярлык
Ярлык, который будет использоваться при показе прейскуранта, раздела или позиции.
| JSON-представление |
|---|
{ "displayName": string, "description": string, "languageCode": string } |
| Поля | |
|---|---|
displayName |
Обязательно. Отображаемое название прейскуранта, раздела или позиции. |
description |
Необязательное поле. Описание прейскуранта, раздела или позиции. |
languageCode |
Необязательное поле. Код языка по стандарту BCP-47, к которому относятся эти строки. Для каждого языка можно задать только один набор ярлыков. |
Методы |
|
|---|---|
|
Создает новый адрес, который будет принадлежать вошедшему в аккаунт пользователю. |
|
Вы можете получить список адресов для определенного аккаунта. |