Эта страница переведена с помощью Cloud Translation API.

ActionLink

JSON-представление
ActionPlatform
ActionLinkType
Метаданные онлайн-заказа
- JSON-представление
Вариант выполнения
- JSON-представление
Тип выполнения
Доступный день
- JSON-представление
Дата
- JSON-представление
Подробности о комиссионных сборах
- JSON-представление
Без комиссии
Минимальная плата
- JSON-представление
Фиксированная плата
- JSON-представление
Метаданные заказа еды
- JSON-представление
Подробности о комиссионных сборах
- JSON-представление
FeeType
Сумма комиссии
- JSON-представление
Деньги
- JSON-представление
MoneyRange
- JSON-представление
Количественная ценность
- JSON-представление
RangeValue
- JSON-представление
Диапазон продолжительности
- JSON-представление
Предварительные сведения о заказе
- JSON-представление
Метаданные события
- JSON-представление
Поверхность

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

JSON-представление

JSON-представление
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum (`ActionPlatform`), "actionLinkType": enum (`ActionLinkType`), "orderOnlineMetadata": { object (`OrderOnlineMetadata`) }, "foodOrderingMetadata": { object (`FoodOrderingMetadata`) }, "eventMetadata": { object (`EventMetadata`) } }

{
  "url": string,
  "language": string,
  "restrictedCountry": [
    string
  ],
  "platform": enum (ActionPlatform),
  "actionLinkType": enum (ActionLinkType),
  "orderOnlineMetadata": {
    object (OrderOnlineMetadata)
  },
  "foodOrderingMetadata": {
    object (FoodOrderingMetadata)
  },
  "eventMetadata": {
    object (EventMetadata)
  }
}

Поля
`url`	`string` URL-адрес точки входа для этой ссылки действия.
`language`	`string` Языковой тег BCP-47, определяющий язык, на котором доступен контент по этому URI.
`restrictedCountry[]`	`string` Код страны ISO 3166-1 alpha-2. Оставьте поле пустым для неограниченной видимости.
`platform`	`enum ( ActionPlatform )` Платформа, на которой должно быть выполнено это действие. Если это поле не задано, в качестве резервного варианта будет использоваться ACTION_PLATFORM_WEB_APPLICATION.
`actionLinkType`	`enum ( ActionLinkType )` Заранее определенный тип действия.
`orderOnlineMetadata`	`object ( OrderOnlineMetadata )` Метаданные для ссылки «Заказать онлайн». Поддерживаются действия с типом ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE.
`foodOrderingMetadata`	`object ( FoodOrderingMetadata )` Метаданные для ссылок при заказе еды. Поддерживаются следующие типы действий: * `ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY` * `ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT` . НЕ поддерживается `ACTION_LINK_TYPE_ORDER_FOOD` .
`eventMetadata`	`object ( EventMetadata )` Дополнительная информация о ссылке на действие, уникальной для тематического направления «Мероприятия».

ActionPlatform

Платформа, на которой выполняется действие. Веб-приложение обычно используется в качестве резервного варианта. Рекомендуется иметь как минимум одну ActionLink с ACTION_PLATFORM_WEB_APPLICATION. Ссылки с платформами Android и iOS используются только в соответствующих системах.

Перечисления
`ACTION_PLATFORM_UNSPECIFIED`	Платформа не указана.
`ACTION_PLATFORM_WEB_APPLICATION`	Платформа для действий в целом представляет собой веб-ресурс.
`ACTION_PLATFORM_MOBILE_WEB`	Платформа для проведения мероприятий доступна в веб-формате на мобильных устройствах.
`ACTION_PLATFORM_ANDROID`	Платформа для выполнения действий — операционная система Android.
`ACTION_PLATFORM_IOS`	Платформа для действия — iOS.

ActionLinkType

Заранее определенный тип действия, связанный с определенной связью действий.

Перечисления
`ACTION_LINK_TYPE_UNSPECIFIED`	Тип ссылки для выполнения действия не указан.
`ACTION_LINK_TYPE_BOOK_APPOINTMENT`	Тип ссылки для действия — запись на прием.
`ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT`	Тип ссылки для действия — онлайн-запись на прием.
`ACTION_LINK_TYPE_ORDER_FOOD`	Тип ссылки действия — заказ еды с доставкой, на вынос или и то, и другое.
`ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY`	Тип ссылки действия — заказ еды с доставкой.
`ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT`	Тип ссылки действия — заказ еды на вынос.
`ACTION_LINK_TYPE_MAKE_DINING_RESERVATION`	Тип ссылки действия — бронирование столика в ресторане.
`ACTION_LINK_TYPE_SHOP_ONLINE`	The action link type is ordering for shopping, could be deliver or pickup or both.

