Transactions API станет устаревшим 3 мая 2023 года, а 13 июня 2023 года прекращается действие диалоговых действий. Дополнительные сведения см. в разделе Прекращение диалоговых действий .

Order

Сущность заказа. Примечание. 1. Все строки на всех уровнях должны содержать менее 1000 символов, если не указано иное. 2. Количество повторяющихся полей на всех уровнях должно быть меньше 50, если не указано иное. 3. Все временные метки на всех уровнях, если они указаны, должны быть действительными временными метками.

Представление JSON
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
Поля
googleOrderId

string

Идентификатор заказа, назначенный Google.

merchantOrderId

string

Требуется: Продавец назначает внутренний идентификатор заказа. Этот идентификатор должен быть уникальным и требуется для последующих операций обновления заказа. Этот идентификатор может быть установлен равным предоставленному googleOrderId или любому другому уникальному значению. Обратите внимание, что идентификатор, представленный пользователям, — это userVisibleOrderId, который может быть другим, более удобным для пользователя значением. Максимально допустимая длина составляет 128 символов.

userVisibleOrderId

string

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

userVisibleStateLabel
(deprecated)

string

Устарело: вместо этого используйте статус OrderExtensions. Видимая пользователем метка для состояния этого заказа.

buyerInfo

object ( UserInfo )

Информация о покупателе.

image

object ( Image )

Изображение, связанное с заказом.

createTime

string ( Timestamp format)

Обязательно: Дата и время создания заказа.

Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: "2014-10-02T15:01:23.045123456Z" .

lastUpdateTime

string ( Timestamp format)

Дата и время последнего обновления заказа. Требуется для обновления заказа.

Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: "2014-10-02T15:01:23.045123456Z" .

transactionMerchant

object ( Merchant )

Продавец, который упростил оформление заказа. Это может отличаться от поставщика уровня позиции. Пример: заказ Expedia с позицией от ANA.

contents

object ( Contents )

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

priceAttributes[]

object ( PriceAttribute )

Цена, скидки, налоги и так далее.

followUpActions[]

object ( Action )

Последующие действия на уровне заказа.

paymentData

object ( PaymentData )

Данные, связанные с оплатой заказа.

termsOfServiceUrl

string

Ссылка на условия обслуживания, применимые к заказу/предлагаемому заказу.

note

string

Примечания к заказу.

promotions[]

object ( Promotion )

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

disclosures[]

object ( Disclosure )

Раскрытие информации, связанное с этим заказом.

vertical
(deprecated)

object

Устарело: вместо этого используйте вертикали. Эти свойства будут применяться ко всем позициям, если они не переопределены в какой-либо позиции. Эта вертикаль должна соответствовать типу вертикали уровня позиции. Возможные значения: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

Объект, содержащий поля произвольного типа. Дополнительное поле "@type" содержит URI, идентифицирующий тип. Пример: { "id": 1234, "@type": "types.example.com/standard/id" } .

Объединение полевых verticals . Эти свойства будут применяться ко всем позициям, если они не переопределены в какой-либо позиции. Эта вертикаль должна соответствовать типу вертикали уровня позиции. verticals могут быть только одним из следующих:
purchase

object ( PurchaseOrderExtension )

Заказ на покупку

ticket

object ( TicketOrderExtension )

Заказ билетов

Информация о пользователе

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

Представление JSON
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
Поля
email

string

Электронная почта пользователя, например: janedoe@gmail.com .

firstName

string

Имя пользователя.

lastName

string

Фамилия пользователя.

displayName

string

Отображаемое имя пользователя может отличаться от имени или фамилии.

phoneNumbers[]

object ( PhoneNumber )

Номера телефонов пользователя.

Номер телефона

Стандартное представление номера телефона.

Представление JSON
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
Поля
e164PhoneNumber

string

Номер телефона в формате E.164, как определено в Рекомендации Международного союза электросвязи (ITU) E.164. вики-ссылка: https://en.wikipedia.org/wiki/E.164

