ב-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 ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2025-07-26 (שעון UTC)."],[],["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"]]