Метаданные онлайн-заказа

Метаданные для ссылки, ведущей к онлайн-заказу.

JSON-представление
{ "fulfillmentOption": [ { object (`FulfillmentOption`) } ] }

Поля

fulfillmentOption[]

object ( FulfillmentOption )

Доступные варианты выполнения заказа по ссылке для онлайн-заказа.

Вариант выполнения

Ссылка для выполнения онлайн-заказа.

JSON-представление
{ "fulfillmentType": enum (`FulfillmentType`), "availableDay": [ { object (`AvailableDay`) } ], "feeDetails": { object (`FeeDetails`) }, "minimumOrder": { object (`Price`) } }

Поля
`fulfillmentType`	`enum ( FulfillmentType )` Обязательно. Тип выполнения.
`availableDay[]`	`object ( AvailableDay )` Обязательно. Список дней, когда доступен данный способ выполнения заказа (желательно не менее 2).
`feeDetails`	`object ( FeeDetails )` Обязательно. Подробная информация о способе выполнения заказа.
`minimumOrder`	`object ( Price )` Обязательно. Минимальная сумма заказа для способа выполнения, связанного со ссылкой на действие.

Тип выполнения

Тип выполнения, связанный со ссылкой для совершения действия.

Перечисления
`FULFILLMENT_TYPE_UNSPECIFIED`	Тип выполнения заказа не указан.
`FULFILLMENT_TYPE_DELIVERY`	Тип выполнения заказа — доставка.
`FULFILLMENT_TYPE_PICKUP`	Тип выполнения заказа — самовывоз.

Доступный день

Доступно в течение дня.

JSON-представление
{ "fulfillmentDate": { object (`Date`) }, "lastOrderingTime": string }

Поля

Поля
`fulfillmentDate`	`object ( Date )` Обязательно. Доступная дата для способа выполнения заказа. Предполагается, что она находится в часовом поясе продавца.
`lastOrderingTime`	`string ( Timestamp format)` Обязательно. Временная метка Unix. Последнее время, когда пользователь мог сделать заказ и получить товары до `fulfillmentDate` ). Другими словами, после lastOrderingTime дата выполнения заказа больше не будет отображаться как доступная. Например, если fulfillmentDate — 2020-08-10: — значение lastOrderingTime, равное 2020-08-10 18:00, означает, что для получения заказа 10.08.2020 клиент должен оформить заказ до 18:00 того же дня. — значение lastOrderingTime, равное 2020-08-08 20:00, означает, что для получения заказа 10.08.2020 клиент должен оформить заказ до 20:00 за два дня до этого. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: `"2014-10-02T15:01:23Z"` , `"2014-10-02T15:01:23.045123456Z"` или `"2014-10-02T15:01:23+05:30"` .

fulfillmentDate

object ( Date )

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

lastOrderingTime

string ( Timestamp format)

Обязательно. Временная метка Unix. Последнее время, когда пользователь мог сделать заказ и получить товары до fulfillmentDate ). Другими словами, после lastOrderingTime дата выполнения заказа больше не будет отображаться как доступная.

Например, если fulfillmentDate — 2020-08-10: — значение lastOrderingTime, равное 2020-08-10 18:00, означает, что для получения заказа 10.08.2020 клиент должен оформить заказ до 18:00 того же дня. — значение lastOrderingTime, равное 2020-08-08 20:00, означает, что для получения заказа 10.08.2020 клиент должен оформить заказ до 20:00 за два дня до этого.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

Дата

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

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

Связанные типы:

JSON-представление
{ "year": integer, "month": integer, "day": integer }

Поля

Поля
`year`	`integer` Год даты. Должен быть от 1 до 9999, или 0, чтобы указать дату без года.
`month`	`integer` Месяц года. Должен быть от 1 до 12, или 0, чтобы указать год без месяца и дня.
`day`	`integer` День месяца. Должен быть от 1 до 31 и соответствовать году и месяцу, или 0, чтобы указать только год или год и месяц, где день не имеет значения.

