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

ActionLink

JSON-представление
Платформа действий
ТипДейшнЛинкТип
ЗаказонлайнМетаданные
- JSON-представление
Вариант выполнения
- JSON-представление
Тип выполнения
Доступный день
- JSON-представление
Дата
- JSON-представление
Подробности о плате
- JSON-представление
Без комиссии
Минимальная комиссия
- JSON-представление
Фиксированная плата
- JSON-представление
ЕдаЗаказМетаданные
- JSON-представление
Подробности о плате
- JSON-представление
Тип комиссии
Сумма комиссии
- JSON-представление
Деньги
- JSON-представление
ДеньгиДиапазон
- JSON-представление
Количественное значение
- JSON-представление
ДиапазонЗначение
- 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.
`restricted Country[]`	`string` Код страны ISO 3166-1 альфа-2. Оставьте пустым для неограниченной видимости.
`platform`	`enum ( ActionPlatform )` Платформа, на которой должно быть выполнено это действие. Если это поле не установлено, ACTION_PLATFORM_WEB_APPLICATION будет использоваться в качестве резервного варианта.
`action Link Type`	`enum ( ActionLinkType )` Предопределенный тип действия.
`order Online Metadata`	`object ( OrderOnlineMetadata )` Метаданные для ссылки онлайн-заказа. Поддерживает действие с ActionLinkType ACTION_LINK_TYPE_SHOP_ONLINE.
`food Ordering Metadata`	`object ( FoodOrderingMetadata )` Метаданные для ссылок для заказа еды. Поддерживает тип действия: * `ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY` * `ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT` НЕ поддерживает `ACTION_LINK_TYPE_ORDER_FOOD` .
`event Metadata`	`object ( EventMetadata )` Дополнительная информация о ссылке на действие, которая является уникальной для вертикали событий.

Платформа действий

Платформа, на которой выполняется действие. Веб-приложение — это общий запасной вариант. Рекомендуется иметь хотя бы один 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.

ТипДейшнЛинкТип

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

Перечисления
`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`	Тип ссылки действия — заказ на покупку, может быть доставка, самовывоз или и то, и другое.

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

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

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

Поля

fulfillment Option[]

object ( FulfillmentOption )

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

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

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

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

Поля
`fulfillment Type`	`enum ( FulfillmentType )` Необходимый. Тип выполнения.
`available Day[]`	`object ( AvailableDay )` Необходимый. Список дней, в которые доступен данный способ выполнения (желательно не менее 2).
`fee Details`	`object ( FeeDetails )` Необходимый. Детали комиссии для метода выполнения.
`minimum Order`	`object ( Price )` Необходимый. Минимальный заказ для метода выполнения, связанного со ссылкой действия.

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

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

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

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

Доступность дневного уровня.

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

Поля

Поля
`fulfillment Date`	`object ( Date )` Необходимый. Доступная дата для метода выполнения. Предполагается, что он находится в часовом поясе продавца.
`last Ordering Time`	`string ( Timestamp format)` Необходимый. Временная метка Unix. Последний раз, когда пользователь мог заказать и получить товары до `fulfillmentDate` . Другими словами, после последнего времени заказа дата выполнения больше не будет отображаться как доступная. Например, если дата выполнения — 10 августа 2020 г.: значение LastOrderingTime 10 августа 2020 г., 18:00 означает, что для получения заказа 10 августа 2020 г. клиент должен сделать заказ до 18:00. в тот же день. - значение LastOrderingTime 08.08.2020 20:00 означает, что для получения заказа 10 августа 2020 г. клиент должен сделать этот заказ до 20:00 за два дня до этого. Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: `"2014-10-02T15:01:23Z"` и `"2014-10-02T15:01:23.045123456Z"` .

fulfillment Date

object ( Date )

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

last Ordering Time

string ( Timestamp format)

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

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

