- 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 |
操作链接是点击与事件有关的广告。 |