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 «Зулу» с точностью до наносекунд. Пример: "2014-10-02T15:01:23.045123456Z" .

lastUpdateTime

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с точностью до наносекунд. Пример: "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, как определено в Рекомендации E.164 Международного союза электросвязи (ITU). ссылка на вики: https://en.wikipedia.org/wiki/E.164

extension

string

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

preferredDomesticCarrierCode

string

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

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

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

Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, представляющих градусы широты и градусы долготы. Если не указано иное, оно должно соответствовать стандарту 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

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

sublocality

string

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

addressLines[]

string

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

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

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

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

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 поля Union. Представляет либо денежную сумму, либо миллипроценты. 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 Ссылка на направление.

Опенурлэкшн

Открывает указанный 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]. Нулевой диапазон подразумевает любую версию. Примеры. Чтобы указать одну версию, используйте: [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

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с точностью до наносекунд. Пример: "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 Раскрытие информации является обязательным. Разговор будет переведен на телефон, если устройство не поддерживает отображение раскрытой информации.

Расширение PurchaseItemExtension

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

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» может иметь разное значение в разных контекстах. Для заказа ЕДА это может быть приготовление еды. В розничной торговле это может быть упаковка товара.
CREATED Порядок создан.
CONFIRMED Продавец подтвердил заказ.
REJECTED Продавец отклонил заказ или позицию.
RETURNED Товар был возвращен пользователем.
CANCELLED Заказ или позиция были отменены пользователем.
CHANGE_REQUESTED Пользователь запросил изменение заказа, и интегратор обрабатывает это изменение. После обработки запроса заказ должен быть переведен в другое состояние.

Тип покупки

Категория покупки.

Перечисления
PURCHASE_TYPE_UNSPECIFIED Неизвестное значение.
RETAIL Сюда входят покупки, такие как физические товары.
FOOD В стоимость входит покупка еды по заказу.
GROCERY Покупка продуктов.
MOBILE_RECHARGE Предоплаченная покупка пополнения мобильного телефона.

ТорговецЕдиницаМера

Мера ценообразования торговой единицы.

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

Если это правда, возврат разрешен.

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 «Зулу» с точностью до наносекунд. Пример: "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 )

Дополнительная информация о том, как будет собираться заказ. Это поле применимо только в том случае, если тип выполнения — САМОВЫВОЗ.

Тип

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

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

Время

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

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

string

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

Информация о самовывозе

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

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

enum ( PickupType )

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

curbsideInfo

object ( CurbsideInfo )

Подробности, относящиеся к информации на обочине. Если тип PickupType не «CURBSIDE», это поле будет игнорироваться.

checkInInfo[]

object ( CheckInInfo )

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

Тип звукоснимателя

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

Перечисления
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

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

model

string

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

licensePlate

string

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

colorName

string

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

image

object ( Image )

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

CheckInInfo

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

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

enum ( 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" } .

Расширение резервированияитемекстенсион

Содержимое позиции для заказов на бронирование, таких как ресторан, стрижка и т. д. Следующий идентификатор: 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/pay-data-cryptography

merchantPaymentMethodId

string

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

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

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

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

object ( PaymentMethodDisplayInfo )

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

paymentMethodProvenance

enum ( PaymentMethodProvenance )

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

Метод оплатыDisplayInfo

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

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

enum ( PaymentType )

Тип платежа.

paymentMethodDisplayName

string

Видимое пользователю название способа оплаты. Например, VISA **** 1234 Проверка счета **** 5678

paymentMethodVoiceName

string

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

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 )

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

Тип местоположения покупки

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

Перечисления
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 Цена товара отличается от цены в сущности «Товар». Требуется идентификатор объекта и обновленная цена.
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)
  }
}
Поля
ticketEvent

object ( 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

URL-адрес информации о мероприятии.

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 Организатор.