Дата

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

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

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

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` может быть только одним из следующих:
`no Fee`	`object ( NoFee )` Никакой комиссии за способ выполнения.
`base Fee`	`object ( MinimumFee )` Базовая комиссия, связанная с методом выполнения.
`fixed Fee`	`object ( FixedFee )` Фиксированная комиссия, связанная со способом выполнения.

Без комиссии

Этот тип не имеет полей.

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

Минимальная комиссия

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

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

Поля

Поля
`base Fee Amount`	`object ( Price )` Необходимый. Базовая сумма комиссии для метода выполнения.

base Fee Amount

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.
}

Поля
`fee Details[]`	`object ( FeeDetails )` Подробная информация о комиссиях, взимаемых с пользователя сверх общей суммы товара. Повторяется для различных типов сборов, таких как плата за обслуживание, плата за доставку и т. д.
`advance Order Details`	`object ( AdvanceOrderDetails )` Подробная информация о расширенной поддержке заказа, также известной как предварительный заказ, когда пользователь может разместить заказ для выполнения в более позднее время, чем прямо сейчас.
Поле объединения `fulfillment_duration_options` . Продолжительность времени выполнения заказа с момента подтверждения заказа. Для заказов на доставку — продолжительность времени до доставки еды. Для заказов на самовывоз — время, в течение которого еда будет готова к самовывозу. `fulfillment_duration_options` может быть только одним из следующих:
`fulfillment Lead Time Duration`	`string ( Duration format)` Фиксированная продолжительность. Например: 30 минут. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « `s` ». Пример: `"3.5s"` .
`fulfillment Lead Time Duration Range`	`object ( DurationRange )` Диапазон продолжительности. Примеры: * От 30 до 45 минут * Более 30 минут * Менее 50 минут

Подробности о плате

Подробности о плате.

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

Поля

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

type

enum ( FeeType )

Тип комиссии. (необходимый)

fee Amount

object ( FeeAmount )

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

Тип комиссии

Тип комиссии.

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

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

Деньги

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

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

Поля

Поля
`currency Code`	`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.

currency Code

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.

ДеньгиДиапазон

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

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

Поля

Поля
`min Amount`	`object ( Money )` Минимальная сумма.
`max Amount`	`object ( Money )` Максимальная сумма.

min Amount

object ( Money )

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

max Amount

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
`value Range`	`object ( RangeValue )` Диапазон значений, который также может быть открытым или ограниченным. Примеры: * Минимум 5,5 * Максимум 5,5 * От 5,5 до 6,5.

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

value

number

Уникальная ценность. Например: 5,6

value Range

object ( RangeValue )

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

ДиапазонЗначение

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

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

Поля

Поля
`min Value`	`number` Минимальное значение.
`max Value`	`number` Максимальное значение.

min Value

number

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

max Value

number

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

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

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

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

Поля

Поля
`min Duration`	`string ( Duration format)` Минимальная продолжительность. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « `s` ». Пример: `"3.5s"` .
`max Duration`	`string ( Duration format)` Максимальная продолжительность. Длительность в секундах, содержащая до девяти дробных цифр и оканчивающаяся на « `s` ». Пример: `"3.5s"` .

min Duration

string ( Duration format)

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

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

max Duration

string ( Duration format)

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

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

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

Для поддержки заказа вперед.

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

Поля

Поля
`is Supported`	`boolean` Значение true, если поддерживаются предварительные заказы, также известные как предварительные заказы. (необходимый)

is Supported

boolean

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

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

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

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

Поля

surface

enum ( Surface )

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

Поверхность

Перечисления
`SURFACE_UNSPECIFIED`	Поверхность не указана.
`SURFACE_SEARCH`	Ссылка на действие — бронирование билета на мероприятие в Поиске.
`SURFACE_YOUTUBE`	Ссылка на действие — бронирование билета на мероприятие на YouTube.
`SURFACE_ADS`	Ссылка на действие — нажатие на рекламу мероприятия.

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

Платформа действий

ТипДейшнЛинкТип

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

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

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

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

Дата

Подробности о плате

Без комиссии

Минимальная комиссия

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

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

Подробности о плате

Тип комиссии

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

Деньги

ДеньгиДиапазон

Количественное значение

ДиапазонЗначение

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

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

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

Поверхность

ActionLink