Method: orders.createWithCustomToken

ينشئ الطلب الجديد ويعرضه باستخدام رمز مميّز مخصّص أنشأته Google. وعلى المطوّرين الذين يستخدمون هذه الطريقة ضبط رمز userToken الذي قدّمته Google في الطلب. وتُستخدَم هذه الطريقة في الحالات التي يحفظ فيها المطوّرون/التاجر الطلبات مباشرةً في Google بالنيابة عن الطلب (بدلاً من المعاملات وخطوات AMP).

طلب HTTP

POST https://actions.googleapis.com/v3/orders:createWithCustomToken

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "header": {
    object (OrderRequestHeader)
  },
  "order": {
    object (Order)
  },
  "userToken": string
}
الحقول
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.