extension

string

Расширение не стандартизировано в рекомендациях ITU, за исключением того, что оно определяется как серия чисел с максимальной длиной 40 цифр. Здесь он определяется как строка, чтобы учесть возможное использование начального нуля в расширении (организации имеют полную свободу действий, поскольку стандарт не определен). Помимо цифр, здесь могут храниться некоторые другие символы набора номера, такие как "," (указывающие на ожидание). Например, в ххх-ххх-хххх доб. 123, "123" - расширение.

preferredDomesticCarrierCode

string

Код выбора оператора, который является предпочтительным при звонках на этот номер телефона внутри страны. Сюда также входят коды, которые необходимо набирать в некоторых странах при звонках со стационарных телефонов на мобильные и наоборот. Например, в Колумбии цифру «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

string

Исходный URL изображения. Изображения могут быть в формате JPG, PNG и GIF (анимированные и неанимированные). Например, https://www.agentx.com/logo.png . Необходимый.

accessibilityText

string

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

height

number

Высота изображения в пикселях. Необязательный.

width

number

Ширина изображения в пикселях. Необязательный.

Торговец

Продавец для корзины/заказа/позиции.

Представление JSON
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
Поля
id

string

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

name

string

Имя торговца похоже на "Панера Хлеб".

image

object ( Image )

Образ, связанный с торговцем.

phoneNumbers[]

object ( PhoneNumber )

Телефоны продавца.

address

object ( Location )

Адрес продавца.

Расположение

Контейнер, представляющий местоположение.

Представление JSON
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
Поля
coordinates

object ( LatLng )

Географические координаты. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

formattedAddress

string

Отображаемый адрес, например, «1600 Amphitheatre Pkwy, Mountain View, CA 94043». Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

zipCode

string

