سيتم إيقاف واجهة برمجة تطبيقات المعاملات في 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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 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"]]