本頁面由 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 表示法
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

執行這個動作時所在的平台。一般備用選項是網頁應用程式。建議至少要有一個含有 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`	出貨類型為「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-08-10 當天下午 6 點前下單，才能在 2020-08-10 收到訂購商品。- lastOrderingTime 值為 2020-08-08 20:00。若客戶想要在 2020 年 8 月 10 日收到訂購商品，則必須在兩天前的晚上 8 點前完成訂購。採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 `"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-08-10 當天下午 6 點前下單，才能在 2020-08-10 收到訂購商品。- lastOrderingTime 值為 2020-08-08 20:00。若客戶想要在 2020 年 8 月 10 日收到訂購商品，則必須在兩天前的晚上 8 點前完成訂購。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

日期

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

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

相關類型：

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% (最高) * 範圍和百分比的組合：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` 金額不明。

金額

代表金額與其貨幣類型。

JSON 表示法
{ "currencyCode": string, "units": string, "nanos": integer }

欄位

欄位
`currencyCode`	`string` ISO 4217 定義的貨幣代碼 (由三個字母表示)。
`units`	`string (int64 format)` 金額的整數單位。舉例來說，如果 `currencyCode` 為 `"USD"`，則 1 個單位為 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 個單位為 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` 如果系統支援預訂服務 (又稱為提前訂購)，則為「是」。(必填)

isSupported

boolean

如果系統支援預訂服務 (又稱為提前訂購)，則為「是」。(必填)

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

金額

MoneyRange

QuantitativeValue

RangeValue

DurationRange

AdvanceOrderDetails

EventMetadata

Surface

ActionLink