سيتم إيقاف واجهة برمجة تطبيقات المعاملات في 3 أيار (مايو) 2023، قبل إيقاف ميزة "إجراءات المحادثات" في 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- يجب ربط كل الإضافات (في كلٍّ من مستوى الطلب ومستوى line_item) بنوع عمودي واحد. لا يكون الطلب أمرًا صالحًا إذا كان يمثل أكثر من قطاع واحد.
|
userToken |
string
مطلوب: الرمز المميز المشفر الذي تقدمه Google للشريك عبر قناة غير متزامنة.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Order
.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]