year

integer

Год даты. Должен быть от 1 до 9999, или 0, чтобы указать дату без года.

month

integer

Месяц года. Должен быть от 1 до 12, или 0, чтобы указать год без месяца и дня.

day

integer

День месяца. Должен быть от 1 до 31 и соответствовать году и месяцу, или 0, чтобы указать только год или год и месяц, где день не имеет значения.

Подробности о комиссионных сборах

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

JSON-представление

JSON-представление
{ // Union field `fee_details` can be only one of the following: "noFee": { object (`NoFee`) }, "baseFee": { object (`MinimumFee`) }, "fixedFee": { object (`FixedFee`) } // End of list of possible types for union field `fee_details`. }

{

  // Union field fee_details can be only one of the following:
  "noFee": {
    object (NoFee)
  },
  "baseFee": {
    object (MinimumFee)
  },
  "fixedFee": {
    object (FixedFee)
  }
  // End of list of possible types for union field fee_details.
}

Поля
Поле объединения `fee_details` . Модель комиссии для метода выполнения. `fee_details` может принимать только одно из следующих значений:
`noFee`	`object ( NoFee )` За использование выбранного метода обработки заказа комиссия не взимается.
`baseFee`	`object ( MinimumFee )` Базовая плата, связанная с методом выполнения заказа.
`fixedFee`	`object ( FixedFee )` Фиксированная плата, связанная с методом выполнения заказа.

Без комиссии

Этот тип не содержит полей.

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

Минимальная плата

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

JSON-представление
{ "baseFeeAmount": { object (`Price`) } }

Поля

Поля
`baseFeeAmount`	`object ( Price )` Обязательно. Базовая сумма комиссии за выбранный способ выполнения заказа.

baseFeeAmount

object ( Price )

Обязательно. Базовая сумма комиссии за выбранный способ выполнения заказа.

Фиксированная плата

Фиксированная плата, взимаемая за способ выполнения заказа, связанный с ссылкой для совершения действия.

JSON-представление
{ "amount": { object (`Price`) } }

Поля

Поля
`amount`	`object ( Price )` Обязательно. Размер фиксированной платы за выбранный способ выполнения заказа.

amount

object ( Price )

Обязательно. Размер фиксированной платы за выбранный способ выполнения заказа.

Метаданные заказа еды

Метаданные для ссылок, используемых при оформлении заказа еды.

JSON-представление

JSON-представление
{ "feeDetails": [ { object (`FeeDetails`) } ], "advanceOrderDetails": { object (`AdvanceOrderDetails`) }, // Union field `fulfillment_duration_options` can be only one of the following: "fulfillmentLeadTimeDuration": string, "fulfillmentLeadTimeDurationRange": { object (`DurationRange`) } // End of list of possible types for union field `fulfillment_duration_options`. }

{
  "feeDetails": [
    {
      object (FeeDetails)
    }
  ],
  "advanceOrderDetails": {
    object (AdvanceOrderDetails)
  },

  // Union field fulfillment_duration_options can be only one of the following:
  "fulfillmentLeadTimeDuration": string,
  "fulfillmentLeadTimeDurationRange": {
    object (DurationRange)
  }
  // End of list of possible types for union field fulfillment_duration_options.
}

Поля
`feeDetails[]`	`object ( FeeDetails )` Подробная информация о сборах, взимаемых с пользователя сверх общей суммы за товар. Повторяется для разных типов сборов, таких как плата за обслуживание, плата за доставку и т. д.
`advanceOrderDetails`	`object ( AdvanceOrderDetails )` Подробная информация о поддержке расширенного оформления заказов, также известного как предварительный заказ, позволяющего пользователю разместить заказ для выполнения позднее, чем сейчас.
Поле Union field `fulfillment_duration_options` . Время выполнения заказа с момента подтверждения заказа. Для заказов с доставкой — время до доставки еды. Для заказов с самовывозом — время до готовности еды к выдаче. `fulfillment_duration_options` может принимать только одно из следующих значений:
`fulfillmentLeadTimeDuration`	`string ( Duration format)` Фиксированная продолжительность. Например: 30 минут. Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « `s` ». Пример: `"3.5s"` .
`fulfillmentLeadTimeDurationRange`	`object ( DurationRange )` Диапазон продолжительности. Примеры: * от 30 до 45 минут * Более 30 минут * Менее 50 минут

Подробности о комиссионных сборах

Подробная информация о платежах.

JSON-представление
{ "type": enum (`FeeType`), "feeAmount": { object (`FeeAmount`) } }

Поля

Поля
`type`	`enum ( FeeType )` Тип оплаты. (обязательно)
`feeAmount`	`object ( FeeAmount )` Размер комиссии может быть указан в валюте, в процентах от стоимости корзины или в сочетании того и другого. (обязательно)

type

enum ( FeeType )

Тип оплаты. (обязательно)

feeAmount

object ( FeeAmount )

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

FeeType

Тип оплаты.

Перечисления
`FEE_TYPE_UNSPECIFIED`	Тип платы не указан.
`DELIVERY`	Стоимость доставки.
`SERVICE`	Стоимость услуг.

Сумма комиссии

Примеры FeeAmount : * Фиксированная комиссия: 0 долларов США (без комиссии), 1,5 доллара США * Диапазон фиксированной комиссии: 1,0 доллар США (минимум), 3,0 доллара США (максимум), 5,0-6,0 долларов США * Процент от размера корзины: 15,5%, 10%-20%, 10% (минимум), 15% (максимум) * Составная сумма диапазона и процента: 25,5% и 2,5 доллара США (минимум), 25,5% и 4,5 доллара США (максимум), 10% и 1,5-2,5 доллара США, 10,5%-20% и 2,5-3,5 доллара США

JSON-представление

JSON-представление
{ "cartPercentage": { object (`QuantitativeValue`) }, // Union field `amount_options` can be only one of the following: "amount": { object (`Money`) }, "amountRange": { object (`MoneyRange`) }, "amountUnknown": boolean // End of list of possible types for union field `amount_options`. }

{
  "cartPercentage": {
    object (QuantitativeValue)
  },

  // Union field amount_options can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountRange": {
    object (MoneyRange)
  },
  "amountUnknown": boolean
  // End of list of possible types for union field amount_options.
}

Поля
`cartPercentage`	`object ( QuantitativeValue )` Комиссия в процентах от стоимости корзины. Поддерживается диапазон (ограниченный и неограниченный) или фиксированный процент. Значение должно быть от 0 до 100. Примеры: * Фиксированная 5,5% * Не менее 5,5% * Не более 5,5% * От 4,5% до 5,5%
Поле объединения `amount_options` . Параметры для указания денежной суммы. `amount_options` может принимать только одно из следующих значений:
`amount`	`object ( Money )` Фиксированная сумма. Например, 3,5 доллара США.
`amountRange`	`object ( MoneyRange )` Диапазон сумм. Примеры: * от 3,5 до 5,5 долларов США * Минимум 3,5 доллара США * Максимум 5,5 доллара США
`amountUnknown`	`boolean` Неизвестная сумма.

Деньги

Представляет собой сумму денег с указанием типа валюты.

JSON-представление
{ "currencyCode": string, "units": string, "nanos": integer }

Поля

Поля
`currencyCode`	`string` Трехбуквенный код валюты, определенный в стандарте ISO 4217.
`units`	`string ( int64 format)` Целые единицы суммы. Например, если `currencyCode` — `"USD"` , то 1 единица — это один доллар США.
`nanos`	`integer` Количество нано (10^-9) единиц величины. Значение должно находиться в диапазоне от -999 999 999 до +999 999 999 включительно. Если `units` положительно, то `nanos` должно быть положительным или равным нулю. Если `units` равно нулю, `nanos` может быть положительным, равным нулю или отрицательным. Если `units` отрицательно, то `nanos` должно быть отрицательным или равным нулю. Например, $-1,75 представляется как `units` = -1 и `nanos` = -750 000 000.

currencyCode

string

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

units

string ( int64 format)

Целые единицы суммы. Например, если currencyCode — "USD" , то 1 единица — это один доллар США.

nanos

integer

Количество нано (10^-9) единиц величины. Значение должно находиться в диапазоне от -999 999 999 до +999 999 999 включительно. Если units положительно, то nanos должно быть положительным или равным нулю. Если units равно нулю, nanos может быть положительным, равным нулю или отрицательным. Если units отрицательно, то nanos должно быть отрицательным или равным нулю. Например, $-1,75 представляется как units = -1 и nanos = -750 000 000.

MoneyRange

Оболочка для диапазона денежных сумм, который может быть ограниченным или неограниченным. Требуется наличие хотя бы одного из значений minAmount или maxAmount.

JSON-представление
{ "minAmount": { object (`Money`) }, "maxAmount": { object (`Money`) } }

Поля

Поля
`minAmount`	`object ( Money )` Минимальная сумма.
`maxAmount`	`object ( Money )` Максимальная сумма.

minAmount

object ( Money )

Минимальная сумма.

maxAmount

object ( Money )

Максимальная сумма.

Количественная ценность

Оболочка для числового значения, которое может представлять собой диапазон или фиксированное значение. Примеры QuantitativeValue : * Единственное значение: value: 10.5 * Ограниченный диапазон: valueRange {minValue: 5.5, maxValue 10.5} * Нижняя граница: valueRange {minValue: 5.5} * Верхняя граница: valueRange {maxValue: 10.5}

JSON-представление
{ // Union field `value_options` can be only one of the following: "value": number, "valueRange": { object (`RangeValue`) } // End of list of possible types for union field `value_options`. }

Поля

Поля
Поле объединения `value_options` (обязательное поле). `value_options` может принимать только одно из следующих значений:
`value`	`number` Единственное значение. Например: 5,6
`valueRange`	`object ( RangeValue )` Диапазон значений, который может быть как неограниченным, так и ограниченным. Примеры: * Не менее 5,5 * Не более 5,5 * От 5,5 до 6,5

Поле объединения value_options (обязательное поле). value_options может принимать только одно из следующих значений:

value

number

Единственное значение. Например: 5,6

valueRange

object ( RangeValue )

Диапазон значений, который может быть как неограниченным, так и ограниченным. Примеры: * Не менее 5,5 * Не более 5,5 * От 5,5 до 6,5

RangeValue

Диапазон значений, при котором minValue < maxValue . Требуется наличие хотя бы одного из minValue и maxValue .

JSON-представление
{ "minValue": number, "maxValue": number }

Поля

Поля
`minValue`	`number` Минимальное значение.
`maxValue`	`number` Максимальное значение.

minValue

number

Минимальное значение.

maxValue

number

Максимальное значение.

Диапазон продолжительности

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

JSON-представление
{ "minDuration": string, "maxDuration": string }

Поля

Поля
`minDuration`	`string ( Duration format)` Минимальная продолжительность. Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « `s` ». Пример: `"3.5s"` .
`maxDuration`	`string ( Duration format)` Максимальная продолжительность. Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « `s` ». Пример: `"3.5s"` .

minDuration

string ( Duration format)

Минимальная продолжительность.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « s ». Пример: "3.5s" .

maxDuration

string ( Duration format)

Максимальная продолжительность.

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « s ». Пример: "3.5s" .

Предварительные сведения о заказе

Для оформления предварительного заказа.

JSON-представление
{ "isSupported": boolean }

Поля

Поля
`isSupported`	`boolean` Значение True, если поддерживаются предварительные заказы (также известные как заказы заранее). (обязательно)

isSupported

boolean

Значение True, если поддерживаются предварительные заказы (также известные как заказы заранее). (обязательно)

Метаданные события

Additional information about action link which is unique to the events vertical.

JSON-представление
{ "surface": enum (`Surface`) }

Поля

surface

enum ( Surface )

Заранее определенная поверхность событий, связанная со ссылкой на действие. Это используется только для вертикальной структуры «События».

Поверхность

Перечисления
`SURFACE_UNSPECIFIED`	Тип поверхности не указан.
`SURFACE_SEARCH`	Ссылка для выполнения действия ведет к бронированию билета на мероприятие в разделе «Поиск».
`SURFACE_YOUTUBE`	Ссылка для активации ведет к бронированию билета на мероприятие на YouTube.
`SURFACE_ADS`	Ссылка для совершения действия ведет к клику на рекламное объявление мероприятия.

ActionLink Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

ActionPlatform

ActionLinkType

Метаданные онлайн-заказа

Вариант выполнения

Тип выполнения

Доступный день

Дата

Подробности о комиссионных сборах

Без комиссии

Минимальная плата

Фиксированная плата

Метаданные заказа еды

Подробности о комиссионных сборах

FeeType

Сумма комиссии

Деньги

MoneyRange

Количественная ценность

RangeValue

Диапазон продолжительности

Предварительные сведения о заказе

Метаданные события

Поверхность

ActionLink