Почтовый индекс. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] или [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

city

string

Город. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] или [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

postalAddress

object ( PostalAddress )

Почтовый адрес. Требуется разрешение [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] или [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

name

string

Название места.

phoneNumber

string

Номер телефона местоположения, например, контактный номер офиса или номер телефона места доставки.

notes

string

Заметки о месте.

placeId

string

placeId используется с Places API для получения сведений о месте. См. https://developers.google.com/places/web-service/place-id .

LatLng

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

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

number

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

longitude

number

Долгота в градусах. Он должен быть в диапазоне [-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

number

Версия схемы PostalAddress . Это должно быть установлено на 0, что является последней версией.

Все новые версии должны быть обратно совместимы со старыми версиями.

regionCode

string

Необходимый. Код региона CLDR страны/региона адреса. Это никогда не выводится, и пользователь должен убедиться, что значение правильное. Подробности см. на http://cldr.unicode.org/ и http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html . Пример: "CH" для Швейцарии.

languageCode

string

Необязательный. Код языка BCP-47 содержимого этого адреса (если известен). Часто это язык пользовательского интерфейса формы ввода или ожидается, что он будет соответствовать одному из языков, используемых в стране/регионе адреса, или их транслитерированным эквивалентам. Это может повлиять на форматирование в некоторых странах, но не критично для правильности данных и никогда не повлияет на проверку или другие операции, не связанные с форматированием.

Если это значение неизвестно, его следует опустить (вместо указания возможно неправильного значения по умолчанию).

Примеры: «ж-хант», «джа», «джа-латн», «эн».

postalCode

string

Необязательный. Почтовый индекс адреса. Не во всех странах используются или требуются почтовые индексы, но там, где они используются, они могут инициировать дополнительную проверку с другими частями адреса (например, проверка штата/почтового индекса в США).

sortingCode

string

Необязательный. Дополнительный код сортировки для конкретной страны. В большинстве регионов не используется. Там, где он используется, значение представляет собой либо строку, например «CEDEX», за которой может следовать число (например, «CEDEX 7»), либо просто число, представляющее «код сектора» (Ямайка), «указатель области доставки». (Малави) или "указатель почтового отделения" (например, Кот-д'Ивуар).

administrativeArea

string

Необязательный. Высшая административная единица, которая используется для почтовых адресов страны или региона. Например, это может быть штат, провинция, область или префектура. В частности, для Испании это провинция, а не автономное сообщество (например, «Барселона», а не «Каталония»). Многие страны не используют административный район в почтовых адресах. Например, в Швейцарии его следует оставить незаселенным.

locality

string

Необязательный. Обычно относится к городской части адреса. Примеры: город США, IT-коммуна, почтовый город Великобритании. В регионах мира, где населенные пункты плохо определены или плохо вписываются в эту структуру, оставьте поле населенного пункта пустым и используйте адресные строки.

sublocality

string

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

addressLines[]

string

Неструктурированные адресные строки, описывающие нижние уровни адреса.

Поскольку значения в addressLines не имеют информации о типе и иногда могут содержать несколько значений в одном поле (например, «Остин, Техас»), важно, чтобы порядок строк был четким. Порядок адресных строк должен быть «конвертным» для страны/региона адреса. В местах, где это может варьироваться (например, в Японии), address_language используется, чтобы сделать его явным (например, «ja» для упорядочения от большого к меньшему и «ja-Latn» или «en» для упорядочения от маленького к большому). Таким образом, наиболее конкретная строка адреса может быть выбрана в зависимости от языка.

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

Создание адреса, содержащего только regionCode и addressLines, а затем геокодирование — рекомендуемый способ обработки полностью неструктурированных адресов (в отличие от угадывания, какие части адреса должны быть населенными пунктами или административными областями).

recipients[]

string

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

organization

string

Необязательный. Название организации по адресу.

Содержание

Обертка для позиций.

Представление JSON
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
Поля
lineItems[]

object ( LineItem )

Список позиций заказа. Требуется хотя бы 1 line_item, разрешено не более 50. Все позиции должны принадлежать одной вертикали.

Позиция

Одна позиция содержит одну вертикаль. В заказе или корзине может быть несколько позиций одной вертикали. Элементы подстроки/дополнения и т. д. должны быть определены в вертикальных прототипах в зависимости от вариантов их использования. Примечание. 1. Все строки на всех уровнях должны содержать менее 1000 символов, если не указано иное. 2. Количество повторяющихся полей на всех уровнях должно быть меньше 50, если не указано иное. 3. Все временные метки на всех уровнях, если они указаны, должны быть действительными временными метками.

Представление JSON
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
Поля
id

string

Требуется: Идентификатор позиции, назначенный продавцом. Используется для идентификации существующей позиции при применении частичных обновлений. Максимально допустимая длина составляет 64 символа.

name

string

Название позиции, отображаемое в квитанции. Максимально допустимая длина составляет 100 символов.

userVisibleStateLabel
(deprecated)

string

Устарело. Вместо этого используйте статус вертикального уровня. Например, для покупок используйте PurchaseOrderExtension.status. Видимый пользователем ярлык для состояния этой позиции.

provider

object ( Merchant )

Поставщик конкретной позиции, если он отличается от общего заказа. Пример: заказ Expedia с поставщиком позиции ANA.

priceAttributes[]

object ( PriceAttribute )

Цена и корректировки на уровне позиции.

followUpActions[]

object ( Action )

Последующие действия в позиции.

recipients[]

object ( UserInfo )

Клиенты на уровне позиции, это может отличаться от покупателя на уровне заказа. Пример: Пользователь X забронировал столик в ресторане на имя пользователя Y.

image

object ( Image )

Небольшое изображение, связанное с этим элементом, если таковое имеется.

description

string

Описание позиции.

notes[]

string

Дополнительные примечания, применимые к этой конкретной позиции, например правила отмены.

disclosures[]

object ( Disclosure )

Раскрытие информации, связанное с этой строкой.

vertical
(deprecated)

object

Устарело: вместо этого используйте вертикали. Требуется: семантическое содержание позиции в зависимости от ее типа/вертикали. Каждая вертикаль должна включать свои детали исполнения. Должно быть одно из следующих значений: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

Объект, содержащий поля произвольного типа. Дополнительное поле "@type" содержит URI, идентифицирующий тип. Пример: { "id": 1234, "@type": "types.example.com/standard/id" } .

Объединение полевых verticals . Требуется: семантическое содержание позиции в зависимости от ее типа/вертикали. Каждая вертикаль должна включать свои детали исполнения. verticals могут быть только одним из следующих:
purchase

object ( PurchaseItemExtension )

Заказы на покупку, такие как товары, продукты питания и т. д.

reservation

object ( ReservationItemExtension )

Бронирование заказов, таких как ресторан, стрижка и т. д.

ЦенаАтрибут

Ценовой атрибут заказа или позиции.

Представление JSON
{
  "type": enum (Type),
  "name": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": number
  // End of list of possible types for union field spec.
}
Поля
type

enum ( Type )

Требуется: Тип денежного атрибута.

name

string

Обязательно: Отображаемая пользователем строка атрибута цены. Это отправляется и локализуется продавцом.

state

enum ( State )

Требуется: Состояние цены: расчетное и фактическое.

taxIncluded

boolean

Включает ли цена налог.

spec поля союза. Представляет либо денежную сумму, либо миллипроценты. spec может быть только одним из следующих:
amount

object ( Money )

Денежная сумма.

amountMillipercentage
(deprecated)

number

Спецификация в процентах с точностью до 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

string

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

amountInMicros

string ( int64 format)

Сумма в микро. Например, это поле должно быть установлено как 1990000 за 1,99 доллара США.

Действие

Последующее действие, связанное с заказом или позицией.

Представление JSON
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
Поля
type

enum ( Type )

Требуется: Тип действия.

title

string

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

openUrlAction

object ( OpenUrlAction )

Действия, которые необходимо предпринять.

actionMetadata

object ( 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 (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
Поля
url

string

Поле URL-адреса, которое может быть любым из: - URL-адреса http/https для открытия приложения, связанного с приложением, или веб-страницы.

androidApp

object ( AndroidApp )

Информация о приложении Android, если ожидается, что URL-адрес будет выполнен приложением Android.

urlTypeHint

enum ( UrlTypeHint )

Указывает подсказку для типа URL.

AndroidApp

Спецификация приложения Android для ограничений выполнения

Представление JSON
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
Поля
packageName

string

Имя пакета Имя пакета должно быть указано при указании Android Fulfillment.

versions[]

object ( VersionFilter )

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

ВерсияФильтр

VersionFilter должен быть включен, если требуются определенные версии приложения.

Представление JSON
{
  "minVersion": number,
  "maxVersion": number
}
Поля
minVersion

number

Минимальный код версии или 0 включительно.

maxVersion

number

Код максимальной версии включительно. Рассматриваемый диапазон — [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

string ( Timestamp format)

Время, когда это действие истечет.

Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: "2014-10-02T15:01:23.045123456Z" .

Раскрытие информации

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

Представление JSON
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
Поля
title

string

Название раскрытия. Пример: «Информация по безопасности».

disclosureText

object ( DisclosureText )

Содержание раскрытия. Веб-ссылки разрешены.

presentationOptions

object ( DisclosurePresentationOptions )

Варианты представления для раскрытия.

Раскрытие текста

Представляет собой обычный текст с веб-ссылками.

Представление JSON
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
Поля
template

string

Отображаемый текст, содержащий заполнители, такие как "{0}" и "{1}", для каждой текстовой ссылки, которую необходимо вставить. Пример: «ВНИМАНИЕ! Этот продукт может подвергнуть вас воздействию химических веществ, которые, как известно в штате Калифорния, вызывают рак. Для получения дополнительной информации перейдите на страницу {0}». Этот текст раскрытия информации не должен содержать рекламного или рекламного содержания.

РаскрытиеПрезентацияПараметры

Варианты представления раскрытия информации.

Представление JSON
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
Поля
presentationRequirement

enum ( PresentationRequirement )

Требование к представлению раскрытия.

initiallyExpanded

boolean

Следует ли изначально расширить содержание раскрытия. По умолчанию он изначально свернут.

ПрезентацияТребование

Требование к представлению раскрытия.

перечисления
REQUIREMENT_UNSPECIFIED Неопределенное требование. Не следует устанавливать это явно.
REQUIREMENT_OPTIONAL Раскрытие не является обязательным. Его можно пропустить, если устройство не поддерживает показ раскрытий.
REQUIREMENT_REQUIRED Раскрытие требуется. Разговор будет переведен на телефон, если устройство не поддерживает показ раскрытий.

ПокупкаItemExtension

Содержание позиции Вертикаль покупки.

Представление JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
Поля
status

enum ( PurchaseStatus )

Обязательно: статус на уровне позиции.

userVisibleStatusLabel

string

Требуется: Видимая пользователем метка/строка для статуса. Максимально допустимая длина составляет 50 символов.

type

enum ( PurchaseType )

Требуется: Тип покупки.

productId
(deprecated)

string

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

quantity

number

Количество товара.

unitMeasure

object ( MerchantUnitMeasure )

Единица измерения. Определяет размер элемента в выбранных единицах. Размер вместе с активной ценой используется для определения цены за единицу.

returnsInfo

object ( PurchaseReturnsInfo )

Возвращает информацию для этой позиции. Если не задано, эта позиция наследует уровень заказа, возвращает информацию.

fulfillmentInfo

object ( PurchaseFulfillmentInfo )

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

itemOptions[]

object ( ItemOption )

Дополнительные дополнения или подпункты.

extension

object

Любые дополнительные поля, которыми обмениваются продавец и Google.

Объект, содержащий поля произвольного типа. Дополнительное поле "@type" содержит URI, идентифицирующий тип. Пример: { "id": 1234, "@type": "types.example.com/standard/id" } .

productDetails

object ( 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 (Unit)
}
Поля
measure

number

Значение: Пример 1.2.

unit

enum ( Unit )

Единица измерения: Пример: ФУНТ, ГРАММ.

Единица

перечисления
UNIT_UNSPECIFIED Единица не указана.
MILLIGRAM Миллиграмм.
GRAM грамм.
KILOGRAM Килограмм.
OUNCE Унция.
POUND Фунт.

ПокупкаВозвратИнформация

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

Представление JSON
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
Поля
isReturnable

boolean

Если true, возврат разрешен.

daysToReturn

number

Возврат разрешен в течение этого количества дней.

policyUrl

string

Ссылка на политику возврата.

Информация о покупке

Информация о выполнении, связанная с заказом на покупку или конкретной позицией.

Представление JSON
{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}
Поля
id

string

Уникальный идентификатор для этой опции услуги.

fulfillmentType

enum ( Type )

Требуется: Тип выполнения.

expectedFulfillmentTime

object ( Time )

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

expectedPreparationTime

object ( Time )

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

location

object ( Location )

Пункт самовывоза или доставки.

expireTime

string ( Timestamp format)

Время, когда этот вариант выполнения истекает.

Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: "2014-10-02T15:01:23.045123456Z" .

price

object ( PriceAttribute )

Стоимость этого варианта.

fulfillmentContact

object ( UserInfo )

Контакт пользователя для этого выполнения.

shippingMethodName

string

Название выбранного пользователем способа доставки.

storeCode

string

StoreCode местоположения. Пример: Walmart — продавец, а storeCode — магазин Walmart, в котором произошло исполнение. https://support.google.com/business/answer/3370250?ref_topic=4596653 .

pickupInfo

object ( PickupInfo )

Дополнительная информация о том, как будет комплектоваться заказ. Это поле применимо только в том случае, если тип выполнения — PICKUP.

Тип

Тип исполнения.

перечисления
TYPE_UNSPECIFIED Тип не указан.
DELIVERY Этот заказ будет доставлен.
PICKUP Этот заказ нужно забрать.

Время

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

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

string

Представляет время события заказа, например время резервирования, время доставки и т. д. Может быть продолжительность (время начала и окончания), просто дата, дата и время и т. д. См. https://en.wikipedia.org/wiki/ISO_8601 для всех поддерживаемых форматов.

PickupInfo

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

Представление JSON
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
Поля
pickupType

enum ( PickupType )

Способ получения, такой как INSTORE, CURBSIDE и т. д.

curbsideInfo

object ( CurbsideInfo )

Детали, относящиеся к информации обочины. Если pickupType не равен "CURBSIDE", это поле будет проигнорировано.

checkInInfo[]

object ( CheckInInfo )

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

PickupType

Список поддерживаемых типов пикапов.

перечисления
UNSPECIFIED Тип подхвата не указан.
INSTORE Забрать еду в ресторане.
CURBSIDE Припаркуйте автомобиль в специально отведенном месте за пределами ресторана, и кто-нибудь доставит туда еду.

CurbsideИнформация

Подробности о том, как будет обеспечиваться порядок на обочине.

Представление JSON
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
Поля
curbsideFulfillmentType

enum ( CurbsideFulfillmentType )

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

userVehicle

object ( Vehicle )

Информация о транспортном средстве пользователя, размещающего заказ.

CurbsideFulfillmentType

Возможные значения типов выполнения у обочины.

перечисления
UNSPECIFIED Тип выполнения обочины не указан.
VEHICLE_DETAIL Информация о транспортном средстве, необходимая для облегчения погрузки на обочине.

Транспортное средство

Подробно о транспортном средстве

Представление JSON
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
Поля
make

string

Марка автомобиля (например, "Honda"). Это отображается пользователю и должно быть локализовано. Необходимый.

model

string

Модель автомобиля (например, "Гром"). Это отображается пользователю и должно быть локализовано. Необходимый.

licensePlate

string

Номерной знак транспортного средства (например, «1ABC234»). Необходимый.

colorName

string

Название цвета автомобиля, например. черный опционально.

image

object ( Image )

URL-адрес фотографии автомобиля. Фотография будет отображаться размером примерно 256x256px. Должен быть jpg или png. Необязательный.

CheckInInfo

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

Представление JSON
{
  "checkInType": enum (CheckInType)
}
Поля
checkInType

enum ( CheckInType )

Метод, используемый для отправки инструкций по регистрации.

CheckInType

Различные методы, используемые для отправки инструкций по регистрации.

перечисления
CHECK_IN_TYPE_UNSPECIFIED Неизвестное значение.
EMAIL Информация о регистрации будет отправлена ​​по электронной почте.
SMS Информация о регистрации будет отправлена ​​по SMS.

ПунктОпция

Представляет надстройки или подэлементы.

Представление JSON
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
Поля
id

string

Для опций, являющихся элементами, уникальный идентификатор элемента.

name

string

Название опции.

prices[]

object ( PriceAttribute )

Полная стоимость опциона.

note

string

Примечание, связанное с опцией.

quantity

number

Для опций, которые являются предметами, количество.

productId

string

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

subOptions[]

object ( ItemOption )

Для определения других вложенных подопций.

Информация о продукте

Подробности о продукте.

Представление JSON
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
Поля
productId

string

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

gtin

string

Глобальный номер предмета торговли продукта. Полезно, если offerId отсутствует в Merchant Center. Необязательный.

plu

string

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

productType

string

Категория товара определяется продавцом. Например, «Дом > Бакалея > Молочные продукты и яйца > Молоко > Цельное молоко»

productAttributes

map (key: string, value: string)

Информация о продукте, предоставленная продавцом, например { "аллерген": "арахис" }. Полезно, если offerId отсутствует в Merchant Center. Необязательный.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

ReservationItemExtension

Содержимое позиции для заказов на бронирование, таких как ресторан, стрижка и т. д. Следующий идентификатор: 15.

Представление JSON
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
Поля
status

enum ( ReservationStatus )

Требуется: Статус бронирования.

userVisibleStatusLabel

string

Требуется: Видимая пользователем метка/строка для статуса. Максимально допустимая длина составляет 50 символов.

type

enum ( ReservationType )

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

reservationTime

object ( Time )

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

userAcceptableTimeRange

object ( Time )

Диапазон времени, приемлемый для пользователя.

confirmationCode

string

Код подтверждения для этого бронирования.

partySize

number

Число людей.

staffFacilitators[]

object ( StaffFacilitator )

Персональные координаторы, которые будут обслуживать бронирование. Бывший. Парикмахер.

location

object ( Location )

Место проведения услуги/мероприятия.

extension

object

Любые дополнительные поля, которыми обмениваются продавец и Google.

Объект, содержащий поля произвольного типа. Дополнительное поле "@type" содержит URI, идентифицирующий тип. Пример: { "id": 1234, "@type": "types.example.com/standard/id" } .

Статус бронирования

Статус бронирования.

перечисления
RESERVATION_STATUS_UNSPECIFIED Неопределенный статус.
PENDING Бронирование находится на рассмотрении.
CONFIRMED Бронирование подтверждено.
CANCELLED Бронирование отменено пользователем.
FULFILLED Бронирование выполнено.
CHANGE_REQUESTED Требуется изменение бронирования
REJECTED Резервирование истекло или отклонено интегратором.

Тип бронирования

Тип бронирования.

перечисления
RESERVATION_TYPE_UNSPECIFIED Неопределенный тип.
RESTAURANT Резервация для ресторана.
HAIRDRESSER Бронирование для парикмахера.

ПерсоналФасилитатор

Информация об обслуживающем персонале.

Представление JSON
{
  "name": string,
  "image": {
    object (Image)
  }
}
Поля
name

string

Имя координатора персонала. Бывший. "Джон Смит"

image

object ( Image )

Образы исполнителя.

Платежные данные

Платежные данные, связанные с заказом.

Представление JSON
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
Поля
paymentResult

object ( PaymentResult )

Результат платежа, используемый интегратором для завершения транзакции. Это поле будет заполнено Actions on Google, если оформление заказа управляется Actions-on-Google.

paymentInfo

object ( PaymentInfo )

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

ОплатаРезультат

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

Представление JSON
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
Поля
result поля объединения. Предоставляются либо платежные данные Google, либо способ оплаты продавца. result может быть только одним из следующих:
googlePaymentData

string

Google предоставил данные о способе оплаты. Если ваш платежный процессор указан как поддерживаемый Google платежный процессор здесь: https://developers.google.com/pay/api/ Перейдите к своему платежному процессору по ссылке, чтобы узнать более подробную информацию. В противном случае обратитесь к следующей документации для получения подробной информации о полезной нагрузке. https://developers.google.com/pay/api/payment-data-cryptography

merchantPaymentMethodId

string

Продавец/Действие предоставили способ оплаты, выбранный пользователем.

Информация о платеже

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

Представление JSON
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
Поля
paymentMethodDisplayInfo

object ( PaymentMethodDisplayInfo )

Отображаемая информация о способе оплаты, используемом для транзакции.

paymentMethodProvenance

enum ( PaymentMethodProvenance )

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

Способ оплатыДисплейИнформация

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

Представление JSON
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
Поля
paymentType

enum ( PaymentType )

Тип платежа.

paymentMethodDisplayName

string

Видимое пользователем имя способа оплаты. Например, ВИЗА **** 1234 Расчетный счет **** 5678

paymentMethodVoiceName

string

Имя способа оплаты, которое будет произнесено пользователем для устройств с голосовым помощником. Например, «виза, оканчивающаяся на один, два, три, четыре» или «текущий счет, оканчивающийся на пять, шесть, семь, восемь». Примечание. Это оптимизированная для голоса строка, которая будет использоваться вместо 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

string

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

ПокупкаЗаказРасширение

Заказать расширение для закупочной вертикали. Эти свойства применимы ко всем позициям внутри заказа, если они не переопределены в позиции.

Представление JSON
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
Поля
status

enum ( PurchaseStatus )

Требуется: Общий статус заказа.

userVisibleStatusLabel

string

Видимая пользователем метка/строка для статуса. Максимально допустимая длина составляет 50 символов.

type

enum ( PurchaseType )

Требуется: Тип покупки.

returnsInfo

object ( PurchaseReturnsInfo )

Возврат информации для заказа.

fulfillmentInfo

object ( PurchaseFulfillmentInfo )

Информация о выполнении заказа.

extension

object

Любые дополнительные поля, которыми обмениваются продавец и Google.

Объект, содержащий поля произвольного типа. Дополнительное поле "@type" содержит URI, идентифицирующий тип. Пример: { "id": 1234, "@type": "types.example.com/standard/id" } .

purchaseLocationType

enum ( PurchaseLocationType )

Место покупки (в магазине/онлайн)

errors[]

object ( PurchaseError )

Необязательно: Ошибки, из-за которых этот заказ был отклонен.

PurchaseLocationType

Тип места покупки.

перечисления
UNSPECIFIED_LOCATION Неизвестное значение.
ONLINE_PURCHASE Все покупки куплены онлайн.
INSTORE_PURCHASE Все покупки в магазине.

Ошибка покупки

Ошибки, из-за которых заказ на покупку может быть отклонен.

Представление JSON
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
Поля
type

enum ( ErrorType )

Обязательный: представляет детальную причину, по которой продавец отклоняет заказ.

description

string

Дополнительное описание ошибки.

entityId

string

Идентификатор объекта, который соответствует ошибке. Например, это может соответствовать LineItemId/ItemOptionId.

updatedPrice

object ( PriceAttribute )

Актуально в случае ошибки типа PRICE_CHANGED/INCORRECT_PRICE.

availableQuantity

number

Доступное количество сейчас. Применимо в случае 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

object ( TicketEvent )

Событие применяется ко всем тикетам позиций.

TicketEvent

Представляет одно событие.

Представление JSON
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
Поля
type

enum ( Type )

Обязательно: Тип билетного мероприятия, например, кино, концерт.

name

string

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

description

string

Описание события.

url

string

Ссылка на информацию о событии.

location

object ( Location )

Место, где происходит событие или находится организация.

eventCharacters[]

object ( EventCharacter )

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

startDate

object ( Time )

Время начала.

endDate

object ( Time )

Время окончания.

doorTime

object ( Time )

Время входа, которое может отличаться от времени начала мероприятия. например, мероприятие начинается в 9 утра, но время входа в 8:30 утра.

Тип

Тип события.

перечисления
EVENT_TYPE_UNKNOWN Неизвестный тип события.
MOVIE Фильм.
CONCERT Концерт.
SPORTS Виды спорта.

СобытиеПерсонаж

Один персонаж события, например, организатор, исполнитель и т. д.

Представление JSON
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
Поля
type

enum ( Type )

Тип персонажа события, например, актер или режиссер.

name

string

Имя персонажа.

image

object ( Image )

Образы персонажей.

Тип

Тип персонажа.

перечисления
TYPE_UNKNOWN Неизвестный тип.
ACTOR Актер.
PERFORMER Исполнитель.
DIRECTOR Директор.
ORGANIZER Организатор.