- JSON-представление
- Содержание
- Платежные данные
- Результат платежа
- Информация об оплате
- Метод оплаты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-представление | |
---|---|
{
"lineItems": [
{
object ( |
Поля | |
---|---|
lineItems[] | Список позиций заказа. Требуется как минимум 1 элемент строки, допускается не более 50. Все позиции должны относиться к одной тематике. |
Платежные данные
Платежные данные, относящиеся к заказу.
JSON-представление | |
---|---|
{ "paymentResult": { object ( |
Поля | |
---|---|
paymentResult | Результат платежа, который используется интегратором для завершения транзакции. Это поле будет заполнено действиями в 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 |
Повышение
Акции/предложения, добавленные в корзину.
JSON-представление | |
---|---|
{ "coupon": string } |
Поля | |
---|---|
coupon | Обязательно: код купона, примененный к этому предложению. |
Расширение заказа на покупку
Расширение заказа для вертикальной покупки. Эти свойства применимы ко всем позициям внутри заказа, если они не переопределены в позиции.
JSON-представление | |
---|---|
{ "status": enum ( |
Поля | |
---|---|
status | Обязательно: общий статус заказа. |
userVisibleStatusLabel | Видимая пользователем метка/строка статуса. Максимально допустимая длина — 50 символов. |
type | Обязательно: тип покупки. |
returnsInfo | Информация о возврате заказа. |
fulfillmentInfo | Информация о выполнении заказа. |
extension | Любые дополнительные поля, которыми обмениваются продавец и Google. Объект, содержащий поля произвольного типа. Дополнительное поле |
purchaseLocationType | Место покупки (в магазине/онлайн) |
errors[] | Необязательно: ошибки, из-за которых этот заказ был отклонен. |
Ошибка покупки
Ошибки, из-за которых заказ на поставку может быть отклонен.
JSON-представление | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Обязательно: здесь указывается подробная причина, по которой заказ отклоняется продавцом. |
description | Дополнительное описание ошибки. |
entityId | Идентификатор объекта, соответствующий ошибке. Пример: это может соответствовать LineItemId/ItemOptionId. |
updatedPrice | Актуально в случае ошибки типа PRICE_CHANGED/INCORRECT_PRICE. |
availableQuantity | Доступное количество сейчас. Применимо в случае AVAILABILITY_CHANGED. |
Расширение заказа билета
Содержание заказа для заказов билетов, таких как кино, спорт и т. д.
JSON-представление | |
---|---|
{
"ticketEvent": {
object ( |
Поля | |
---|---|
ticketEvent | Событие применимо ко всем билетам отдельных позиций. |
БилетСобытие
Представляет одно событие.
JSON-представление | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | Обязательно: тип билета на мероприятие, например, кино, концерт. |
name | Обязательно: название мероприятия. Например, если событие представляет собой фильм, это должно быть название фильма. |
description | описание мероприятия. |
url | URL-адрес информации о мероприятии. |
location | Место, где происходит событие или находится организация. |
eventCharacters[] | Персонажи, связанные с этим событием. Это могут быть режиссеры или актеры киномероприятия, артисты концерта и т. д. |
startDate | Время начала. |
endDate | Время окончания. |
doorTime | Время входа, которое может отличаться от времени начала мероприятия. например, мероприятие начинается в 9 утра, но время входа — 8:30 утра. |
СобытиеПерсонаж
Один персонаж мероприятия, например, организатор, исполнитель и т. д.
JSON-представление | |
---|---|
{ "type": enum ( |
Поля | |
---|---|
type | тип персонажа события, например актер или режиссер. |
name | имя персонажа. |
image | Изображения персонажей. |