ActionLink

JSON 表示法
ActionPlatform
ActionLinkType
OrderOnlineMetadata
- JSON 表示法
FulfillmentOption
- JSON 表示法
FulfillmentType
AvailableDay
- JSON 表示法
Date
- JSON 表示法
FeeDetails
- JSON 表示法
NoFee
MinimumFee
- JSON 表示法
FixedFee
- JSON 表示法
FoodOrderingMetadata
- JSON 表示法
FeeDetails
- JSON 表示法
FeeType
FeeAmount
- JSON 表示法
Money
- JSON 表示法
MoneyRange
- JSON 表示法
QuantitativeValue
- JSON 表示法
RangeValue
- JSON 表示法
DurationRange
- JSON 表示法
AdvanceOrderDetails
- JSON 表示法
EventMetadata
- JSON 表示法
Surface

一个操作网址，包含所用语言、支持的国家/地区列表以及可选平台（表示应在哪个平台上执行此操作）。

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` 此操作链接的入口点网址。
`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

用于指明在哪个平台上执行此操作。Web 应用是通用的后备平台。建议您至少拥有一个包含 ACTION_PLATFORM_WEB_APPLICATION 的 ActionLink。如果链接将 Android 和 iOS 作为平台，该链接仅适用于对应的系统。

枚举
`ACTION_PLATFORM_UNSPECIFIED`	平台未指定。
`ACTION_PLATFORM_WEB_APPLICATION`	通用操作平台为 Web 应用。
`ACTION_PLATFORM_MOBILE_WEB`	操作平台为移动设备上的 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`	操作链接类型为购物下单，可以是送货、自提或两者兼有。

OrderOnlineMetadata

“在线订购”操作链接的元数据。

JSON 表示法
{ "fulfillmentOption": [ { object (`FulfillmentOption`) } ] }

字段

fulfillmentOption[]

object (FulfillmentOption)

“在线订购”操作链接可用的履单选项。

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)` 必需。与操作链接关联的履单方式的最低订单金额。

FulfillmentType

与操作链接关联的履单类型。

枚举
`FULFILLMENT_TYPE_UNSPECIFIED`	履单类型未指定。
`FULFILLMENT_TYPE_DELIVERY`	履单类型为配送。
`FULFILLMENT_TYPE_PICKUP`	履单类型为自提。

AvailableDay

天级可用性。

JSON 表示法
{ "fulfillmentDate": { object (`Date`) }, "lastOrderingTime": string }

字段

字段
`fulfillmentDate`	`object (Date)` 必需。配送方式的可用日期。假设采用商家所在时区。
`lastOrderingTime`	`string (Timestamp format)` 必需。Unix 时间戳。用户最晚可在 `fulfillmentDate` 之前下单，并于该日期之前收到商品。换句话说，在 lastOrderingTime 之后，fulfillmentDate 将不再显示为可用。例如，如果 fulfillmentDate 为 2020-08-10，则：- lastOrderingTime 值为 2020-08-10 18:00 表示，客户必须在当天下午 6 点之前下单，才能在 2020-08-10 收到订单。lastOrderingTime 值为 2020-08-08 20:00 表示，客户必须在两天前的晚上 8 点之前下单，才能在 2020-08-10 收到订单。采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 将不再显示为可用。

例如，如果 fulfillmentDate 为 2020-08-10，则：- lastOrderingTime 值为 2020-08-10 18:00 表示，客户必须在当天下午 6 点之前下单，才能在 2020-08-10 收到订单。lastOrderingTime 值为 2020-08-08 20:00 表示，客户必须在两天前的晚上 8 点之前下单，才能在 2020-08-10 收到订单。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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（即天不重要，指定单独的年份或者年份和月份）。

FeeDetails

与操作链接关联的履单方式的费用详情。

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)` 与配送方式相关联的固定费用。

NoFee

此类型没有字段。

与操作链接关联的履单方式无需支付任何费用。

MinimumFee

与操作链接关联的履单方式所需的最低费用。

JSON 表示法
{ "baseFeeAmount": { object (`Price`) } }

字段

字段
`baseFeeAmount`	`object (Price)` 必需。相应配送方式的基本费用金额。

baseFeeAmount

object (Price)

必需。相应配送方式的基本费用金额。

FixedFee

与操作链接关联的履单方式所需的固定费用。

JSON 表示法
{ "amount": { object (`Price`) } }

字段

字段
`amount`	`object (Price)` 必需。相应配送方式的固定费用金额。

amount

object (Price)

必需。相应配送方式的固定费用金额。

FoodOrderingMetadata

外卖操作链接的元数据。

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)` 有关高级订购支持（也称为“提前订购”）的详细信息，用户可以下单，以便在稍后时间完成订单。
联合字段 `fulfillment_duration_options`。从订单确认到履单的持续时间。对于外送订单，从下单到送达食物的时间。对于自提订单，食品准备好自提的时间。`fulfillment_duration_options` 只能是下列其中一项：
`fulfillmentLeadTimeDuration`	`string (Duration format)` 固定时长。例如：30 分钟。该时长以秒为单位，最多包含九个小数位，以“`s`”结尾。示例：`"3.5s"`。
`fulfillmentLeadTimeDurationRange`	`object (DurationRange)` 时长范围。示例：* 30 分钟到 45 分钟 * 超过 30 分钟 * 不到 50 分钟

FeeDetails

费用详情。

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

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` 未知金额。

Money

表示含有货币类型的金额。

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

数值的封装容器，可以是范围或固定值。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

最大值。

DurationRange

可有界限或无界限的时长范围的封装容器。必须提供 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"。

AdvanceOrderDetails

如需预订支持，请执行以下操作。

JSON 表示法
{ "isSupported": boolean }

字段

字段
`isSupported`	`boolean` 如果支持预订（也称为“提前下单”），则为 True。（必填）

isSupported

boolean

如果支持预订（也称为“提前下单”），则为 True。（必填）

EventMetadata

特定于活动类别的有关操作链接的其他信息。

JSON 表示法
{ "surface": enum (`Surface`) }

字段

surface

enum (Surface)

与操作链接相关联的预定事件界面。此字段仅用于“活动”类别。

Surface

与操作链接相关联的预定事件界面。此字段仅用于“活动”类别。

枚举
`SURFACE_UNSPECIFIED`	未指定表面。
`SURFACE_SEARCH`	操作链接是在 Google 搜索中预订活动门票。
`SURFACE_YOUTUBE`	操作链接是在 YouTube 中预订活动门票。
`SURFACE_ADS`	操作链接是指点击活动的广告。

ActionLink 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

ActionPlatform

ActionLinkType

OrderOnlineMetadata

FulfillmentOption

FulfillmentType

AvailableDay

日期

FeeDetails

NoFee

MinimumFee

FixedFee

FoodOrderingMetadata

FeeDetails

FeeType

FeeAmount

Money

MoneyRange

QuantitativeValue

RangeValue

DurationRange

AdvanceOrderDetails

EventMetadata

Surface

ActionLink