- JSON-представление
- Информация о пользователе
- Номер телефона
- Изображение
- Торговец
- Расположение
- ШиротаДлительность
- Почтовый адрес
- Содержание
- Линейный элемент
- ЦенаАтрибут
- Тип
- Состояние
- Деньги
- Действие
- Тип
- Опенурлэкшн
- AndroidApp
- Фильтр версий
- UrlTypeHint
- Метаданные действия
- Раскрытие информации
- Текст раскрытия информации
- Текстовая ссылка
- Опционы раскрытия информации
- ПрезентацияТребование
- Расширение PurchaseItemExtension
- Статус покупки
- Тип покупки
- ТорговецЕдиницаМера
- Единица
- ПокупкаВозвратИнформация
- Информация о выполнении покупки
- Тип
- Время
- Информация о самовывозе
- Тип звукоснимателя
- Информация о Curbside
- Тип исполнения: CurbsideFulfillmentType
- Транспортное средство
- CheckInInfo
- Тип регистрации
- Опция элемента
- Подробности о продукте
- Расширение резервированияитемекстенсион
- Статус резервирования
- Тип бронирования
- ПерсоналФасилитатор
- Платежные данные
- Результат платежа
- Информация об оплате
- Метод оплатыDisplayInfo
- Тип платежа
- Способ оплатыПроисхождение
- Повышение
- Расширение заказа на покупку
- Тип местоположения покупки
- Ошибка покупки
- Тип ошибки
- Расширение заказа билета
- БилетСобытие
- Тип
- СобытиеПерсонаж
- Тип
Сущность заказа. Примечание. 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 «Зулу» с точностью до наносекунд. Пример: | |
lastUpdateTime | Дата и время последнего обновления заказа. Требуется для OrderUpdate. Временная метка в формате RFC3339 UTC «Зулу» с точностью до наносекунд. Пример: | |
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, как определено в Рекомендации E.164 Международного союза электросвязи (ITU). ссылка на вики: https://en.wikipedia.org/wiki/E.164 |
extension | Расширение не стандартизировано в рекомендациях ITU, за исключением того, что оно определяется как серия чисел с максимальной длиной 40 цифр. Здесь он определяется как строка, допускающая возможное использование начального нуля в расширении (организации имеют полную свободу в этом, поскольку стандарт не определен). Помимо цифр, здесь могут храниться и некоторые другие символы набора, такие как «,» (обозначающие ожидание). Например, в ххх-ххх-хххх доб. 123, «123» — это расширение. |
preferredDomesticCarrierCode | Код выбора оператора связи, который предпочтителен при звонках на этот номер телефона внутри страны. Сюда также входят коды, которые в некоторых странах необходимо набирать при звонках со стационарных телефонов на мобильные телефоны и наоборот. Например, в Колумбии перед номером телефона необходимо набрать цифру «3» при звонке с мобильного телефона на домашний стационарный телефон и наоборот. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia 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 используется с API Places для получения сведений о месте. См. https://developers.google.com/places/web-service/place-id . |
ШиротаДлительность
Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, представляющих градусы широты и градусы долготы. Если не указано иное, оно должно соответствовать стандарту 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 | Необязательный. Обычно относится к части адреса, посвященной городу. Примеры: город в США, ИТ-коммуна, почтовый город Великобритании. В регионах мира, где населенные пункты не определены четко или не вписываются в эту структуру, оставьте locality пустым и используйте адресные строки. |
sublocality | Необязательный. Сублокальность адреса. Например, это могут быть микрорайоны, районы, районы. |
addressLines[] | Неструктурированные адресные строки, описывающие нижние уровни адреса. Поскольку значения в адресных строках не содержат информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был ясен. Порядок адресных строк должен быть «порядком конверта» для страны/региона адреса. В местах, где это может отличаться (например, в Японии), адрес_языка используется для явного указания (например, «ja» для упорядочения от большого к меньшему и «ja-Latn» или «en» для упорядочения от малого к большому). Таким образом, в зависимости от языка можно выбрать наиболее конкретную строку адреса. Минимально допустимое структурное представление адреса состоит из кода региона, а вся остальная информация помещается в строки адреса. Можно было бы очень приблизительно отформатировать такой адрес без геокодирования, но никакие семантические рассуждения не могли быть сделаны ни о каком из компонентов адреса, пока он не был хотя бы частично решен. Создание адреса, содержащего только регионКод и адресные строки, а затем геокодирование — рекомендуемый способ обработки полностью неструктурированных адресов (в отличие от угадывания, какие части адреса должны быть населенными пунктами или административными областями). |
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 поля Union. Представляет либо денежную сумму, либо миллипроценты. 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 | Ссылка на направление. |
Опенурлэкшн
Открывает указанный 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]. Нулевой диапазон подразумевает любую версию. Примеры. Чтобы указать одну версию, используйте: [target_version:target_version]. Чтобы указать любую версию, оставьте minVersion и maxVersion неуказанными. Чтобы указать все версии до maxVersion, оставьте minVersion неуказанным. Чтобы указать все версии из minVersion, оставьте maxVersion неуказанным. |
UrlTypeHint
Различные типы подсказок URL.
Перечисления | |
---|---|
URL_TYPE_HINT_UNSPECIFIED | Не указано |
AMP_CONTENT | URL-адрес, указывающий непосредственно на контент AMP, или канонический URL-адрес, который ссылается на контент AMP через <link rel="amphtml">. |
Метаданные действия
Связанные метаданные для каждого действия.
JSON-представление | |
---|---|
{ "expireTime": string } |
Поля | |
---|---|
expireTime | Время истечения срока действия этого действия. Временная метка в формате RFC3339 UTC «Зулу» с точностью до наносекунд. Пример: |
Раскрытие информации
Информация о продукте, услуге или политике, которая может быть представлена пользователю.
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 | Раскрытие информации является обязательным. Разговор будет переведен на телефон, если устройство не поддерживает отображение раскрытой информации. |
Расширение PurchaseItemExtension
Содержимое позиции вертикальной закупки.
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» может иметь разное значение в разных контекстах. Для заказа ЕДА это может быть приготовление еды. Для розничной торговли это может быть упаковка товара. |
CREATED | Порядок создан. |
CONFIRMED | Продавец подтвердил заказ. |
REJECTED | Продавец отклонил заказ или позицию. |
RETURNED | Товар был возвращен пользователем. |
CANCELLED | Заказ или позиция были отменены пользователем. |
CHANGE_REQUESTED | Пользователь запросил изменение заказа, и интегратор обрабатывает это изменение. После обработки запроса заказ должен быть переведен в другое состояние. |
Тип покупки
Категория покупки.
Перечисления | |
---|---|
PURCHASE_TYPE_UNSPECIFIED | Неизвестное значение. |
RETAIL | Сюда входят покупки, такие как физические товары. |
FOOD | В стоимость входит покупка еды по заказу. |
GROCERY | Покупка продуктов. |
MOBILE_RECHARGE | Предоплаченная покупка пополнения мобильного телефона. |
ТорговецЕдиницаМера
Мера ценообразования торговой единицы.
JSON-представление | |
---|---|
{
"measure": number,
"unit": enum ( |
Поля | |
---|---|
measure | Значение: Пример 1.2. |
unit | Единица: Пример ФУНТ, ГРАММ. |
Единица
Перечисления | |
---|---|
UNIT_UNSPECIFIED | Единица не указана. |
MILLIGRAM | Миллиграмм. |
GRAM | Грамм. |
KILOGRAM | Килограмм. |
OUNCE | Унция. |
POUND | Фунт. |
ПокупкаВозвратИнформация
Возвращает информацию, связанную с заказом или конкретной позицией.
JSON-представление | |
---|---|
{ "isReturnable": boolean, "daysToReturn": number, "policyUrl": string } |
Поля | |
---|---|
isReturnable | Если это правда, возврат разрешен. |
daysToReturn | Возврат разрешен в течение этого количества дней. |
policyUrl | Ссылка на политику возврата. |
Информация о выполнении покупки
Информация о выполнении, связанная с заказом на покупку или конкретной позицией.
JSON-представление | |
---|---|
{ "id": string, "fulfillmentType": enum ( |
Поля | |
---|---|
id | Уникальный идентификатор для этого варианта услуги. |
fulfillmentType | Обязательно: Тип выполнения. |
expectedFulfillmentTime | Окно, если указан временной диапазон, или ETA, если указано одно время. Ожидаемое время доставки или самовывоза. |
expectedPreparationTime | Окно, если указан временной диапазон, или ETA, если указано одно время. Ожидаемое время приготовления еды. Предпочтительно одноразовое. |
location | Место самовывоза или доставки. |
expireTime | Время, когда истекает срок действия этой возможности выполнения. Временная метка в формате RFC3339 UTC «Зулу» с точностью до наносекунд. Пример: |
price | Стоимость этого варианта. |
fulfillmentContact | Контакт пользователя для этого выполнения. |
shippingMethodName | Название способа доставки, выбранного пользователем. |
storeCode | StoreCode местоположения. Пример: Walmart — это продавец, а storeCode — это магазин Walmart, в котором произошло выполнение. https://support.google.com/business/answer/3370250?ref_topic=4596653 . |
pickupInfo | Дополнительная информация о том, как будет собираться заказ. Это поле применимо только в том случае, если тип выполнения — САМОВЫВОЗ. |
Тип
Тип исполнения.
Перечисления | |
---|---|
TYPE_UNSPECIFIED | Тип не указан. |
DELIVERY | Этот заказ будет доставлен. |
PICKUP | Этот заказ необходимо забрать. |
Время
Конструкция Time, представляющая время события, которое будет использоваться при отображении заказа пользователю.
JSON-представление | |
---|---|
{ "timeIso8601": string } |
Поля | |
---|---|
timeIso8601 | Представляет время события заказа, например время резервирования, время доставки и т. д. Это может быть продолжительность (время начала и окончания), просто дата, дата и т. д. См. https://en.wikipedia.org/wiki/ISO_8601 для всех поддерживаемых форматов. |
Информация о самовывозе
Подробности о том, как забрать заказ. Он включает такие сведения, как тип получения и дополнительные метаданные, прикрепленные к каждому типу, если таковые имеются.
JSON-представление | |
---|---|
{ "pickupType": enum ( |
Поля | |
---|---|
pickupType | Способ получения, например INSTORE, CURBSIDE и т. д. |
curbsideInfo | Подробности, относящиеся к информации на обочине. Если тип PickupType не «CURBSIDE», это поле будет игнорироваться. |
checkInInfo[] | Список различных методов, поддерживаемых партнером для поддержки регистрации. |
Тип звукоснимателя
Список поддерживаемых типов звукоснимателей.
Перечисления | |
---|---|
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 | Марка автомобиля (например, «Хонда»). Это отображается пользователю и должно быть локализовано. Необходимый. |
model | Модель автомобиля (например, «Гром»). Это отображается пользователю и должно быть локализовано. Необходимый. |
licensePlate | Номерной знак автомобиля (например, «1ABC234»). Необходимый. |
colorName | Название цвета автомобиля, например. черный Опционально. |
image | URL-адрес фотографии автомобиля. Фотография будет отображаться с размером примерно 256x256 пикселей. Должен быть в формате jpg или png. Необязательный. |
CheckInInfo
Метаданные, необходимые партнеру для поддержки метода возврата.
JSON-представление | |
---|---|
{
"checkInType": enum ( |
Поля | |
---|---|
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. Необязательный. Объект, содержащий список пар |
Расширение резервированияитемекстенсион
Содержимое позиции для заказов на резервирование, таких как ресторан, стрижка и т. д. Следующий идентификатор: 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/pay-data-cryptography | |
merchantPaymentMethodId | Продавец/Действие предоставил способ оплаты, выбранный пользователем. |
Информация об оплате
Платежная информация по выполняемому заказу. Этот прототип собирает информацию, полезную для взаимодействия с пользователем.
JSON-представление | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Поля | |
---|---|
paymentMethodDisplayInfo | Отображаемая информация о способе оплаты, использованном для транзакции. |
paymentMethodProvenance | Происхождение способа оплаты, использованного для транзакции. Пользователь мог зарегистрировать один и тот же способ оплаты как в Google, так и в продавце. |
Метод оплатыDisplayInfo
Результат платежа, используемый интегратором для завершения транзакции.
JSON-представление | |
---|---|
{
"paymentType": enum ( |
Поля | |
---|---|
paymentType | Тип платежа. |
paymentMethodDisplayName | Видимое пользователю название способа оплаты. Например, VISA **** 1234 Проверка счета **** 5678 |
paymentMethodVoiceName | Название способа оплаты, которое будет сообщено пользователю на устройствах с голосовым помощником. Например, «виза заканчивается на один, два, три, четыре» или «текущий счет, заканчивающийся на пять, шесть, семь, восемь». Примечание. Это строка, оптимизированная для голосовой связи, которая будет использоваться вместо payMethodDisplayName для устройств голосового помощника. Если эта строка не задана, вместо этого пользователю будет сообщено имя платежаMethodDisplayName. |
Тип платежа
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[] | Необязательно: ошибки, из-за которых этот заказ был отклонен. |
Тип местоположения покупки
Тип места покупки.
Перечисления | |
---|---|
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 | Цена товара отличается от цены в сущности «Товар». Требуется идентификатор объекта и обновленная цена. |
INCORRECT_PRICE | Ошибки цен в сборах, итого. Требуется идентификатор объекта и обновленная цена. |
REQUIREMENTS_NOT_MET | Не соблюдены ограничения на прием заказа - минимальный размер корзины и т. д. |
TOO_LATE | Срок действия опции FulfillmentOption истек. |
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 | Торговец недоступен. Это помогает, когда партнер является агрегатором и не смог связаться с продавцом. |
Расширение заказа билета
Содержание заказа для заказов билетов, таких как кино, спорт и т. д.
JSON-представление | |
---|---|
{
"ticketEvent": {
object ( |
Поля | |
---|---|
ticketEvent | Событие применимо ко всем билетам отдельных позиций. |
БилетСобытие
Представляет одно событие.
JSON-представление | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Обязательно: тип билета на мероприятие, например, фильм, концерт. |
name | Обязательно: Название мероприятия. Например, если событие представляет собой фильм, это должно быть название фильма. |
description | Описание события. |
url | 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 | Организатор. |