REST Resource: accounts.locations

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

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

JSON-представление
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Поля
name

string

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

В контексте совпадений это поле не будет заполнено.

languageCode

string

Язык локации. Устанавливается при создании и не подлежит обновлению.

storeCode

string

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

locationName

string

Название местоположения должно отражать реальное название вашей компании, которое постоянно используется на витрине вашего магазина, на веб-сайте и на канцелярских товарах и известно клиентам. Любая дополнительная информация, если она уместна, может быть включена в другие поля ресурса (например, Address , Categories ). Не добавляйте к своему имени ненужную информацию (например, отдавайте предпочтение «Google», а не «Google Inc. — штаб-квартира компании в Маунтин-Вью»). Не включайте маркетинговые слоганы, коды магазинов, специальные символы, часы работы или статус закрыт/открыт, номера телефонов, URL-адреса веб-сайтов, информацию об услугах/продуктах, местоположение/адрес или направления, а также информацию о правилах содержания (например, «Chase ATM в Дуэйн-Риде»). ").

primaryPhone

string

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

additionalPhones[]

string

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

address

object ( PostalAddress )

Точный и точный адрес, описывающий местоположение вашей компании. Почтовые ящики или почтовые ящики, расположенные в удаленных местах, не принимаются. На данный момент в адресе можно указать максимум пять значений addressLines .

primaryCategory

object ( Category )

Категория, которая лучше всего описывает основной бизнес, которым занимается данное заведение.

additionalCategories[]

object ( Category )

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

websiteUrl

string

URL-адрес этой компании. Если возможно, используйте URL-адрес, который представляет это отдельное местоположение компании, вместо общего веб-сайта/URL-адреса, который представляет все местоположения или бренд.

regularHours

object ( BusinessHours )

График работы предприятия.

specialHours

object ( SpecialHours )

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

serviceArea

object ( ServiceAreaBusiness )

Предприятия зоны обслуживания предоставляют свои услуги по месту нахождения клиента. Если этот бизнес является бизнесом в сфере обслуживания, в этом поле описываются территории, обслуживаемые этим бизнесом.

locationKey

object ( LocationKey )

Набор ключей, которые связывают эту компанию с другими ресурсами Google, такими как страница Google+ и Google Maps Places.

labels[]

string

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

adWordsLocationExtensions

object ( AdWordsLocationExtensions )

Дополнительная информация, отображаемая в AdWords.

latlng

object ( LatLng )

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

openInfo

object ( OpenInfo )

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

locationState

object ( LocationState )

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

attributes[]

object ( Attribute )

Атрибуты для этого местоположения.

metadata

object ( Metadata )

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

priceLists[]
(deprecated)

object ( PriceList )

Устарело: информация о прайс-листе для этого места.

profile

object ( Profile )

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

relationshipData

object ( RelationshipData )

Все локации и сеть, связанные с этим.

moreHours[]

object ( MoreHours )

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

Часы работы

Представляет периоды времени, в течение которых это местоположение открыто для бизнеса. Содержит коллекцию экземпляров TimePeriod .

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

object ( TimePeriod )

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

ВремяПериод

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

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

enum ( DayOfWeek )

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

openTime

string

Время в 24-часовом расширенном формате ISO 8601 (чч:мм). Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня.

closeDay

enum ( DayOfWeek )

Указывает day of the week в который заканчивается этот период.

closeTime

string

Время в 24-часовом расширенном формате ISO 8601 (чч:мм). Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня.

ДеньНедели

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

Перечисления
DAY_OF_WEEK_UNSPECIFIED День недели не указан.
MONDAY Понедельник
TUESDAY Вторник
WEDNESDAY Среда
THURSDAY Четверг
FRIDAY Пятница
SATURDAY Суббота
SUNDAY Воскресенье

Специальные часы

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

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

object ( 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": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Поля
startDate

object ( Date )

Календарная дата, когда начинается этот особый часовой период.

openTime

string

Время стены в startDate , когда открывается локация, выраженное в 24-часовом расширенном формате ISO 8601. (чч:мм) Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня. Должно быть указано, если isClosed имеет значение false.

endDate

object ( Date )

Календарная дата окончания этого особого часового периода. Если поле endDate не задано, по умолчанию используется дата, указанная в startDate . Если установлено, это поле должно быть равно или не превышать 1 дня после startDate .

closeTime

string

Время стены на endDate закрытия заведения, выраженное в 24-часовом расширенном формате ISO 8601. (чч:мм) Допустимые значения: 00:00–24:00, где 24:00 представляет собой полночь в конце указанного поля дня. Должно быть указано, если isClosed имеет значение false.

isClosed

boolean

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

СервисПлощадьБизнес

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

JSON-представление
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Поля
businessType

enum ( BusinessType )

Указывает type бизнеса в зоне обслуживания.

coverageArea поля UnionArea. Указывает зону покрытия, в которой компания предлагает услуги. coverageArea может иметь только одно из следующих значений:
radius

object ( PointRadius )

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

places

object ( Places )

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

Тип бизнеса

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

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

ТочкаРадиус

Радиус вокруг определенной точки (широта/долгота).

JSON-представление
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Поля
latlng

object ( LatLng )

Широта/долгота, определяющая центр области, определяемой радиусом.

radiusKm

number

Расстояние в километрах от местности вокруг точки.

ШиротаДлительность

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

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

number

Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0].

