- JSON 表示法
- ActionPlatform
- ActionLinkType
- OrderOnlineMetadata
- FulfillmentOption
- FulfillmentType
- AvailableDay
- 日期
- FeeDetails
- NoFee
- MinimumFee
- FixedFee
- FoodOrderingMetadata
- FeeDetails
- FeeType
- FeeAmount
- 金額
- MoneyRange
- QuantitativeValue
- RangeValue
- DurationRange
- AdvanceOrderDetails
動作網址;含有相關聯的語言、限定的國家/地區清單,以及要執行這個動作的特定平台 (選用)。
JSON 表示法 |
---|
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum ( |
欄位 | |
---|---|
url |
這個動作連結的進入點網址。 |
language |
BCP-47 語言標記;指示來自這個 URI 的內容可採用的語言。 |
restrictedCountry[] |
ISO 3166-1 alpha-2 國家/地區代碼。留空代表瀏覽權限不設限。 |
platform |
執行這個動作時所在的平台。如未設定此欄位,ACTION_PLATFORM_WEB_APPLICATION 將做為備用。 |
actionLinkType |
預定動作類型。 |
orderOnlineMetadata |
訂購線上連結中繼資料。支援使用 ACTION_LINK_TYPE_SHOP_ONLINE 的 ActionLinkType 動作。 |
foodOrderingMetadata |
訂餐連結的中繼資料。支援動作類型:* |
ActionPlatform
執行這個動作時所在的平台。一般備用選項是網頁應用程式。建議至少要有一個含有 ACTION_PLATFORM_WEB_APPLICATION 的 ActionLink。以 Android 和 iOS 做為平台的連結,只能在各自的系統上使用。
列舉 | |
---|---|
ACTION_PLATFORM_UNSPECIFIED |
未指定平台。 |
ACTION_PLATFORM_WEB_APPLICATION |
動作平台通常是網頁。 |
ACTION_PLATFORM_MOBILE_WEB |
動作平台是行動裝置上的網頁。 |
ACTION_PLATFORM_ANDROID |
動作平台是 Android OS。 |
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
訂單線上動作連結的出貨選項。
JSON 表示法 |
---|
{ "fulfillmentType": enum ( |
欄位 | |
---|---|
fulfillmentType |
必要欄位。執行要求類型。 |
availableDay[] |
必要欄位。可運送此出貨方式的日期清單 (建議至少 2 天)。 |
feeDetails |
必要欄位。出貨方法的費用詳細資料。 |
minimumOrder |
必要欄位。與動作連結相關聯的執行要求方法的最低訂購量。 |
FulfillmentType
與動作連結相關聯的執行要求類型。
列舉 | |
---|---|
FULFILLMENT_TYPE_UNSPECIFIED |
未指定執行要求類型。 |
FULFILLMENT_TYPE_DELIVERY |
出貨類型為「提交」。 |
FULFILLMENT_TYPE_PICKUP |
出貨類型為取貨。 |
AvailableDay
適用時段。
JSON 表示法 |
---|
{
"fulfillmentDate": {
object ( |
欄位 | |
---|---|
fulfillmentDate |
必要欄位。出貨方法的可用日期。假設以商家的時區為準。 |
lastOrderingTime |
必要欄位。Unix 時間戳記。使用者上次可於 舉例來說,如果 fulfillmentDate 為 2020-08-10: - lastOrderingTime 值為 2020-08-10 18:00,客戶就必須在當天的晚上 6 點前下單。- 如果 lastOrderingTime 值為 2020-08-08-08 20:00,客戶必須在 2020 年 8 月 10 日下午 8 點前下單。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
日期
代表完整或部分日曆的日期,例如生日。您可在其他位置指定日期和時間,或沒有其他選擇。日期以公曆為相對於公曆。可能代表下列其中一種:
- 完整日期,具有非零的年、月和日值。
- 月和日,出現零年 (例如週年紀念日)。
- 一個自己的年,分別為 0 個月和 0 天。
- 年份和月份,數字為零 (例如信用卡到期日)。
相關類型:
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 只能是下列其中一項: |
|
noFee |
執行方法不會收取任何費用。 |
baseFee |
與出貨方法相關聯的基本費用。 |
fixedFee |
與執行要求方法相關聯的固定費用。 |
NoFee
與動作連結相關聯的執行要求方法不必支付任何費用。
MinimumFee
與動作連結相關聯的出貨方法要求最低費用。
JSON 表示法 |
---|
{
"baseFeeAmount": {
object ( |
欄位 | |
---|---|
baseFeeAmount |
必要欄位。出貨方法的基本費用金額。 |
FixedFee
與動作連結相關聯的執行要求方法所需固定費用。
JSON 表示法 |
---|
{
"amount": {
object ( |
欄位 | |
---|---|
amount |
必要欄位。執行要求方法的固定費用金額。 |
FoodOrderingMetadata
訂餐動作連結的中繼資料。
JSON 表示法 |
---|
{ "feeDetails": [ { object ( |
欄位 | |
---|---|
feeDetails[] |
除了商品總金額外,使用者收取的費用詳細資料。為不同類型的費用 (例如服務費、運費等) 重複上述步驟。 |
advanceOrderDetails |
進階訂購支援的詳細資料又稱「預訂」,讓使用者能夠比現在更晚下單,進而履行服務。 |
聯集欄位 fulfillment_duration_options 。訂單確認中的訂單履行時間長度。如為外送訂單,則到餐點送達前所需的時間。如果是自取訂單,則在餐點準備自取前的時間長度。fulfillment_duration_options 只能是下列其中一項: |
|
fulfillmentLeadTimeDuration |
固定時間長度。例如:30 分鐘。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
fulfillmentLeadTimeDurationRange |
時間長度範圍。範例:* 30 至 45 分鐘 * 大於 30 分鐘 * 小於 50 分鐘 |
FeeDetails
費用詳細資料。
JSON 表示法 |
---|
{ "type": enum ( |
欄位 | |
---|---|
type |
費用類型。(必填) |
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% (最小) - $5%、10% (最小) - $5%、15% (最大) 和 $5.52 美元/百分比
JSON 表示法 |
---|
{ "cartPercentage": { object ( |
欄位 | |
---|---|
cartPercentage |
依購物車金額指定百分比的費用。支援範圍 (受限和無界限) 或固定百分比。值應介於 0 到 100。示例:* 固定為 5.5% * 至少 5.5% * 最多 5.5% * 4.5% 到 5.5% |
聯集欄位 amount_options 。指定金額的選項。amount_options 只能是下列其中一項: |
|
amount |
固定金額。例如 $3.5 美元。 |
amountRange |
金額範圍。示例:* 3.5 至 $5.5 美元 * 至少 $3.5 美元 * 最多 5.5 美元 |
amountUnknown |
金額不明。 |
金額
代表金額與其貨幣類型。
JSON 表示法 |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
欄位 | |
---|---|
currencyCode |
ISO 4217 定義的貨幣代碼 (由三個字母組成)。 |
units |
金額的整數單位。舉例來說,如果 |
nanos |
金額的十億分之一 (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 |
MoneyRange
可繫結或不受限制的貨幣金額範圍的包裝函式。至少須提供 minAmount 和 maxAmount。
JSON 表示法 |
---|
{ "minAmount": { object ( |
欄位 | |
---|---|
minAmount |
最低金額。 |
maxAmount |
金額上限。 |
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 |
valueRange |
可以是開放式或有界限的值範圍。範例:* 至少 5.5 * 最多 5.5 * 5.5 到 6.5 |
RangeValue
minValue
< maxValue
的值範圍。至少需要其中一個 minValue
和 maxValue
。
JSON 表示法 |
---|
{ "minValue": number, "maxValue": number } |
欄位 | |
---|---|
minValue |
最小值。 |
maxValue |
最大值。 |
DurationRange
包裝函式,涵蓋長度範圍可限製或不受限制。必須提供至少一個 minDuration 和 maxDuration。
JSON 表示法 |
---|
{ "minDuration": string, "maxDuration": string } |
欄位 | |
---|---|
minDuration |
時間長度下限。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
maxDuration |
時間長度上限。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
AdvanceOrderDetails
用於預先訂購支援。
JSON 表示法 |
---|
{ "isSupported": boolean } |
欄位 | |
---|---|
isSupported |
如果支援提前訂單 (也稱為「訂單前訂單」),則為 True。(必填) |