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`	出貨類型為「運送」。
`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，表示顧客必須在當天下午 6 點前下單，才能在 2020-08-10 收到訂單。lastOrderingTime 值為 2020-08-08 20:00，表示顧客必須在兩天前的晚上 8 點前下單，才能在 2020-08-10 收到訂單。使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例：`"2014-10-02T15:01:23Z"`、`"2014-10-02T15:01:23.045123456Z"` 或 `"2014-10-02T15:01:23+05:30"`。

fulfillmentDate

object (Date)

必填。可使用運送方式的日期。系統會假設時間位於商家時區。

lastOrderingTime

string (Timestamp format)

必填。Unix 時間戳記。使用者最晚可在 fulfillmentDate訂購並收到商品。換句話說，在 lastOrderingTime 之後，fulfillmentDate 將不再顯示為可用。

舉例來說，如果 fulfillmentDate 為 2020-08-10，則 lastOrderingTime 值為 2020-08-10 18:00，表示顧客必須在當天下午 6 點前下單，才能在 2020-08-10 收到訂單。lastOrderingTime 值為 2020-08-08 20:00，表示顧客必須在兩天前的晚上 8 點前下單，才能在 2020-08-10 收到訂單。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

日期

表示完整或部分的日曆日期，例如生日。您可以視重要性決定是否要在別處指定時段和時區。日期以公曆為主，可代表下列其中一項：

完整日期，具有非零的年、月和日值。
月和日，年值為零 (例如週年紀念日)。
只有年，月和日值為零。
年和月，日值為零 (例如信用卡到期日)。

相關類型：

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)` 固定金額。例如 USD 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 定義的貨幣代碼，由 3 個字母組成。
`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 定義的貨幣代碼，由 3 個字母組成。

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` 如果支援預先下單 (又稱「提前下單」)，則為 True。(必填)

isSupported

boolean

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

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