longitude

number

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

Места

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

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

object ( PlaceInfo )

Области, представленные идентификаторами мест. Ограничено максимум 20 местами.

Информация о месте

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

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

string

Локализованное название места. Например, Scottsdale, AZ .

placeId

string

Идентификатор места. Должно соответствовать региону.

Ключ местоположения

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

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

string

Только вывод. Если с этим местоположением связана страница Google+, она заполняется идентификатором страницы Google+ для этого местоположения.

placeId

string

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

Если это местоположение не подтверждено, это поле может быть заполнено, если местоположение связано с местом, которое отображается на Картах Google.

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

Дополнительный логический параметр explicitNoPlaceId определяет, является ли неустановленный идентификатор места преднамеренным или нет.

explicitNoPlaceId

boolean

Только вывод. Значение true указывает, что идентификатор места не установлен намеренно, что отличается от того, что связь еще не установлена.

requestId

string

Только вывод. requestId использованный для создания этого местоположения. Может быть пустым, если это местоположение было создано вне API Google My Business или местоположений профиля компании.

Расширения местоположения AdWords

Дополнительная информация, отображаемая в AdWords.

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

string

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

ОпенИнфо

Информация, касающаяся состояния открытия бизнеса.

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 Указывает, что заведение временно закрыто. Это значение можно применять только к опубликованным местоположениям (т. е. 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

boolean

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

isDuplicate

boolean

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

isSuspended

boolean

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

canUpdate

boolean

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

canDelete

boolean

Только вывод. Указывает, можно ли удалить местоположение с помощью API Google My Business.

isVerified

boolean

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

needsReverification

boolean

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

isPendingReview

boolean

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

isDisabled

boolean

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

isPublished

boolean

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

isDisconnected

boolean

Только вывод. Указывает, отключено ли местоположение от места на Картах Google.

isLocalPostApiDisabled

boolean

Только вывод. Указывает, отключен ли account.locations.localPosts для этого местоположения.

canModifyServiceList

boolean

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

canHaveFoodMenus

boolean

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

hasPendingEdits

boolean

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

hasPendingVerification

boolean

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

canOperateHealthData

boolean

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

canOperateLodgingData

boolean

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

Атрибут

Атрибут местоположения. Атрибуты предоставляют дополнительную информацию о местоположении. Атрибуты, которые можно задать для местоположения, могут различаться в зависимости от свойств этого местоположения (например, категории). Доступные атрибуты определяются Google и могут быть добавлены и удалены без изменений API.

JSON-представление
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Поля
attributeId

string

Идентификатор атрибута. Идентификаторы атрибутов предоставляются Google.

valueType

enum ( AttributeValueType )

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

values[]

value ( Value format)

Значения этого атрибута. Тип предоставленных значений должен соответствовать ожидаемому для этого атрибута; см. ТипАтрибутеЗначения . Это повторяющееся поле, в котором могут быть указаны несколько значений атрибута. Типы атрибутов поддерживают только одно значение.

repeatedEnumValue

object ( RepeatedEnumAttributeValue )

Если тип значения атрибута — REPEATED_ENUM, он содержит значение атрибута, а остальные поля значений должны быть пустыми.

urlValues[]

object ( UrlAttributeValue )

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

ПовторенноеEnumAttributeValue

Значения атрибута с valueType REPEATED_ENUM. Он состоит из двух списков идентификаторов значений: установленных (истина) и неустановленных (ложь). Отсутствующие значения считаются неизвестными. Должно быть указано хотя бы одно значение.

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

string

Установленные значения перечисления.

unsetValues[]

string

Значения перечисления, которые не установлены.

URLAttributeValue

Значения для атрибута с valueType URL.

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

string

URL-адрес.

Метаданные

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

JSON-представление
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Поля
duplicate
(deprecated)

object ( Duplicate )

Информация о локации, которую дублирует данная локация. Присутствует только в том случае, если locationState.is_duplicate имеет значение true. Устарело: мы больше не поддерживаем подробную информацию о дубликатах.

mapsUrl

string

Ссылка на местоположение на Картах.

newReviewUrl

string

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

Дублировать

Информация о локации, которую дублирует данная локация.

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

string

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

placeId

string

Идентификатор места, которое дублируется.

access

enum ( Access )

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

Доступ

Уровень доступа пользователя к локации, которую он дублирует. Это заменяет право собственности и должно использоваться вместо него.

Перечисления
ACCESS_UNSPECIFIED Не указан.
ACCESS_UNKNOWN Невозможно определить, имеет ли пользователь доступ к местоположению, которое оно дублирует.
ALLOWED Пользователь имеет доступ к локации, которую он дублирует.
INSUFFICIENT У пользователя нет доступа к местоположению, которое он дублирует.

Прайс-лист

Устарело: список информации о цене товара. Прайс-листы структурированы как один или несколько прайс-листов, каждый из которых содержит один или несколько разделов с одним или несколькими позициями. Например, прайс-листы на продукты питания могут представлять собой меню завтрака/обеда/ужина с разделами для гамбургеров/стейков/морепродуктов.

JSON-представление
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Поля
priceListId

string

Необходимый. Идентификатор прайс-листа. Прайс-лист, идентификаторы разделов и товаров не могут дублироваться в этом месте.

labels[]

object ( Label )

Необходимый. Ярлыки с языковыми метками для прайс-листа.

sourceUrl

string

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

sections[]

object ( Section )

Необходимый. Разделы данного прайс-листа. Каждый прайс-лист должен содержать хотя бы один раздел.

Этикетка

Метка, которая будет использоваться при отображении прайс-листа, раздела или товара.

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

string

Необходимый. Отображаемое имя прайс-листа, раздела или товара.

description

string

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

languageCode

string

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

Раздел

Раздел прайс-листа, содержащий одну или несколько позиций.

JSON-представление
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Поля
sectionId

string

Необходимый. Идентификатор раздела. Прайс-лист, идентификаторы разделов и товаров не могут дублироваться в этом месте.

labels[]

object ( Label )

Необходимый. Ярлыки раздела с языковыми тегами. Мы рекомендуем, чтобы имена и описания разделов содержали не более 140 символов. Требуется хотя бы один набор этикеток.

sectionType

enum ( SectionType )

Необязательный. Тип текущего раздела прайс-листа. Значение по умолчанию — ЕДА.

items[]

object ( Item )

Товары, содержащиеся в этом разделе прайс-листа.

Тип секции

Тип раздела.

Перечисления
SECTION_TYPE_UNSPECIFIED Не указан.
FOOD Раздел содержит предметы, которые представляют собой еду.
SERVICES Раздел содержит элементы, представляющие услуги.

Элемент

Один элемент списка. Каждый вариант товара в прайс-листе должен иметь собственный товар со своими данными о цене.

JSON-представление
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Поля
itemId

string

Необходимый. Идентификатор предмета. Прайс-лист, идентификаторы разделов и товаров не могут дублироваться в этом месте.

labels[]

object ( Label )

Необходимый. Ярлыки с языковыми тегами для элемента. Мы рекомендуем, чтобы имена элементов были длиной не более 140 символов, а описания — не более 250 символов. Требуется хотя бы один набор этикеток.

price

object ( Money )

Необязательный. Цена товара.

Деньги

Представляет сумму денег с типом валюты.

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

string

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

units

string ( int64 format)

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

nanos

integer

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

Профиль

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

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

string

Описание локации своим голосом, недоступное для редактирования кем-либо еще.

Данные отношений

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

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

string

Имя ресурса цепочки, членом которой является это местоположение. How to find Chain ID

БольшеЧасов

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

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

string

Необходимый. Тип часов. Клиентам следует вызвать {#link businessCategories:BatchGet}, чтобы получить поддерживаемые типы часов для категорий их местоположений.

periods[]

object ( TimePeriod )

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

Методы

associate

Связывает местоположение с идентификатором места.

batchGet

Получает все указанные местоположения в данной учетной записи.

batchGetReviews

Возвращает постраничный список отзывов для всех указанных местоположений.

clearAssociation

Очищает связь между местоположением и его идентификатором места.

create

Создает новое location принадлежащее указанной учетной записи, и возвращает его.

delete

Удаляет местоположение.

fetchVerificationOptions

Сообщает обо всех подходящих вариантах проверки для местоположения на определенном языке.

findMatches

Находит все возможные местоположения, соответствующие указанному местоположению.

get

Получает указанное местоположение.

getFoodMenus

Возвращает меню блюд определенного места.

getGoogleUpdated

Получает обновленную Google версию указанного местоположения.

getHealthProviderAttributes

Возвращает атрибуты поставщика медицинских услуг для определенного местоположения.

getServiceList

Получить указанный список услуг местоположения.

list

Перечисляет местоположения для указанной учетной записи.

patch

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

reportInsights

Возвращает отчет, содержащий информацию об одном или нескольких показателях по местоположению.

transfer
(deprecated)

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

updateFoodMenus

Обновляет меню еды в определенном месте.

updateHealthProviderAttributes

Обновляет атрибуты поставщика медицинских услуг для определенного местоположения.

updateServiceList

Обновляет указанный список служб местоположения.

verify

Запускает процесс проверки местоположения.