- JSON 表示法
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- Date
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- 资金
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
- EventMetadata
- Surface
一个操作网址,包含所用语言、支持的国家/地区列表以及可选平台(表示应在哪个平台上执行此操作)。
| JSON 表示法 | 
|---|
| { "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( | 
| 字段 | |
|---|---|
| url | 
 此操作链接的入口点网址。 | 
| language | 
 BCP-47 语言标记,用于标识此 URI 中的内容所支持的语言。 | 
| restricted | 
 ISO 3166-1 alpha-2 国家/地区代码。留空即表示国家/地区范围不限。 | 
| platform | 
 用于指明应在哪个平台上执行此操作。如果未设置此字段,ACTION_PLATFORM_WEB_APPLICATION 将用作后备平台。 | 
| action | 
 预定的操作类型。 | 
| order | 
 在线订单链接的元数据。支持 ActionLinkType 为 ACTION_LINK_TYPE_SHOP_ONLINE 的操作。 | 
| food | 
 订餐链接的元数据。支持操作类型:*  | 
| event | 
 有关活动行业独有的操作链接的其他信息。 | 
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 ( | 
| 字段 | |
|---|---|
| fulfillment | 
 适用于“在线订购”操作链接的可用执行方式选项。 | 
FulfillmentOption
线上订餐操作链接的执行方式选项。
| JSON 表示法 | 
|---|
| { "fulfillmentType": enum ( | 
| 字段 | |
|---|---|
| fulfillment | 
 必需。履单类型。 | 
| available | 
 必需。此履单方式可供使用的日期列表(最好至少 2 天)。 | 
| fee | 
 必需。履单方法的费用详情。 | 
| minimum | 
 必需。与操作链接关联的履单方式的最低订单金额。 | 
FulfillmentType
与操作链接相关联的执行方式类型。
| 枚举 | |
|---|---|
| FULFILLMENT_TYPE_UNSPECIFIED | 未指定履单类型。 | 
| FULFILLMENT_TYPE_DELIVERY | 履单类型为配送。 | 
| FULFILLMENT_TYPE_PICKUP | 履单类型为“提货”。 | 
AvailableDay
按天可用性。
| JSON 表示法 | 
|---|
| {
  "fulfillmentDate": {
    object ( | 
| 字段 | |
|---|---|
| fulfillment | 
 必需。履单方法的可用日期。假定为商家所在的时区。 | 
| last | 
 必需。Unix 时间戳。用户上次可在  例如,如果 fulfillmentDate 为 2020-08-10:- lastOrderingTime 值为 2020-08-10 18:00 表示,为了在 2020-08-10 收到订单,客户必须在当天下午 6 点之前下单。- 如果 lastOrderingTime 的值为 2020-08-08 20:00,则表示客户必须在前两天晚上 8 点之前下单,才能在 2020-08-10 收到订单。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: | 
日期
表示整个或部分日历日期(例如生日)。一天中的时间和时区要么在别处指定,要么不重要。日期相对于公历。可以表示以下任一情况:
- 包含非零年份、月份和天值的完整日期。
- 月份和天,年份值为零(例如周年纪念日)。
- 单独的年份,月份和天值为零。
- 年份和月份,天值为零(例如,信用卡到期日期)。
相关类型:
- google.type.TimeOfDay
- google.type.DateTime
- google.protobuf.Timestamp
| JSON 表示法 | 
|---|
| { "year": integer, "month": integer, "day": integer } | 
| 字段 | |
|---|---|
| year | 
 日期中的年份。必须介于 1 到 9999 之间,或为 0(即指定不含年份的日期)。 | 
| month | 
 一年中的第几个月。必须介于 1 到 12 之间,或为 0(即只指定年份,不指定月份和天值)。 | 
| day | 
 一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效,或为 0(即天不重要,指定单独的年份或者年份和月份)。 | 
FeeDetails
与操作链接关联的履单方法的费用详情。
| JSON 表示法 | 
|---|
| { // Union field | 
| 字段 | |
|---|---|
| 联合字段 fee_details。履单方法的费用模式。fee_details只能是下列其中一项: | |
| no | 
 履单方法免费。 | 
| base | 
 与履单方法相关的基本费用。 | 
| fixed | 
 与履单方式相关联的固定费用。 | 
NoFee
此类型没有字段。
与操作链接关联的执行方式无需收费。
MinimumFee
与操作链接关联的履单方法所需的最低费用。
| JSON 表示法 | 
|---|
| {
  "baseFeeAmount": {
    object ( | 
| 字段 | |
|---|---|
| base | 
 必需。该履单方式的基本费用金额。 | 
FixedFee
与操作链接关联的履单方法所需的固定费用。
| JSON 表示法 | 
|---|
| {
  "amount": {
    object ( | 
| 字段 | |
|---|---|
| amount | 
 必需。履单方法的固定费用金额。 | 
FoodOrderingMetadata
订餐操作链接的元数据。
| JSON 表示法 | 
|---|
| { "feeDetails": [ { object ( | 
| 字段 | |
|---|---|
| fee | 
 除商品总金额外,向用户收取的费用的详细信息。针对不同类型的费用(例如服务费、配送费等)重复。 | 
| advance | 
 有关提前订购支持(也称为提前下单)的详细信息。用户可以下单,以便稍后(而不是立即)完成订单。 | 
| 联合字段 fulfillment_duration_options。订单确认后的履单时长。对于送餐订单,此属性是指距离送餐完毕的时长。对于自提订单,表示食物准备好自提所需的时间。fulfillment_duration_options只能是下列其中一项: | |
| fulfillment | 
 固定时长。例如:30 分钟。 该时长以秒为单位,最多包含九个小数位,以“ | 
| fulfillment | 
 时长范围。示例:* 30 分钟到 45 分钟 * 超过 30 分钟 * 不到 50 分钟 | 
FeeDetails
费用详情。
| JSON 表示法 | 
|---|
| { "type": enum ( | 
| 字段 | |
|---|---|
| type | 
 费用类型。(必填) | 
| fee | 
 以单位货币和/或购物车价值百分比表示的费用金额。(必填) | 
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% 的比例和百分比组合2.5 美元(最低),25.5% 和4.5 美元(最高),10% 和1.5-2.5 美元、10.5%-20% 和2.5-3.5 美元
| JSON 表示法 | 
|---|
| { "cartPercentage": { object ( | 
| 字段 | |
|---|---|
| cart | 
 费用占购物车价值的百分比。支持范围(有界限和无界限)或固定百分比。值应介于 0 到 100 之间。示例:* 固定 5.5% * 至少 5.5% * 不超过 5.5% * 4.5% 到 5.5% | 
| 联合字段 amount_options。用于指定货币金额的选项。amount_options只能是下列其中一项: | |
| amount | 
 固定金额。例如 USD 3.5。 | 
| amount | 
 金额范围。示例:* 3.5 美元到 5.5 美元 * 至少 3.5 美元 * 不超过 5.5 美元 | 
| amount | 
 未知金额。 | 
金钱
表示含有货币类型的金额。
| JSON 表示法 | 
|---|
| { "currencyCode": string, "units": string, "nanos": integer } | 
| 字段 | |
|---|---|
| currency | 
 ISO 4217 中定义的由三个字母组成的货币代码。 | 
| units | 
 金额的整数单位。例如,如果  | 
| nanos | 
 金额的纳诺 (10^-9) 单位数。这个值必须在 -999999999(含)和 +999999999(含)之间。如果  | 
MoneyRange
用于封装可能有界限或无界限的金额范围。至少需要 minAmount 和 maxAmount 之一。
| JSON 表示法 | 
|---|
| { "minAmount": { object ( | 
| 字段 | |
|---|---|
| min | 
 最低金额。 | 
| max | 
 最高金额。 | 
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。(必需)value_options只能是以下选项之一: | |
| value | 
 奇异值。例如:5.6 | 
| value | 
 也可以是开放式或有界限值的范围。例如:* 最少 5.5 * 最多 5.5 * 5.5 至 6.5 | 
RangeValue
取值范围,使 minValue <maxValue。至少需要 minValue 和 maxValue 中的一个。
| JSON 表示法 | 
|---|
| { "minValue": number, "maxValue": number } | 
| 字段 | |
|---|---|
| min | 
 最小值。 | 
| max | 
 最大值。 | 
DurationRange
时长范围的封装容器,可以是有界限的,也可以是无界限的。至少需要 minDuration 和 maxDuration 时长中的一个。
| JSON 表示法 | 
|---|
| { "minDuration": string, "maxDuration": string } | 
| 字段 | |
|---|---|
| min | 
 时长下限。 该时长以秒为单位,最多包含九个小数位,以“ | 
| max | 
 时长上限。 该时长以秒为单位,最多包含九个小数位,以“ | 
AdvanceOrderDetails
如需提前下单支持,请与我们联系。
| JSON 表示法 | 
|---|
| { "isSupported": boolean } | 
| 字段 | |
|---|---|
| is | 
 如果支持预订(也称为提前订购),则为 true。(必填) | 
EventMetadata
有关活动行业独有的操作链接的其他信息。
| JSON 表示法 | 
|---|
| {
  "surface": enum ( | 
| 字段 | |
|---|---|
| surface | 
 与操作链接相关的预定事件界面。该维度仅用于“事件”类别。 | 
Surface
与操作链接相关的预定事件界面。此字段仅适用于“活动”类别。
| 枚举 | |
|---|---|
| SURFACE_UNSPECIFIED | 未指定 surface。 | 
| SURFACE_SEARCH | 操作链接是在 Google 搜索中预订活动门票。 | 
| SURFACE_YOUTUBE | 操作链接是在 YouTube 中预订活动门票。 | 
| SURFACE_ADS | 操作链接是点击与事件有关的广告。 |