- Ресурс: Местоположение
- JSON-представление
- Часы работы
- ВремяПериод
- ДеньНедели
- Специальные часы
- Специальный часпериод
- СервисПлощадьБизнес
- Тип бизнеса
- ТочкаРадиус
- ШиротаДлительность
- Места
- Информация о месте
- Ключ местоположения
- Расширения местоположения AdWords
- ОпенИнфо
- OpenForBusiness
- Состояние местоположения
- Атрибут
- Повторенноеэнуматтрибутевалуе
- URLAttributeValue
- Метаданные
- Дублировать
- Доступ
- Прайс-лист
- Этикетка
- Раздел
- Тип секции
- Элемент
- Деньги
- Профиль
- Данные отношений
- БольшеЧасов
- Методы
Ресурс: Местоположение
Местоположение. См. статью Справочного центра для подробного описания этих полей или конечную точку категории для получения списка допустимых бизнес-категорий.
JSON-представление | |
---|---|
{ "name": string, "languageCode": string, "storeCode": string, "locationName": string, "primaryPhone": string, "additionalPhones": [ string ], "address": { object ( |
Поля | |
---|---|
name | Идентификатор Google для этого местоположения в форме: В контексте совпадений это поле не будет заполнено. |
languageCode | Язык локации. Устанавливается при создании и не подлежит обновлению. |
storeCode | Внешний идентификатор этого местоположения, который должен быть уникальным внутри данной учетной записи. Это средство связывания местоположения с вашими собственными записями. |
locationName | Название местоположения должно отражать реальное название вашей компании, которое постоянно используется на витрине вашего магазина, на веб-сайте и на канцелярских товарах и известно клиентам. Любая дополнительная информация, если она уместна, может быть включена в другие поля ресурса (например, |
primaryPhone | Номер телефона, который максимально напрямую связан с местоположением вашей компании. По возможности используйте местный номер телефона вместо центрального номера горячей линии колл-центра. |
additionalPhones[] | До двух телефонных номеров (мобильный или стационарный, без факса), по которым можно позвонить в вашу компанию, в дополнение к вашему основному номеру телефона. |
address | Точный и точный адрес, описывающий местоположение вашей компании. Почтовые ящики или почтовые ящики, расположенные в удаленных местах, не принимаются. На данный момент в адресе можно указать максимум пять значений |
primaryCategory | Категория, которая лучше всего описывает основной бизнес, которым занимается данное заведение. |
additionalCategories[] | Дополнительные категории для описания вашего бизнеса. Категории помогают вашим клиентам находить точные и конкретные результаты по интересующим их услугам. Чтобы информация о вашей компании была точной и актуальной, убедитесь, что вы используете как можно меньше категорий для описания вашего основного бизнеса в целом. Выбирайте категории, которые максимально конкретны, но отражают ваш основной бизнес. |
websiteUrl | URL-адрес этой компании. Если возможно, используйте URL-адрес, который представляет это отдельное местоположение компании, вместо общего веб-сайта/URL-адреса, который представляет все местоположения или бренд. |
regularHours | График работы предприятия. |
specialHours | Специальные часы для бизнеса. Обычно это включает в себя праздничные дни и другое время, выходящее за рамки обычного рабочего времени. Они отменяют обычные часы работы. |
serviceArea | Предприятия зоны обслуживания предоставляют свои услуги по месту нахождения клиента. Если этот бизнес является бизнесом в сфере обслуживания, в этом поле описываются территории, обслуживаемые этим бизнесом. |
locationKey | Набор ключей, которые связывают эту компанию с другими ресурсами Google, такими как страница Google+ и Google Maps Places. |
labels[] | Коллекция строк произвольной формы, позволяющая пометить свой бизнес. Эти ярлыки НЕ предназначены для пользователя; только ты можешь их видеть. Ограничено 255 символами (на метку). |
adWordsLocationExtensions | Дополнительная информация, отображаемая в AdWords. |
latlng | Предоставляемые пользователем широта и долгота. При создании местоположения это поле игнорируется, если предоставленный адрес геокодируется успешно. Это поле возвращается только в запросах на получение, если предоставленное пользователем значение |
openInfo | Флаг, указывающий, открыто ли в данный момент местоположение для бизнеса. |
locationState | Только вывод. Набор логических значений, отражающих состояние местоположения. |
attributes[] | Атрибуты для этого местоположения. |
metadata | Только вывод. Дополнительная нередактируемая пользователем информация. |
priceLists[] | Устарело: информация о прайс-листе для этого места. |
profile | Описывает ваш бизнес собственным голосом и делится с пользователями уникальной историей вашего бизнеса и предложений. |
relationshipData | Все локации и сеть, связанные с этим. |
moreHours[] | Больше часов для различных отделов компании или конкретных клиентов. |
Часы работы
Представляет периоды времени, в течение которых это местоположение открыто для бизнеса. Содержит коллекцию экземпляров TimePeriod
.
JSON-представление | |
---|---|
{
"periods": [
{
object ( |
Поля | |
---|---|
periods[] | Подборка случаев, когда это заведение было открыто для бизнеса. Каждый период представляет собой диапазон часов, в течение которых заведение открыто в течение недели. |
ВремяПериод
Представляет промежуток времени, в течение которого компания открыта, начиная с указанного дня/времени открытия и закрываясь в указанный день/время закрытия. Время закрытия должно наступать после времени открытия, например, позднее в тот же день или на следующий день.
JSON-представление | |
---|---|
{ "openDay": enum ( |
Поля | |
---|---|
openDay | Указывает |
openTime | Время в 24-часовом расширенном формате ISO 8601 (чч:мм). Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня. |
closeDay | Указывает |
closeTime | Время в 24-часовом расширенном формате ISO 8601 (чч:мм). Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня. |
ДеньНедели
Представляет день недели.
Перечисления | |
---|---|
DAY_OF_WEEK_UNSPECIFIED | День недели не указан. |
MONDAY | Понедельник |
TUESDAY | Вторник |
WEDNESDAY | Среда |
THURSDAY | Четверг |
FRIDAY | Пятница |
SATURDAY | Суббота |
SUNDAY | Воскресенье |
Специальные часы
Представляет набор периодов времени, когда часы работы местоположения отличаются от обычных часов работы.
JSON-представление | |
---|---|
{
"specialHourPeriods": [
{
object ( |
Поля | |
---|---|
specialHourPeriods[] | Список исключений из обычного режима работы предприятия. |
Специальный часпериод
Представляет один период времени, когда часы работы местоположения отличаются от обычных часов работы. Особый часовой период должен представлять собой диапазон менее 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 | Время стены в |
endDate | Календарная дата окончания этого особого часового периода. Если поле |
closeTime | Время стены на |
isClosed | Если true, |
СервисПлощадьБизнес
Предприятия зоны обслуживания предоставляют свои услуги по месту нахождения клиента (например, у слесаря или сантехника).
JSON-представление | |
---|---|
{ "businessType": enum ( |
Поля | ||
---|---|---|
businessType | Указывает | |
coverageArea поля UnionArea. Указывает зону покрытия, в которой компания предлагает услуги. coverageArea может иметь только одно из следующих значений: | ||
radius | Только вывод. Область, которую обслуживает это предприятие, сосредоточена вокруг точки. | |
places | Территория, которую обслуживает этот бизнес, определяется набором мест. |
Тип бизнеса
Указывает, предлагает ли эта компания услуги только на месте в месте нахождения клиента (например, эвакуатор) или одновременно по адресу и на месте (например, магазин пиццы с обеденной зоной, который также осуществляет доставку клиентам).
Перечисления | |
---|---|
BUSINESS_TYPE_UNSPECIFIED | Только вывод. Не указан. |
CUSTOMER_LOCATION_ONLY | Предлагает услуги только в окрестностях (не по служебному адресу). |
CUSTOMER_AND_BUSINESS_LOCATION | Предлагает услуги по служебному адресу и в окрестностях. |
ТочкаРадиус
Радиус вокруг определенной точки (широта/долгота).
JSON-представление | |
---|---|
{
"latlng": {
object ( |
Поля | |
---|---|
latlng | Широта/долгота, определяющая центр области, определяемой радиусом. |
radiusKm | Расстояние в километрах от местности вокруг точки. |
ШиротаДлительность
Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, обозначающих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.
JSON-представление | |
---|---|
{ "latitude": number, "longitude": number } |
Поля | |
---|---|
latitude | Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0]. |
longitude | Долгота в градусах. Оно должно находиться в диапазоне [-180,0, +180,0]. |
Места
Определяет объединение территорий, представленных набором мест.
JSON-представление | |
---|---|
{
"placeInfos": [
{
object ( |
Поля | |
---|---|
placeInfos[] | Области, представленные идентификаторами мест. Ограничено максимум 20 местами. |
Информация о месте
Определяет область, представленную идентификатором места.
JSON-представление | |
---|---|
{ "name": string, "placeId": string } |
Поля | |
---|---|
name | Локализованное название места. Например, |
placeId | Идентификатор места. Должно соответствовать региону. |
Ключ местоположения
Альтернативные/суррогатные ключевые ссылки для местоположения.
JSON-представление | |
---|---|
{ "plusPageId": string, "placeId": string, "explicitNoPlaceId": boolean, "requestId": string } |
Поля | |
---|---|
plusPageId | Только вывод. Если с этим местоположением связана страница Google+, она заполняется идентификатором страницы Google+ для этого местоположения. |
placeId | Если это местоположение проверено и связано с Картами Google или отображается на нем, это поле заполняется идентификатором места для этого местоположения. Этот идентификатор можно использовать в различных API-интерфейсах Places. Если это местоположение не подтверждено, это поле может быть заполнено, если местоположение связано с местом, которое отображается на Картах Google. Это поле можно задать во время вызовов Create, но не для Update. Дополнительный логический параметр |
explicitNoPlaceId | Только вывод. Значение true указывает, что идентификатор места не установлен намеренно, что отличается от того, что связь еще не установлена. |
requestId | Только вывод. |
Расширения местоположения AdWords
Дополнительная информация, отображаемая в AdWords.
JSON-представление | |
---|---|
{ "adPhone": string } |
Поля | |
---|---|
adPhone | Альтернативный номер телефона, который будет отображаться в расширениях адресов AdWords вместо основного номера телефона местоположения. |
ОпенИнфо
Информация, касающаяся состояния открытия бизнеса.
JSON-представление | |
---|---|
{ "status": enum ( |
Поля | |
---|---|
status | Указывает, открыто ли местоположение в настоящее время для бизнеса. Все локации открыты по умолчанию, если не обновлено положение о закрытии. |
canReopen | Только вывод. Указывает, имеет ли этот бизнес право на повторное открытие. |
openingDate | Дата первого открытия заведения. Если точный день неизвестен, можно указать только месяц и год. Дата должна быть в прошлом или не позднее одного года в будущем. |
OpenForBusiness
Указывает статус местоположения.
Перечисления | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED | Не указан. |
OPEN | Указывает, что локация открыта. |
CLOSED_PERMANENTLY | Указывает, что местоположение закрыто навсегда. |
CLOSED_TEMPORARILY | Указывает, что заведение временно закрыто. Это значение можно применять только к опубликованным местоположениям (т. е. locationState.is_published = true). При обновлении поля статуса до этого значения клиенты должны явно установить для updateMask значение openInfo.status . Никакие другие маски обновления не могут быть установлены во время этого вызова обновления. Это временное ограничение, которое в ближайшее время будет смягчено. |
Состояние местоположения
Содержит набор логических значений, отражающих состояние местоположения.
JSON-представление | |
---|---|
{ "isGoogleUpdated": boolean, "isDuplicate": boolean, "isSuspended": boolean, "canUpdate": boolean, "canDelete": boolean, "isVerified": boolean, "needsReverification": boolean, "isPendingReview": boolean, "isDisabled": boolean, "isPublished": boolean, "isDisconnected": boolean, "isLocalPostApiDisabled": boolean, "canModifyServiceList": boolean, "canHaveFoodMenus": boolean, "hasPendingEdits": boolean, "hasPendingVerification": boolean, "canOperateHealthData": boolean, "canOperateLodgingData": boolean } |
Поля | |
---|---|
isGoogleUpdated | Только вывод. Указывает, обновлен ли идентификатор места, связанный с этим местоположением. |
isDuplicate | Только вывод. Указывает, является ли местоположение дубликатом другого местоположения. |
isSuspended | Только вывод. Указывает, приостановлено ли местоположение. Заблокированные местоположения не видны конечным пользователям продуктов Google. Если вы считаете, что это была ошибка, прочтите статью Справочного центра . |
canUpdate | Только вывод. Указывает, можно ли обновить местоположение. |
canDelete | Только вывод. Указывает, можно ли удалить местоположение с помощью API Google My Business. |
isVerified | Только вывод. Указывает, проверено ли местоположение. |
needsReverification | Только вывод. Указывает, требует ли местоположение повторной проверки. |
isPendingReview | Только вывод. Указывает, ожидается ли проверка местоположения. |
isDisabled | Только вывод. Указывает, отключено ли местоположение. |
isPublished | Только вывод. Указывает, опубликовано ли местоположение. |
isDisconnected | Только вывод. Указывает, отключено ли местоположение от места на Картах Google. |
isLocalPostApiDisabled | Только вывод. Указывает, отключен ли account.locations.localPosts для этого местоположения. |
canModifyServiceList | Только вывод. Указывает, может ли листинг изменять ServiceList. |
canHaveFoodMenus | Только вывод. Указывает, подходит ли объявление для меню еды. |
hasPendingEdits | Только вывод. Указывает, находятся ли какие-либо свойства этого местоположения в состоянии ожидания редактирования. |
hasPendingVerification | Только вывод. Указывает, есть ли у местоположения ожидающие запросы на проверку. |
canOperateHealthData | Только вывод. Указывает, может ли местоположение работать с данными о состоянии здоровья. |
canOperateLodgingData | Только вывод. Указывает, может ли местоположение работать с данными о жилье. |
Атрибут
Атрибут местоположения. Атрибуты предоставляют дополнительную информацию о местоположении. Атрибуты, которые можно задать для местоположения, могут различаться в зависимости от свойств этого местоположения (например, категории). Доступные атрибуты определяются Google и могут быть добавлены и удалены без изменений API.
JSON-представление | |
---|---|
{ "attributeId": string, "valueType": enum ( |
Поля | |
---|---|
attributeId | Идентификатор атрибута. Идентификаторы атрибутов предоставляются Google. |
valueType | Только вывод. Тип значения, которое содержит этот атрибут. Это следует использовать для определения того, как интерпретировать значение. |
values[] | Значения этого атрибута. Тип предоставленных значений должен соответствовать ожидаемому для этого атрибута; см. ТипАтрибутеЗначения . Это повторяющееся поле, в котором могут быть указаны несколько значений атрибута. Типы атрибутов поддерживают только одно значение. |
repeatedEnumValue | Если тип значения атрибута — REPEATED_ENUM, он содержит значение атрибута, а остальные поля значений должны быть пустыми. |
urlValues[] | Если типом значения атрибута является URL-адрес, это поле содержит значения для этого атрибута, а другие поля значений должны быть пустыми. |
ПовторенноеEnumAttributeValue
Значения атрибута с valueType
REPEATED_ENUM. Он состоит из двух списков идентификаторов значений: установленных (истина) и неустановленных (ложь). Отсутствующие значения считаются неизвестными. Должно быть указано хотя бы одно значение.
JSON-представление | |
---|---|
{ "setValues": [ string ], "unsetValues": [ string ] } |
Поля | |
---|---|
setValues[] | Установленные значения перечисления. |
unsetValues[] | Значения перечисления, которые не установлены. |
URLAttributeValue
Значения для атрибута с valueType
URL.
JSON-представление | |
---|---|
{ "url": string } |
Поля | |
---|---|
url | URL-адрес. |
Метаданные
Дополнительная нередактируемая пользователем информация о местоположении.
JSON-представление | |
---|---|
{
"duplicate": {
object ( |
Поля | |
---|---|
duplicate | Информация о локации, которую дублирует данная локация. Присутствует только в том случае, если |
mapsUrl | Ссылка на местоположение на Картах. |
newReviewUrl | Ссылка на страницу в Google Поиске, где клиент может оставить отзыв о местоположении. |
Дублировать
Информация о локации, которую дублирует данная локация.
JSON-представление | |
---|---|
{
"locationName": string,
"placeId": string,
"access": enum ( |
Поля | |
---|---|
locationName | Имя ресурса местоположения, которое дублируется. Заполняется только в том случае, если аутентифицированный пользователь имеет права доступа к этому местоположению и это местоположение не удалено. |
placeId | Идентификатор места, которое дублируется. |
access | Указывает, имеет ли пользователь доступ к местоположению, которое оно дублирует. |
Доступ
Уровень доступа пользователя к локации, которую он дублирует. Это заменяет право собственности и должно использоваться вместо него.
Перечисления | |
---|---|
ACCESS_UNSPECIFIED | Не указан. |
ACCESS_UNKNOWN | Невозможно определить, имеет ли пользователь доступ к местоположению, которое оно дублирует. |
ALLOWED | Пользователь имеет доступ к локации, которую он дублирует. |
INSUFFICIENT | У пользователя нет доступа к местоположению, которое он дублирует. |
Прайс-лист
Устарело: список информации о цене товара. Прайс-листы структурированы как один или несколько прайс-листов, каждый из которых содержит один или несколько разделов с одним или несколькими позициями. Например, прайс-листы на продукты питания могут представлять собой меню завтрака/обеда/ужина с разделами для гамбургеров/стейков/морепродуктов.
JSON-представление | |
---|---|
{ "priceListId": string, "labels": [ { object ( |
Поля | |
---|---|
priceListId | Необходимый. Идентификатор прайс-листа. Прайс-лист, идентификаторы разделов и товаров не могут дублироваться в этом месте. |
labels[] | Необходимый. Ярлыки с языковыми метками для прайс-листа. |
sourceUrl | Необязательный URL-адрес источника, откуда был получен прайс-лист. Например, это может быть URL-адрес страницы, которая была автоматически скопирована для заполнения информации меню. |
sections[] | Необходимый. Разделы данного прайс-листа. Каждый прайс-лист должен содержать хотя бы один раздел. |
Этикетка
Метка, которая будет использоваться при отображении прайс-листа, раздела или товара.
JSON-представление | |
---|---|
{ "displayName": string, "description": string, "languageCode": string } |
Поля | |
---|---|
displayName | Необходимый. Отображаемое имя прайс-листа, раздела или товара. |
description | Необязательный. Описание прайс-листа, раздела или позиции. |
languageCode | Необязательный. Код языка BCP-47, к которому применяются эти строки. Для каждого языка можно установить только один набор меток. |
Раздел
Раздел прайс-листа, содержащий одну или несколько позиций.
JSON-представление | |
---|---|
{ "sectionId": string, "labels": [ { object ( |
Поля | |
---|---|
sectionId | Необходимый. Идентификатор раздела. Прайс-лист, идентификаторы разделов и товаров не могут дублироваться в этом месте. |
labels[] | Необходимый. Ярлыки раздела с языковыми тегами. Мы рекомендуем, чтобы имена и описания разделов содержали не более 140 символов. Требуется хотя бы один набор этикеток. |
sectionType | Необязательный. Тип текущего раздела прайс-листа. Значение по умолчанию — ЕДА. |
items[] | Товары, содержащиеся в этом разделе прайс-листа. |
Тип секции
Тип раздела.
Перечисления | |
---|---|
SECTION_TYPE_UNSPECIFIED | Не указан. |
FOOD | Раздел содержит предметы, которые представляют собой еду. |
SERVICES | Раздел содержит элементы, представляющие услуги. |
Элемент
Один элемент списка. Каждый вариант товара в прайс-листе должен иметь собственный товар со своими данными о цене.
JSON-представление | |
---|---|
{ "itemId": string, "labels": [ { object ( |
Поля | |
---|---|
itemId | Необходимый. Идентификатор предмета. Прайс-лист, идентификаторы разделов и товаров не могут дублироваться в этом месте. |
labels[] | Необходимый. Ярлыки с языковыми тегами для элемента. Мы рекомендуем, чтобы имена элементов были длиной не более 140 символов, а описания — не более 250 символов. Требуется хотя бы один набор этикеток. |
price | Необязательный. Цена товара. |
Деньги
Представляет сумму денег с типом валюты.
JSON-представление | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Поля | |
---|---|
currencyCode | Трехбуквенный код валюты, определенный в ISO 4217. |
units | Целые единицы суммы. Например, если |
nanos | Количество нано (10^-9) единиц суммы. Значение должно находиться в диапазоне от -999 999 999 до +999 999 999 включительно. Если |
Профиль
Вся информация, относящаяся к профилю местоположения.
JSON-представление | |
---|---|
{ "description": string } |
Поля | |
---|---|
description | Описание локации своим голосом, недоступное для редактирования кем-либо еще. |
Данные отношений
Информация обо всех родительских и дочерних местоположениях, связанных с этим.
JSON-представление | |
---|---|
{ "parentChain": string } |
Поля | |
---|---|
parentChain | Имя ресурса цепочки, членом которой является это местоположение. |
БольшеЧасов
Периоды времени, в течение которых местоположение открыто для определенных видов бизнеса.
JSON-представление | |
---|---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Поля | |
---|---|
hoursTypeId | Необходимый. Тип часов. Клиентам следует вызвать {#link businessCategories:BatchGet}, чтобы получить поддерживаемые типы часов для категорий их местоположений. |
periods[] | Необходимый. Коллекция раз, когда это место было открыто. Каждый период представляет собой диапазон часов, в течение которых заведение открыто в течение недели. |
Методы | |
---|---|
| Связывает местоположение с идентификатором места. |
| Получает все указанные местоположения в данной учетной записи. |
| Возвращает постраничный список отзывов для всех указанных местоположений. |
| Очищает связь между местоположением и его идентификатором места. |
| Создает новое location принадлежащее указанной учетной записи, и возвращает его. |
| Удаляет местоположение. |
| Сообщает обо всех подходящих вариантах проверки для местоположения на определенном языке. |
| Находит все возможные местоположения, соответствующие указанному местоположению. |
| Получает указанное местоположение. |
| Возвращает меню блюд определенного места. |
| Получает обновленную Google версию указанного местоположения. |
| Возвращает атрибуты поставщика медицинских услуг для определенного местоположения. |
| Получить указанный список услуг местоположения. |
| Перечисляет местоположения для указанной учетной записи. |
| Обновляет указанное расположение. |
| Возвращает отчет, содержащий информацию об одном или нескольких показателях по местоположению. |
(deprecated) | Перемещает местоположение из учетной записи, которой владеет пользователь, в другую учетную запись, которой управляет тот же пользователь. |
| Обновляет меню еды в определенном месте. |
| Обновляет атрибуты поставщика медицинских услуг для определенного местоположения. |
| Обновляет указанный список служб местоположения. |
| Запускает процесс проверки местоположения. |