交易 API 將於 2023 年 5 月 3 日淘汰,並將於 2023 年 6 月 13 日淘汰。詳情請參閱「
對話動作已淘汰」。
Method: orders.createWithCustomToken
使用 Google 擷取的自訂符記建立及傳回新訂單。使用這個方法的開發人員應在要求中設定 Google 傳遞的 userToken。如果開發人員/商家是代表訂單 (而非交易和 AMP 流程) 直接將訂單儲存至 Google,會使用這個方法。
HTTP 要求
POST https://actions.googleapis.com/v3/orders:createWithCustomToken
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
欄位 |
header |
object (OrderRequestHeader )
必要:建立訂單要求的標頭。
|
order |
object (Order )
必填:要建立的訂單。 注意:1.下列欄位一律必須建立有效的訂單:order.create_time、order.merchant_order_id、order.contents.line_items、order.contents.line_items.id 2。訂單必須至少包含 1 個委刊項,且委刊項必須定義垂直類別/擴充功能。3. 所有額外資訊 (訂單層級和 line_item 層級) 都必須對應到 1 個產業類型,例如如果訂單代表多於 1 個產業,則屬於無效訂單。
|
userToken |
string
必要:Google 透過非同步管道提供給合作夥伴的加密權杖。
|
回應主體
如果成功,回應主體會包含 Order
的執行例項。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-12 (世界標準時間)。
[null,null,["上次更新時間:2024-09-12 (世界標準時間)。"],[[["This document explains the `orders:createWithCustomToken` method, which creates new Google Orders using a custom, Google-minted token."],["Developers should include the `userToken` provided by Google in the request."],["This process is typically used when developers or merchants directly save orders to Google on behalf of the order, rather than using Transactions or AMP flows."],["The request body must include a header, order details (with at least one line item and a specified vertical), and the `userToken`."],["A successful response will return the created `Order` object."]]],["This document outlines how to create a new order using a custom Google-minted token. It involves sending a `POST` request to `https://actions.googleapis.com/v3/orders:createWithCustomToken`. The request body requires a JSON structure with `header` (OrderRequestHeader object), `order` (Order object, including required fields like `create_time`, `merchant_order_id`, and line items), and a `userToken` (an encrypted token from Google). Successful requests return an `Order` object in the response body. The order must contain at least one line item, and all extensions should map to a single vertical type.\n"]]