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

出貨時間和費用 (僅限舊版)

本教學課程將逐步說明：

概略說明支援哪些費用和履行時間用途
如何在動態饋給中指定action_link的訂單履行時間和費用的具體操作說明
準確度期望

如需顯示訂單執行時間和費用用量的完整動態饋給範例，請參閱訂單重新導向 EPA 範例。

費用和處理時間用途

費用用途

我們提供多種方式來指定費用。下文將說明支援的不同用途，並提供一些範例語言，類似於使用者在前端看到的內容。

固定費用：「運費 $5 美元」或「服務費 $5 美元」
百分比費用：「運費 5%」或「服務費 5%」
費用範圍：「運費 $2 至 $10」或「服務費 3% 至 6%」
開放式範圍："外送費起價 5%" 或 "服務費最高 $20 美元"

如上述範例所示，您可以將費用指定為運費或服務費。你也可以指定多項費用 (例如「服務費 5%-10%，運費 $5 美元」)。

不支援需要在一天中更新費用，或根據使用者資訊變更費用的用途。

訂單履行時間用途

我們允許使用多種格式指定可預訂時間，以確保你提供的資料正確無誤。以下說明支援的不同用途，以及使用者在前端看到的語言範例。

固定時間："30 分鐘內送達" 或 "15 分鐘內取貨"
時間範圍："30 分鐘至 1 小時內送達"或 "15 到 20 分鐘內取貨"
開放式時間範圍：「10 分鐘內送達」或「1 小時內取貨」

你可以使用通用格式 (如下所述) 指定取貨和送達的履行時間。如上述範例所示，向使用者顯示的文字會反映動作連結中指定的履行類型。

不支援需要在一天中更新時間，或根據使用者資訊變更的用途。

透過動態饋給指定訂單出貨時間

動作連結的訂單履行時間會納入商家動態饋給 action_link 訊息，並列為 food_ordering_metadata 欄位的一部分。針對與商家相關聯的每個 action_link，您必須使用其中一個訊息路徑提供履行資訊。

固定出貨時間

Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

這類訊息應採用以下格式：

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

範圍出貨時間

Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

這則訊息的格式應如下：

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

警告：請勿在單一 action_link 物件中同時指定 fulfillment_lead_time_duration 和 fulfillment_lead_time_duration_range。

注意：fulfillment_lead_time_duration、fulfillment_lead_time_duration_range.min_duration 和 fulfillment_lead_time_duration_range.max_duration 的類型為 google.protobuf.Duration，可為使用者提供服務完成動作的預估到達時間。

透過動態饋給指定費用

與訂單履行時間類似，費用可納入 food_ordering_metadata 欄位下方的 action_link 訊息中。對於與商家相關的每個 action_link，您可以使用訊息路徑提供費用資訊：

merchant.action_link.food_ordering_metadata.fee_details

以下列舉幾個不同用途的範例。

固定運費 $1.99 美元：

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]

百分比外送費 5.6%。

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]

服務費範圍為 $1.99 至 $9.99 美元

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]

服務費百分比範圍為 1.2% 到 2.7%

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]

兩項費用：服務費 $5 美元和運費 1.2%。

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

注意：amount 和 amount_range 項目的類型為 google.type.Money

費用和出貨時間準確度

費用準確度

提供商家的費用資料時，請務必提供正確的費用資訊。請納入所有可能適用於訂單的運費和服務費。

我們瞭解費用可能會因時間和使用者而異。因此，我們提供以範圍 (包括開放式範圍) 指定費用的功能。如果費用可能有顯著差異，請務必確保提供的範圍涵蓋使用者在交易期間可能看到的費用。

如果不確定您的案件需要哪些具體資訊，請與 Actions Center 聯絡窗口聯絡。

訂單履行時間準確度

據瞭解，訂單履行時間會因各種因素而異。這些因素包括：

根據訂單大小變更訂單履行時間
根據完成訂購和結帳的時間，變更訂單履行時間
透過動態饋給更新訂單出貨時間變更的延遲時間
使用者的運送地址。

在某些情況下，向使用者初始顯示的訂單履行時間，可能與他們在結帳時看到的實際履行時間不符。實現時間導入的目標並非完全消除這些問題，而是盡可能經常向使用者提供明確資訊。

合作夥伴應提供實作項目，盡可能經常向使用者顯示正確的履行時間。如果這些因素導致時間上有明顯差異，建議您提供涵蓋這些差異的時間範圍。此外，如果訂單詳細資料導致履行時間變更，請在使用者進入訂購流程時，清楚向他們顯示這項資訊。

如果不確定自己的情況需要哪些具體資訊，請與 Actions Center 聯絡窗口聯絡。