- Представление JSON
- Информация о пользователе
- Номер телефона
- Изображение
- Торговец
- Расположение
- LatLng
- Почтовый адрес
- Содержание
- Позиция
- ЦенаАтрибут
- Тип
- Состояние
- Деньги
- Действие
- Тип
- OpenUrlAction
- AndroidApp
- ВерсияФильтр
- UrlTypeПодсказка
- Метаданные действий
- Раскрытие информации
- Раскрытие текста
- Текстовая ссылка
- РаскрытиеПрезентацияПараметры
- ПрезентацияТребование
- ПокупкаItemExtension
- Состояние покупки
- Тип покупки
- MerchantUnitMeasure
- Единица
- ПокупкаВозвратИнформация
- Информация о покупке
- Тип
- Время
- PickupInfo
- PickupType
- CurbsideИнформация
- CurbsideFulfillmentType
- Транспортное средство
- CheckInInfo
- CheckInType
- ПунктОпция
- Информация о продукте
- ReservationItemExtension
- Статус бронирования
- Тип бронирования
- ПерсоналФасилитатор
- Платежные данные
- ОплатаРезультат
- Информация о платеже
- Способ оплатыДисплейИнформация
- Способ оплаты
- Способ оплатыПроисхождение
- Повышение
- ПокупкаЗаказРасширение
- PurchaseLocationType
- Ошибка покупки
- Тип ошибки
- TicketOrderExtension
- TicketEvent
- Тип
- СобытиеПерсонаж
- Тип
Сущность заказа. Примечание. 1. Все строки на всех уровнях должны содержать менее 1000 символов, если не указано иное. 2. Количество повторяющихся полей на всех уровнях должно быть меньше 50, если не указано иное. 3. Все временные метки на всех уровнях, если они указаны, должны быть действительными временными метками.
Представление JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Поля | ||
---|---|---|
googleOrderId | Идентификатор заказа, назначенный Google. | |
merchantOrderId | Требуется: Продавец назначает внутренний идентификатор заказа. Этот идентификатор должен быть уникальным и требуется для последующих операций обновления заказа. Этот идентификатор может быть установлен равным предоставленному googleOrderId или любому другому уникальному значению. Обратите внимание, что идентификатор, представленный пользователям, — это userVisibleOrderId, который может быть другим, более удобным для пользователя значением. Максимально допустимая длина составляет 128 символов. | |
userVisibleOrderId | Идентификатор пользователя, указывающий на текущий заказ. Этот идентификатор должен соответствовать идентификатору, отображаемому для этого заказа в других контекстах, включая веб-сайты, приложения и электронную почту. | |
userVisibleStateLabel | Устарело: вместо этого используйте статус OrderExtensions. Видимая пользователем метка для состояния этого заказа. | |
buyerInfo | Информация о покупателе. | |
image | Изображение, связанное с заказом. | |
createTime | Обязательно: Дата и время создания заказа. Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: | |
lastUpdateTime | Дата и время последнего обновления заказа. Требуется для обновления заказа. Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: | |
transactionMerchant | Продавец, который упростил оформление заказа. Это может отличаться от поставщика уровня позиции. Пример: заказ Expedia с позицией от ANA. | |
contents | Требуется: содержимое заказа, представляющее собой группу позиций. | |
priceAttributes[] | Цена, скидки, налоги и так далее. | |
followUpActions[] | Последующие действия на уровне заказа. | |
paymentData | Данные, связанные с оплатой заказа. | |
termsOfServiceUrl | Ссылка на условия обслуживания, применимые к заказу/предлагаемому заказу. | |
note | Примечания к заказу. | |
promotions[] | Все рекламные акции, связанные с этим заказом. | |
disclosures[] | Раскрытие информации, связанное с этим заказом. | |
vertical | Устарело: вместо этого используйте вертикали. Эти свойства будут применяться ко всем позициям, если они не переопределены в какой-либо позиции. Эта вертикаль должна соответствовать типу вертикали уровня позиции. Возможные значения: Объект, содержащий поля произвольного типа. Дополнительное поле | |
Объединение полевых verticals . Эти свойства будут применяться ко всем позициям, если они не переопределены в какой-либо позиции. Эта вертикаль должна соответствовать типу вертикали уровня позиции. verticals могут быть только одним из следующих: | ||
purchase | Заказ на покупку | |
ticket | Заказ билетов |
Информация о пользователе
Информация о пользователе. Это используется для представления информации о пользователе, связанном с заказом.
Представление JSON | |
---|---|
{
"email": string,
"firstName": string,
"lastName": string,
"displayName": string,
"phoneNumbers": [
{
object ( |
Поля | |
---|---|
email | Электронная почта пользователя, например: janedoe@gmail.com . |
firstName | Имя пользователя. |
lastName | Фамилия пользователя. |
displayName | Отображаемое имя пользователя может отличаться от имени или фамилии. |
phoneNumbers[] | Номера телефонов пользователя. |
Номер телефона
Стандартное представление номера телефона.
Представление JSON | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
Поля | |
---|---|
e164PhoneNumber | Номер телефона в формате E.164, как определено в Рекомендации Международного союза электросвязи (ITU) E.164. вики-ссылка: https://en.wikipedia.org/wiki/E.164 |
extension | Расширение не стандартизировано в рекомендациях ITU, за исключением того, что оно определяется как серия чисел с максимальной длиной 40 цифр. Здесь он определяется как строка, чтобы учесть возможное использование начального нуля в расширении (организации имеют полную свободу действий, поскольку стандарт не определен). Помимо цифр, здесь могут храниться некоторые другие символы набора номера, такие как "," (указывающие на ожидание). Например, в ххх-ххх-хххх доб. 123, "123" - расширение. |
preferredDomesticCarrierCode | Код выбора оператора, который является предпочтительным при звонках на этот номер телефона внутри страны. Сюда также входят коды, которые необходимо набирать в некоторых странах при звонках со стационарных телефонов на мобильные и наоборот. Например, в Колумбии цифру «3» необходимо набирать перед самим телефонным номером при звонке с мобильного телефона на домашний стационарный телефон и наоборот. https://en.wikipedia.org/wiki/Телефонные_номера_в_Колумбии https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code Обратите внимание, что это «предпочтительный» код, что означает, что другие коды также могут работать. |
Изображение
Изображение, отображаемое на карточке.
Представление JSON | |
---|---|
{ "url": string, "accessibilityText": string, "height": number, "width": number } |
Поля | |
---|---|
url | Исходный URL изображения. Изображения могут быть в формате JPG, PNG и GIF (анимированные и неанимированные). Например, |
accessibilityText | Текстовое описание изображения, которое будет использоваться для специальных возможностей, например, для программ чтения с экрана. Необходимый. |
height | Высота изображения в пикселях. Необязательный. |
width | Ширина изображения в пикселях. Необязательный. |
Торговец
Продавец для корзины/заказа/позиции.
Представление JSON | |
---|---|
{ "id": string, "name": string, "image": { object ( |
Поля | |
---|---|
id | Необязательный идентификатор, присвоенный продавцу, если таковой имеется. |
name | Имя торговца похоже на "Панера Хлеб". |
image | Образ, связанный с торговцем. |
phoneNumbers[] | Телефоны продавца. |
address | Адрес продавца. |
Расположение
Контейнер, представляющий местоположение.
Представление JSON | |
---|---|
{ "coordinates": { object ( |
Поля | |
---|---|
coordinates | Географические координаты. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
formattedAddress | Отображаемый адрес, например, «1600 Amphitheatre Pkwy, Mountain View, CA 94043». Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
zipCode | Почтовый индекс. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] или [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
city | Город. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] или [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
postalAddress | Почтовый адрес. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] или [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
name | Название места. |
phoneNumber | Номер телефона местоположения, например, контактный номер офиса или номер телефона места доставки. |
notes | Заметки о месте. |
placeId | placeId используется с Places API для получения сведений о месте. См. https://developers.google.com/places/web-service/place-id . |
LatLng
Объект, представляющий пару широта/долгота. Это выражается в виде пары двойных чисел, представляющих градусы широты и градусы долготы. Если не указано иное, это должно соответствовать стандарту WGS84 . Значения должны находиться в нормированных диапазонах.
Представление JSON | |
---|---|
{ "latitude": number, "longitude": number } |
Поля | |
---|---|
latitude | Широта в градусах. Он должен быть в диапазоне [-90,0, +90,0]. |
longitude | Долгота в градусах. Он должен быть в диапазоне [-180,0, +180,0]. |
Почтовый адрес
Представляет почтовый адрес, например, для почтовых адресов доставки или платежей. Имея почтовый адрес, почтовая служба может доставить отправления в помещение, почтовый ящик и т.п. Он не предназначен для моделирования географических объектов (дорог, городов, гор).
При типичном использовании адрес будет создан с помощью пользовательского ввода или путем импорта существующих данных, в зависимости от типа процесса.
Совет по вводу/редактированию адреса: - Используйте виджет адреса с поддержкой i18n, такой как https://github.com/google/libaddressinput ) - Пользователям не следует предоставлять элементы пользовательского интерфейса для ввода или редактирования полей за пределами стран, где это поле есть. использовал.
Дополнительные инструкции по использованию этой схемы см. на странице https://support.google.com/business/answer/6397478 .
Представление JSON | |
---|---|
{ "revision": number, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Поля | |
---|---|
revision | Версия схемы Все новые версии должны быть обратно совместимы со старыми версиями. |
regionCode | Необходимый. Код региона CLDR страны/региона адреса. Это никогда не выводится, и пользователь должен убедиться, что значение правильное. Подробности см. на http://cldr.unicode.org/ и http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: "CH" для Швейцарии. |
languageCode | Необязательный. Код языка BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не критично для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием. Если это значение неизвестно, его следует опустить (вместо указания возможно неправильного значения по умолчанию). Примеры: «ж-хант», «джа», «джа-латн», «эн». |
postalCode | Необязательный. Почтовый индекс адреса. Не во всех странах используются или требуются почтовые индексы, но там, где они используются, они могут инициировать дополнительную проверку с другими частями адреса (например, проверка штата/почтового индекса в США). |
sortingCode | Необязательный. Дополнительный код сортировки для конкретной страны. В большинстве регионов не используется. Там, где он используется, значение представляет собой либо строку, например «CEDEX», за которой может следовать число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «указатель области доставки». (Малави) или "указатель почтового отделения" (например, Кот-д'Ивуар). |
administrativeArea | Необязательный. Высшая административная единица, которая используется для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В частности, для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Многие страны не используют административный район в почтовых адресах. Например, в Швейцарии его следует оставить незаселенным. |
locality | Необязательный. Обычно относится к городской части адреса. Примеры: город США, IT-коммуна, почтовый город Великобритании. В регионах мира, где населенные пункты плохо определены или плохо вписываются в эту структуру, оставьте поле населенного пункта пустым и используйте адресные строки. |
sublocality | Необязательный. Подлокальность адреса. Например, это могут быть микрорайоны, районы, районы. |
addressLines[] | Неструктурированные адресные строки, описывающие нижние уровни адреса. Поскольку значения в addressLines не имеют информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был четким. Порядок адресных строк должен быть «конвертным» для страны/региона адреса. В местах, где это может варьироваться (например, в Японии), address_language используется, чтобы сделать его явным (например, «ja» для упорядочения от большого к меньшему и «ja-Latn» или «en» для упорядочения от маленького к большому). Таким образом, наиболее конкретная строка адреса может быть выбрана в зависимости от языка. Минимально допустимое структурное представление адреса состоит из кода региона, а вся остальная информация размещается в адресных строках. Такой адрес можно было бы очень приблизительно отформатировать без геокодирования, но никакие семантические рассуждения нельзя было бы сделать ни для одного из компонентов адреса, пока он не был хотя бы частично разрешен. Создание адреса, содержащего только regionCode и addressLines, а затем геокодирование — рекомендуемый способ обработки полностью неструктурированных адресов (в отличие от угадывания, какие части адреса должны быть населенными пунктами или административными областями). |
recipients[] | Необязательный. Получатель по адресу. Это поле может при определенных обстоятельствах содержать многострочную информацию. Например, он может содержать информацию об уходе. |
organization | Необязательный. Название организации по адресу. |
Содержание
Обертка для позиций.
Представление JSON | |
---|---|
{
"lineItems": [
{
object ( |
Поля | |
---|---|
lineItems[] | Список позиций заказа. Требуется хотя бы 1 line_item, разрешено не более 50. Все позиции должны принадлежать одной вертикали. |
Позиция
Одна позиция содержит одну вертикаль. В заказе или корзине может быть несколько позиций одной вертикали. Элементы подстроки/дополнения и т. д. должны быть определены в вертикальных прототипах в зависимости от вариантов их использования. Примечание. 1. Все строки на всех уровнях должны содержать менее 1000 символов, если не указано иное. 2. Количество повторяющихся полей на всех уровнях должно быть меньше 50, если не указано иное. 3. Все временные метки на всех уровнях, если они указаны, должны быть действительными временными метками.
Представление JSON | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
Поля | ||
---|---|---|
id | Требуется: Идентификатор позиции, назначенный продавцом. Используется для идентификации существующей позиции при применении частичных обновлений. Максимально допустимая длина составляет 64 символа. | |
name | Название позиции, отображаемое в квитанции. Максимально допустимая длина составляет 100 символов. | |
userVisibleStateLabel | Устарело. Вместо этого используйте статус вертикального уровня. Например, для покупок используйте PurchaseOrderExtension.status. Видимый пользователем ярлык для состояния этой позиции. | |
provider | Поставщик конкретной позиции, если он отличается от общего заказа. Пример: заказ Expedia с поставщиком позиции ANA. | |
priceAttributes[] | Цена и корректировки на уровне позиции. | |
followUpActions[] | Последующие действия в позиции. | |
recipients[] | Клиенты на уровне позиции, это может отличаться от покупателя на уровне заказа. Пример: Пользователь X забронировал столик в ресторане на имя пользователя Y. | |
image | Небольшое изображение, связанное с этим элементом, если таковое имеется. | |
description | Описание позиции. | |
notes[] | Дополнительные примечания, применимые к этой конкретной позиции, например правила отмены. | |
disclosures[] | Раскрытие информации, связанное с этой строкой. | |
vertical | Устарело: вместо этого используйте вертикали. Требуется: семантическое содержание позиции в зависимости от ее типа/вертикали. Каждая вертикаль должна включать свои детали исполнения. Должно быть одно из следующих значений: Объект, содержащий поля произвольного типа. Дополнительное поле | |
Объединение полевых verticals . Требуется: семантическое содержание позиции в зависимости от ее типа/вертикали. Каждая вертикаль должна включать свои детали исполнения. verticals могут быть только одним из следующих: | ||
purchase | Заказы на покупку, такие как товары, продукты питания и т. д. | |
reservation | Бронирование заказов, таких как ресторан, стрижка и т. д. |
ЦенаАтрибут
Ценовой атрибут заказа или позиции.
Представление JSON | |
---|---|
{ "type": enum ( |
Поля | ||
---|---|---|
type | Требуется: Тип денежного атрибута. | |
name | Обязательно: Отображаемая пользователем строка атрибута цены. Это отправляется и локализуется продавцом. | |
state | Требуется: Состояние цены: расчетное и фактическое. | |
taxIncluded | Включает ли цена налог. | |
spec поля союза. Представляет либо денежную сумму, либо миллипроценты. spec может быть только одним из следующих: | ||
amount | Денежная сумма. | |
amountMillipercentage | Спецификация в процентах с точностью до 1/1000 процента. Например: 8,750% представлено как 8750, отрицательные проценты представляют процентные скидки. Прекращение поддержки этого поля. Можно рассмотреть возможность добавления обратно, когда требуется надежный вариант использования. |
Тип
Представляет тип денег.
перечисления | |
---|---|
TYPE_UNSPECIFIED | Тип не указан, клиенты не должны задавать его явно. |
REGULAR | Обычная отображаемая цена до применения каких-либо скидок и т. д. |
DISCOUNT | Вычитается из промежуточного итога. |
TAX | Будет добавлено к промежуточному итогу. |
DELIVERY | Будет добавлено к промежуточному итогу. |
SUBTOTAL | Итого до того, как могут быть добавлены некоторые сборы. |
FEE | Любая дополнительная плата. |
GRATUITY | Будет добавлено к промежуточному итогу. |
TOTAL | Отображаемая цена заказа или позиции. |
Состояние
Представляет состояние цены.
перечисления | |
---|---|
STATE_UNSPECIFIED | Не указан. |
ESTIMATE | Цена является лишь приблизительной. |
ACTUAL | Фактическая цена, которая будет взиматься с пользователя. |
Деньги
Представляет денежную сумму с ее типом валюты.
Представление JSON | |
---|---|
{ "currencyCode": string, "amountInMicros": string } |
Поля | |
---|---|
currencyCode | Трехбуквенный код валюты, определенный в ISO 4217. |
amountInMicros | Сумма в микро. Например, это поле должно быть установлено как 1990000 за 1,99 доллара США. |
Действие
Последующее действие, связанное с заказом или позицией.
Представление JSON | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Требуется: Тип действия. |
title | Название или метка действия, отображаемая пользователю. Максимально допустимая длина составляет 100 символов. |
openUrlAction | Действия, которые необходимо предпринять. |
actionMetadata | Метаданные, связанные с действием. |
Тип
Возможные последующие действия.
перечисления | |
---|---|
TYPE_UNSPECIFIED | Неопределенное действие. |
VIEW_DETAILS | Действие просмотра сведений о заказе. |
MODIFY | Изменить действие заказа. |
CANCEL | Отменить действие заказа. |
RETURN | Действия по возврату заказа. |
EXCHANGE | Действие приказа об обмене. |
EMAIL | Действие по электронной почте. Типы EMAIL и CALL устарели. openUrlAction.url можно использовать как номер телефона или адрес электронной почты. |
CALL | Действие вызова. |
REORDER | Переупорядочить действие. |
REVIEW | Проверка действия по заказу. |
CUSTOMER_SERVICE | Свяжитесь со службой поддержки клиентов. |
FIX_ISSUE | Перейдите на сайт продавца или в приложение, чтобы решить проблему. |
DIRECTION | Ссылка направления. |
OpenUrlAction
Открывает указанный URL.
Представление JSON | |
---|---|
{ "url": string, "androidApp": { object ( |
Поля | |
---|---|
url | Поле URL-адреса, которое может быть любым из: - URL-адреса http/https для открытия приложения, связанного с приложением, или веб-страницы. |
androidApp | Информация о приложении Android, если ожидается, что URL-адрес будет выполнен приложением Android. |
urlTypeHint | Указывает подсказку для типа URL. |
AndroidApp
Спецификация приложения Android для ограничений выполнения
Представление JSON | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
Поля | |
---|---|
packageName | Имя пакета Имя пакета должно быть указано при указании Android Fulfillment. |
versions[] | Если указано несколько фильтров, приложение будет запускаться при любом совпадении фильтров. |
ВерсияФильтр
VersionFilter должен быть включен, если требуются определенные версии приложения.
Представление JSON | |
---|---|
{ "minVersion": number, "maxVersion": number } |
Поля | |
---|---|
minVersion | Минимальный код версии или 0 включительно. |
maxVersion | Код максимальной версии включительно. Рассматриваемый диапазон — [minVersion:maxVersion]. Нулевой диапазон подразумевает любую версию. Примеры: Чтобы указать одну версию, используйте: [целевая_версия:целевая_версия]. Чтобы указать любую версию, оставьте minVersion и maxVersion неуказанными. Чтобы указать все версии до maxVersion, оставьте minVersion неуказанным. Чтобы указать все версии из minVersion, оставьте maxVersion неуказанным. |
UrlTypeПодсказка
Различные типы URL-подсказок.
перечисления | |
---|---|
URL_TYPE_HINT_UNSPECIFIED | Неопределенные |
AMP_CONTENT | URL-адрес, указывающий непосредственно на AMP-контент, или на канонический URL-адрес, который ссылается на AMP-контент через <link rel="amphtml">. |
Метаданные действий
Связанные метаданные для каждого действия.
Представление JSON | |
---|---|
{ "expireTime": string } |
Поля | |
---|---|
expireTime | Время, когда это действие истечет. Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: |
Раскрытие информации
Информация о продукте, услуге или политике, которая может быть представлена пользователю.
Представление JSON | |
---|---|
{ "title": string, "disclosureText": { object ( |
Поля | |
---|---|
title | Название раскрытия. Пример: «Информация по безопасности». |
disclosureText | Содержание раскрытия. Веб-ссылки разрешены. |
presentationOptions | Варианты представления для раскрытия. |
Раскрытие текста
Представляет собой обычный текст с веб-ссылками.
Представление JSON | |
---|---|
{
"template": string,
"textLinks": [
{
object ( |
Поля | |
---|---|
template | Отображаемый текст, содержащий заполнители, такие как "{0}" и "{1}", для каждой текстовой ссылки, которую необходимо вставить. Пример: «ВНИМАНИЕ! Этот продукт может подвергнуть вас воздействию химических веществ, которые, как известно в штате Калифорния, вызывают рак. Для получения дополнительной информации перейдите на страницу {0}». Этот текст раскрытия информации не должен содержать рекламного или рекламного содержания. |
textLinks[] | Текстовые ссылки, которые необходимо подставить в шаблон. Первый будет заменен на "{0}" в строке шаблона, а второй на "{1}" и т. д. |
Текстовая ссылка
Текстовая ссылка, которую следует подставить в шаблон.
Представление JSON | |
---|---|
{ "displayText": string, "url": string } |
Поля | |
---|---|
displayText | Текст, который должен отображаться для пользователей. |
url | URL-адрес, на который должны быть направлены пользователи при активации ссылки. |
РаскрытиеПрезентацияПараметры
Варианты представления раскрытия информации.
Представление JSON | |
---|---|
{
"presentationRequirement": enum ( |
Поля | |
---|---|
presentationRequirement | Требование к представлению раскрытия. |
initiallyExpanded | Следует ли изначально расширить содержание раскрытия. По умолчанию он изначально свернут. |
ПрезентацияТребование
Требование к представлению раскрытия.
перечисления | |
---|---|
REQUIREMENT_UNSPECIFIED | Неопределенное требование. Не следует устанавливать это явно. |
REQUIREMENT_OPTIONAL | Раскрытие не является обязательным. Его можно пропустить, если устройство не поддерживает показ раскрытий. |
REQUIREMENT_REQUIRED | Раскрытие требуется. Разговор будет переведен на телефон, если устройство не поддерживает показ раскрытий. |
ПокупкаItemExtension
Содержание позиции Вертикаль покупки.
Представление JSON | |
---|---|
{ "status": enum ( |
Поля | |
---|---|
status | Обязательно: статус на уровне позиции. |
userVisibleStatusLabel | Требуется: Видимая пользователем метка/строка для статуса. Максимально допустимая длина составляет 50 символов. |
type | Требуется: Тип покупки. |
productId | Идентификатор продукта или предложения, связанный с этой позицией. |
quantity | Количество товара. |
unitMeasure | Единица измерения. Определяет размер элемента в выбранных единицах. Размер вместе с активной ценой используется для определения цены за единицу. |
returnsInfo | Возвращает информацию для этой позиции. Если не задано, эта позиция наследует уровень заказа, возвращает информацию. |
fulfillmentInfo | Информация о выполнении для этой позиции. Если этот параметр не установлен, эта позиция наследует информацию о выполнении на уровне заказа. |
itemOptions[] | Дополнительные дополнения или подпункты. |
extension | Любые дополнительные поля, которыми обмениваются продавец и Google. Объект, содержащий поля произвольного типа. Дополнительное поле |
productDetails | Подробности о продукте. |
Состояние покупки
Статус покупки, связанный с заказом на покупку или определенной позицией.
перечисления | |
---|---|
PURCHASE_STATUS_UNSPECIFIED | Статус не указан. |
READY_FOR_PICKUP | Готов. |
SHIPPED | Отправленный. |
DELIVERED | Доставленный. |
OUT_OF_STOCK | Распродано. |
IN_PREPARATION | IN_PREPARATION может иметь другое значение в другом контексте. Для заказа FOOD может быть приготовлена еда. Для розничной торговли это может быть товар в упаковке. |
CREATED | Заказ создан. |
CONFIRMED | Продавец подтвердил заказ. |
REJECTED | Продавец отклонил заказ или позицию. |
RETURNED | Товар возвращен пользователем. |
CANCELLED | Заказ или позиция были отменены пользователем. |
CHANGE_REQUESTED | Пользователь запросил изменение заказа, и интегратор обрабатывает это изменение. Заказ должен быть перемещен в другое состояние после обработки запроса. |
Тип покупки
Категория покупки.
перечисления | |
---|---|
PURCHASE_TYPE_UNSPECIFIED | Неизвестное значение. |
RETAIL | Сюда входят такие покупки, как физические товары. |
FOOD | Он включает в себя покупку заказа еды. |
GROCERY | Покупка продуктов. |
MOBILE_RECHARGE | Предоплаченная покупка мобильного пополнения. |
MerchantUnitMeasure
Показатель ценообразования торговой единицы.
Представление JSON | |
---|---|
{
"measure": number,
"unit": enum ( |
Поля | |
---|---|
measure | Значение: Пример 1.2. |
unit | Единица измерения: Пример: ФУНТ, ГРАММ. |
Единица
перечисления | |
---|---|
UNIT_UNSPECIFIED | Единица не указана. |
MILLIGRAM | Миллиграмм. |
GRAM | грамм. |
KILOGRAM | Килограмм. |
OUNCE | Унция. |
POUND | Фунт. |
ПокупкаВозвратИнформация
Возвращает информацию, связанную с заказом или конкретной позицией.
Представление JSON | |
---|---|
{ "isReturnable": boolean, "daysToReturn": number, "policyUrl": string } |
Поля | |
---|---|
isReturnable | Если true, возврат разрешен. |
daysToReturn | Возврат разрешен в течение этого количества дней. |
policyUrl | Ссылка на политику возврата. |
Информация о покупке
Информация о выполнении, связанная с заказом на покупку или конкретной позицией.
Представление JSON | |
---|---|
{ "id": string, "fulfillmentType": enum ( |
Поля | |
---|---|
id | Уникальный идентификатор для этой опции услуги. |
fulfillmentType | Требуется: Тип выполнения. |
expectedFulfillmentTime | Окно, если указан временной диапазон, или ETA, если указано одно время. Ожидаемое время доставки или самовывоза. |
expectedPreparationTime | Окно, если указан временной диапазон, или ETA, если указано одно время. Ожидаемое время для приготовления еды. Предпочтительно разовое. |
location | Пункт самовывоза или доставки. |
expireTime | Время, когда этот вариант выполнения истекает. Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: |
price | Стоимость этого варианта. |
fulfillmentContact | Контакт пользователя для этого выполнения. |
shippingMethodName | Название выбранного пользователем способа доставки. |
storeCode | StoreCode местоположения. Пример: Walmart — продавец, а storeCode — магазин Walmart, в котором произошло исполнение. https://support.google.com/business/answer/3370250?ref_topic=4596653 . |
pickupInfo | Дополнительная информация о том, как будет комплектоваться заказ. Это поле применимо только в том случае, если тип выполнения — PICKUP. |
Тип
Тип исполнения.
перечисления | |
---|---|
TYPE_UNSPECIFIED | Тип не указан. |
DELIVERY | Этот заказ будет доставлен. |
PICKUP | Этот заказ нужно забрать. |
Время
Конструкция времени для представления времени события, используемого при отображении заказа пользователю.
Представление JSON | |
---|---|
{ "timeIso8601": string } |
Поля | |
---|---|
timeIso8601 | Представляет время события заказа, например время резервирования, время доставки и т. д. Может быть продолжительность (время начала и окончания), просто дата, дата и время и т. д. См. https://en.wikipedia.org/wiki/ISO_8601 для всех поддерживаемых форматов. |
PickupInfo
Подробная информация о том, как забрать заказ. Он включает такие сведения, как тип пикапа и дополнительные метаданные, прикрепленные к каждому типу, если таковые имеются.
Представление JSON | |
---|---|
{ "pickupType": enum ( |
Поля | |
---|---|
pickupType | Способ получения, такой как INSTORE, CURBSIDE и т. д. |
curbsideInfo | Детали, относящиеся к информации обочины. Если pickupType не равен "CURBSIDE", это поле будет проигнорировано. |
checkInInfo[] | Список различных методов, поддерживаемых партнером для поддержки регистрации. |
PickupType
Список поддерживаемых типов пикапов.
перечисления | |
---|---|
UNSPECIFIED | Тип подхвата не указан. |
INSTORE | Забрать еду в ресторане. |
CURBSIDE | Припаркуйте автомобиль в специально отведенном месте за пределами ресторана, и кто-нибудь доставит туда еду. |
CurbsideИнформация
Подробности о том, как будет обеспечиваться порядок на обочине.
Представление JSON | |
---|---|
{ "curbsideFulfillmentType": enum ( |
Поля | |
---|---|
curbsideFulfillmentType | Партнерам нужна дополнительная информация, чтобы облегчить доставку заказов на обочину. В зависимости от того, какой тип выполнения выбран, от пользователя будут собираться соответствующие данные. |
userVehicle | Информация о транспортном средстве пользователя, размещающего заказ. |
CurbsideFulfillmentType
Возможные значения типов выполнения у обочины.
перечисления | |
---|---|
UNSPECIFIED | Тип выполнения обочины не указан. |
VEHICLE_DETAIL | Информация о транспортном средстве, необходимая для облегчения погрузки на обочине. |
Транспортное средство
Подробно о транспортном средстве
Представление JSON | |
---|---|
{
"make": string,
"model": string,
"licensePlate": string,
"colorName": string,
"image": {
object ( |
Поля | |
---|---|
make | Марка автомобиля (например, "Honda"). Это отображается пользователю и должно быть локализовано. Необходимый. |
model | Модель автомобиля (например, "Гром"). Это отображается пользователю и должно быть локализовано. Необходимый. |
licensePlate | Номерной знак транспортного средства (например, «1ABC234»). Необходимый. |
colorName | Название цвета автомобиля, например. черный опционально. |
image | URL-адрес фотографии автомобиля. Фотография будет отображаться размером примерно 256x256px. Должен быть jpg или png. Необязательный. |
CheckInInfo
Метаданные, необходимые партнеру для поддержки метода возврата.
Представление JSON | |
---|---|
{
"checkInType": enum ( |
Поля | |
---|---|
checkInType | Метод, используемый для отправки инструкций по регистрации. |
CheckInType
Различные методы, используемые для отправки инструкций по регистрации.
перечисления | |
---|---|
CHECK_IN_TYPE_UNSPECIFIED | Неизвестное значение. |
EMAIL | Информация о регистрации будет отправлена по электронной почте. |
SMS | Информация о регистрации будет отправлена по SMS. |
ПунктОпция
Представляет надстройки или подэлементы.
Представление JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
Поля | |
---|---|
id | Для опций, являющихся элементами, уникальный идентификатор элемента. |
name | Название опции. |
prices[] | Полная стоимость опциона. |
note | Примечание, связанное с опцией. |
quantity | Для опций, которые являются предметами, количество. |
productId | Идентификатор продукта или предложения, связанный с этой опцией. |
subOptions[] | Для определения других вложенных подопций. |
Информация о продукте
Подробности о продукте.
Представление JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
Поля | |
---|---|
productId | Идентификатор продукта или предложения, связанный с этой позицией. |
gtin | Глобальный номер предмета торговли продукта. Полезно, если offerId отсутствует в Merchant Center. Необязательный. |
plu | Коды поиска цены, обычно называемые кодами PLU, номерами PLU, PLU, кодами продуктов или этикетками продуктов, представляют собой систему номеров, которые однозначно идентифицируют оптовые продукты, продаваемые в продуктовых магазинах и супермаркетах. |
productType | Категория товара определяется продавцом. Например, «Дом > Бакалея > Молочные продукты и яйца > Молоко > Цельное молоко» |
productAttributes | Информация о продукте, предоставленная продавцом, например { "аллерген": "арахис" }. Полезно, если offerId отсутствует в Merchant Center. Необязательный. Объект, содержащий список пар |
ReservationItemExtension
Содержимое позиции для заказов на бронирование, таких как ресторан, стрижка и т. д. Следующий идентификатор: 15.
Представление JSON | |
---|---|
{ "status": enum ( |
Поля | |
---|---|
status | Требуется: Статус бронирования. |
userVisibleStatusLabel | Требуется: Видимая пользователем метка/строка для статуса. Максимально допустимая длина составляет 50 символов. |
type | Тип бронирования. Может быть отключен, если ни один из параметров типа не применим. |
reservationTime | Время, когда услуга/событие запланировано. Может быть диапазоном времени, датой или точной датой и временем. |
userAcceptableTimeRange | Диапазон времени, приемлемый для пользователя. |
confirmationCode | Код подтверждения для этого бронирования. |
partySize | Число людей. |
staffFacilitators[] | Персональные координаторы, которые будут обслуживать бронирование. Бывший. Парикмахер. |
location | Место проведения услуги/мероприятия. |
extension | Любые дополнительные поля, которыми обмениваются продавец и Google. Объект, содержащий поля произвольного типа. Дополнительное поле |
Статус бронирования
Статус бронирования.
перечисления | |
---|---|
RESERVATION_STATUS_UNSPECIFIED | Неопределенный статус. |
PENDING | Бронирование находится на рассмотрении. |
CONFIRMED | Бронирование подтверждено. |
CANCELLED | Бронирование отменено пользователем. |
FULFILLED | Бронирование выполнено. |
CHANGE_REQUESTED | Требуется изменение бронирования |
REJECTED | Резервирование истекло или отклонено интегратором. |
Тип бронирования
Тип бронирования.
перечисления | |
---|---|
RESERVATION_TYPE_UNSPECIFIED | Неопределенный тип. |
RESTAURANT | Резервация для ресторана. |
HAIRDRESSER | Бронирование для парикмахера. |
ПерсоналФасилитатор
Информация об обслуживающем персонале.
Представление JSON | |
---|---|
{
"name": string,
"image": {
object ( |
Поля | |
---|---|
name | Имя координатора персонала. Бывший. "Джон Смит" |
image | Образы исполнителя. |
Платежные данные
Платежные данные, связанные с заказом.
Представление JSON | |
---|---|
{ "paymentResult": { object ( |
Поля | |
---|---|
paymentResult | Результат платежа, используемый интегратором для завершения транзакции. Это поле будет заполнено Actions on Google, если оформление заказа управляется Actions-on-Google. |
paymentInfo | Платежная информация о заказе, полезная для взаимодействия с пользователем. |
ОплатаРезультат
Результат платежа, используемый интегратором для завершения транзакции.
Представление JSON | |
---|---|
{ // Union field |
Поля | ||
---|---|---|
result поля объединения. Предоставляются либо платежные данные Google, либо способ оплаты продавца. result может быть только одним из следующих: | ||
googlePaymentData | Google предоставил данные о способе оплаты. Если ваш платежный процессор указан как поддерживаемый Google платежный процессор здесь: https://developers.google.com/pay/api/ Перейдите к своему платежному процессору по ссылке, чтобы узнать более подробную информацию. В противном случае обратитесь к следующей документации для получения подробной информации о полезной нагрузке. https://developers.google.com/pay/api/payment-data-cryptography | |
merchantPaymentMethodId | Продавец/Действие предоставили способ оплаты, выбранный пользователем. |
Информация о платеже
Платежная информация о сделанном заказе. Этот прототип собирает информацию, полезную для взаимодействия с пользователем.
Представление JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Поля | |
---|---|
paymentMethodDisplayInfo | Отображаемая информация о способе оплаты, используемом для транзакции. |
paymentMethodProvenance | Происхождение способа оплаты, использованного для транзакции. Пользователь мог зарегистрировать один и тот же способ оплаты как в Google, так и в магазине. |
Способ оплатыДисплейИнформация
Результат платежа, используемый интегратором для завершения транзакции.
Представление JSON | |
---|---|
{
"paymentType": enum ( |
Поля | |
---|---|
paymentType | Тип платежа. |
paymentMethodDisplayName | Видимое пользователем имя способа оплаты. Например, ВИЗА **** 1234 Расчетный счет **** 5678 |
paymentMethodVoiceName | Имя способа оплаты, которое будет произнесено пользователем для устройств с голосовым помощником. Например, «виза, оканчивающаяся на один, два, три, четыре» или «текущий счет, оканчивающийся на пять, шесть, семь, восемь». Примечание. Это оптимизированная для голоса строка, которая будет использоваться вместо paymentMethodDisplayName для устройств с голосовым помощником. Если эта строка не задана, вместо этого пользователю будет произнесено имя paymentMethodDisplayName. |
Способ оплаты
PaymentType указывает форму оплаты, используемую для метода оплаты, предоставленного Продавцом. Действие также должно предоставлять отображаемое имя для способа оплаты.
перечисления | |
---|---|
PAYMENT_TYPE_UNSPECIFIED | Неопределенный тип платежа. |
PAYMENT_CARD | Кредитная/дебетовая или предоплаченная карта. |
BANK | Способ оплаты - банковский счет. |
LOYALTY_PROGRAM | Способ оплаты - программа лояльности. |
CASH | Способ оплаты - наличные. |
GIFT_CARD | Способ оплаты - подарочная карта. |
WALLET | Кошелек третьей стороны, т.е. Paypal |
Способ оплатыПроисхождение
Представляет происхождение метода оплаты, используемого для транзакции.
перечисления | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED | Происхождение не указано. |
PAYMENT_METHOD_PROVENANCE_GOOGLE | Происхождение — Google. |
PAYMENT_METHOD_PROVENANCE_MERCHANT | Происхождение — торговое. |
Повышение
Акции/Предложения, которые были добавлены в корзину.
Представление JSON | |
---|---|
{ "coupon": string } |
Поля | |
---|---|
coupon | Требуется: код купона, применяемый к этому предложению. |
ПокупкаЗаказРасширение
Заказать расширение для закупочной вертикали. Эти свойства применимы ко всем позициям внутри заказа, если они не переопределены в позиции.
Представление JSON | |
---|---|
{ "status": enum ( |
Поля | |
---|---|
status | Требуется: Общий статус заказа. |
userVisibleStatusLabel | Видимая пользователем метка/строка для статуса. Максимально допустимая длина составляет 50 символов. |
type | Требуется: Тип покупки. |
returnsInfo | Возврат информации для заказа. |
fulfillmentInfo | Информация о выполнении заказа. |
extension | Любые дополнительные поля, которыми обмениваются продавец и Google. Объект, содержащий поля произвольного типа. Дополнительное поле |
purchaseLocationType | Место покупки (в магазине/онлайн) |
errors[] | Необязательно: Ошибки, из-за которых этот заказ был отклонен. |
PurchaseLocationType
Тип места покупки.
перечисления | |
---|---|
UNSPECIFIED_LOCATION | Неизвестное значение. |
ONLINE_PURCHASE | Все покупки куплены онлайн. |
INSTORE_PURCHASE | Все покупки в магазине. |
Ошибка покупки
Ошибки, из-за которых заказ на покупку может быть отклонен.
Представление JSON | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Обязательный: представляет детальную причину, по которой продавец отклоняет заказ. |
description | Дополнительное описание ошибки. |
entityId | Идентификатор объекта, который соответствует ошибке. Например, это может соответствовать LineItemId/ItemOptionId. |
updatedPrice | Актуально в случае ошибки типа PRICE_CHANGED/INCORRECT_PRICE. |
availableQuantity | Доступное количество сейчас. Применимо в случае AVAILABILITY_CHANGED. |
Тип ошибки
Возможные типы ошибок.
перечисления | |
---|---|
ERROR_TYPE_UNSPECIFIED | Неизвестная ошибка |
NOT_FOUND | Сущность не найдена. Возможно, это Item, FulfillmentOption, Promotion. Требуется идентификатор объекта. |
INVALID | Данные объекта недействительны. может быть Item, FulfillmentOption, Promotion. Требуется идентификатор объекта. |
AVAILABILITY_CHANGED | Товар недоступен или недостаточно для выполнения запроса. Требуется идентификатор объекта. |
PRICE_CHANGED | Цена товара отличается от цены в объекте Item. Требуется идентификатор объекта и обновленная цена. |
INCORRECT_PRICE | Ценовые ошибки в сборах, всего. Требуется идентификатор объекта и обновленная цена. |
REQUIREMENTS_NOT_MET | Не соблюдены ограничения для принятия заказа - минимальный размер корзины и т.д. |
TOO_LATE | Истек срок выполнения. |
NO_CAPACITY | Нет доступных сервисных мощностей. |
INELIGIBLE | Пользователь не имеет права размещать заказ (занесен в черный список). |
OUT_OF_SERVICE_AREA | Невозможно доставить по указанному адресу из-за пограничных правил и т. д. |
CLOSED | Ресторан закрыт для работы во время заказа. |
PROMO_NOT_APPLICABLE | Общий код ошибки для выявления всех случаев невозможности применить промокод, если ни один из приведенных ниже не подходит. Добавьте промокод в качестве идентификатора объекта. |
PROMO_NOT_RECOGNIZED | Код купона не был распознан партнером. Добавьте промокод в качестве идентификатора объекта. |
PROMO_EXPIRED | Не удалось подать заявку, так как срок действия акции истек. Добавьте промокод в качестве идентификатора объекта. |
PROMO_USER_INELIGIBLE | Текущий пользователь не имеет права на этот купон. Добавьте промокод в качестве идентификатора объекта. |
PROMO_ORDER_INELIGIBLE | Текущий заказ не подходит для этого купона. Добавьте промокод в качестве идентификатора объекта. |
UNAVAILABLE_SLOT | Слот для опережающего заказа недоступен. |
FAILED_PRECONDITION | Не соблюдены ограничения для принятия заказа - минимальный размер корзины и т.д. |
PAYMENT_DECLINED | Недействительный платеж. |
MERCHANT_UNREACHABLE | Торговец недоступен. Это помогает, когда партнер является агрегатором и не может связаться с продавцом. |
TicketOrderExtension
Содержимое заказа для заказов билетов, таких как кино, спорт и т. д.
Представление JSON | |
---|---|
{
"ticketEvent": {
object ( |
Поля | |
---|---|
ticketEvent | Событие применяется ко всем тикетам позиций. |
TicketEvent
Представляет одно событие.
Представление JSON | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Обязательно: Тип билетного мероприятия, например, кино, концерт. |
name | Обязательно: Название события. Например, если событие представляет собой фильм, это должно быть название фильма. |
description | Описание события. |
url | Ссылка на информацию о событии. |
location | Место, где происходит событие или находится организация. |
eventCharacters[] | Персонажи, связанные с этим событием. Это могут быть режиссеры или актеры кинособытия, исполнители концерта и т.д. |
startDate | Время начала. |
endDate | Время окончания. |
doorTime | Время входа, которое может отличаться от времени начала мероприятия. например, мероприятие начинается в 9 утра, но время входа в 8:30 утра. |
Тип
Тип события.
перечисления | |
---|---|
EVENT_TYPE_UNKNOWN | Неизвестный тип события. |
MOVIE | Фильм. |
CONCERT | Концерт. |
SPORTS | Виды спорта. |
СобытиеПерсонаж
Один персонаж события, например, организатор, исполнитель и т. д.
Представление JSON | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Тип персонажа события, например, актер или режиссер. |
name | Имя персонажа. |
image | Образы персонажей. |
Тип
Тип персонажа.
перечисления | |
---|---|
TYPE_UNKNOWN | Неизвестный тип. |
ACTOR | Актер. |
PERFORMER | Исполнитель. |
DIRECTOR | Директор. |
ORGANIZER | Организатор. |