ב-3 במאי 2023 נוציא משימוש את Transactions API, לפני ההוצאה משימוש של Conversations Actions ב-13 ביוני 2023.
כאן תוכלו לקרוא מידע נוסף על ההוצאה משימוש של 'פעולות שיחה'.
Method: orders.createWithCustomToken
יצירה ומחזירה את ההזמנה החדשה באמצעות אסימון מותאם אישית שהוטבע על ידי Google. מפתחים שמשתמשים בשיטה הזו צריכים להגדיר את userToken שהוענק על ידי Google בבקשה. כדאי להשתמש בשיטה הזו במקרים שבהם המפתחים או המוכר שומרים הזמנות ישירות ל-Google בשם ההזמנה (במקום 'עסקאות' ו'תהליך AMP').
בקשת HTTP
POST https://actions.googleapis.com/v3/orders:createWithCustomToken
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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. ההזמנה צריכה לכלול לפחות פריט אחד, ולפריט צריכה להיות מוגדרת תעשייה/הרחבה. 3. כל התוספים (ברמת ההזמנה וברמת הפריט) חייבים להיות ממופה לסוג אחד של קטגוריה עסקית. כלומר, הזמנה לא תקפה אם היא מייצגת יותר מקטגוריה עסקית אחת.
|
userToken |
string
נדרש: אסימון מוצפן שמסופק לשותף על ידי Google דרך ערוץ אסינכרוני.
|
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Order
.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-12 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-12 (שעון UTC)."],[[["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"]]