交易 API 將於 2023 年 5 月 3 日淘汰,並將於 2023 年 6 月 13 日淘汰。詳情請參閱「
對話動作已淘汰」。
Method: orders.createWithCustomToken
bookmark_borderbookmark
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用 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-13 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-13 (世界標準時間)。"],[[["Creates new Orders using a custom token provided by Google, enabling developers to save orders directly on behalf of the user."],["Requires a `POST` request to `https://actions.googleapis.com/v3/orders:createWithCustomToken` with specific data in the request body."],["The request body must contain `header`, `order`, and `userToken` fields with specified data structures and requirements."],["A successful response returns the created `Order` object with details of the order."]]],["This describes the process of creating a new order using a custom Google-minted token. A `POST` request is sent to `https://actions.googleapis.com/v3/orders:createWithCustomToken`. The request body requires a JSON payload with `header`, `order` (including `create_time`, `merchant_order_id`, and at least one valid `line_item` with an ID and vertical extension), and `userToken` (an encrypted token from Google). A successful request returns an `Order` instance in the response body.\n"]]