本頁面由 Cloud Translation API 翻譯而成。

ActionLink

JSON 表示法
ActionPlatform
ActionLinkType
OrderOnlineMetadata
- JSON 表示法
FulfillmentOption
- JSON 表示法
FulfillmentType
AvailableDay
- JSON 表示法
日期
- JSON 表示法
FeeDetails
- JSON 表示法
NoFee
MinimumFee
- JSON 表示法
FixedFee
- JSON 表示法
FoodOrderingMetadata
- JSON 表示法
FeeDetails
- JSON 表示法
FeeType
FeeAmount
- JSON 表示法
金額
- JSON 表示法
MoneyRange
- JSON 表示法
QuantitativeValue
- JSON 表示法
RangeValue
- JSON 表示法
DurationRange
- JSON 表示法
AdvanceOrderDetails
- JSON 表示法

動作網址；含有相關聯的語言、限定的國家/地區清單，以及要執行這個動作的特定平台 (選用)。

JSON 表示法

JSON 表示法
{ "url": string, "language": string, "restrictedCountry": [ string ], "platform": enum (`ActionPlatform`), "actionLinkType": enum (`ActionLinkType`), "orderOnlineMetadata": { object (`OrderOnlineMetadata`) }, "foodOrderingMetadata": { object (`FoodOrderingMetadata`) } }

{
  "url": string,
  "language": string,
  "restrictedCountry": [
    string
  ],
  "platform": enum (ActionPlatform),
  "actionLinkType": enum (ActionLinkType),
  "orderOnlineMetadata": {
    object (OrderOnlineMetadata)
  },
  "foodOrderingMetadata": {
    object (FoodOrderingMetadata)
  }
}

欄位
`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`。

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[]

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，表示消費者如要在 2020 年 8 月 10 日之前收到訂單，就必須在當天晚上 6 點前完成訂單。- lastOrderingTime 值為 2020-08-08 20:00。若客戶想要在 2020 年 8 月 10 日收到訂購商品，則必須在兩天前的晚上 8 點前完成訂購。 RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例：`"2014-10-02T15:01:23Z"` 和 `"2014-10-02T15:01:23.045123456Z"`。

fulfillmentDate

object (Date)

必要欄位。適用於執行要求方法的日期。假定為商家所在的時區。

lastOrderingTime

string (Timestamp format)

必要欄位。Unix 時間戳記。使用者上次可以訂購及收到商品的時間：fulfillmentDate。換句話說，在 lastOrderingTime 之後，fulfillmentDate 將不再顯示為可用。

舉例來說，如果 fulfillmentDate 是 2020-08-10: - lastOrderingTime 值為 2020-08-10 18:00，表示消費者如要在 2020 年 8 月 10 日之前收到訂單，就必須在當天晚上 6 點前完成訂單。- lastOrderingTime 值為 2020-08-08 20:00。若客戶想要在 2020 年 8 月 10 日收到訂購商品，則必須在兩天前的晚上 8 點前完成訂購。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

日期

代表完整或部分的日曆日期，例如生日。您可以指明時段和時區，或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項：

完整日期，具有非零的年、月和日值。
日期為 0 的月份和日期，例如週年紀念日。
有 1 年，第 0 個月卻為 0 天。
年和月，但數字為零 (例如信用卡到期日)。

相關類型：

google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp

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 可讓您指定本身或年份和月份，但這些日期不明顯。

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 分鐘。持續時間以秒為單位，最多 9 個小數位數，結尾為「`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% (上限) * 2 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` 金額不明。

金額

代表金額與其貨幣類型。

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)` 時間長度下限。持續時間以秒為單位，最多 9 個小數位數，結尾為「`s`」。範例：`"3.5s"`。
`maxDuration`	`string (Duration format)` 時間長度上限。持續時間以秒為單位，最多 9 個小數位數，結尾為「`s`」。範例：`"3.5s"`。

minDuration

string (Duration format)

時間長度下限。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

maxDuration

string (Duration format)

時間長度上限。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

AdvanceOrderDetails

預訂支援。

JSON 表示法
{ "isSupported": boolean }

欄位

欄位
`isSupported`	`boolean` 如果支援「提前訂單」，又稱為「預先訂購」則為 True。(必填)

isSupported

boolean

如果支援「提前訂單」，又稱為「預先訂購」則為 True。(必填)