تعديل الطلب من 3p إلى AOG يتم عرض INVALID_{9} إذا كان الرقم التعريفي للطلب فارغًا أو لا يساوي طلبًا حاليًا.
طلب HTTP
PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
orderUpdate.order.merchantOrderId |
مطلوب: حصل التاجر على مُعرّف الطلب الداخلي. يجب أن يكون هذا المعرّف فريدًا ومطلوبًا لعمليات تعديل الطلبات اللاحقة. ويمكن ضبط هذا المعرّف على قيمة googleOrderId المقدَّمة أو أي قيمة فريدة أخرى. يُرجى العلم أنّ رقم التعريف المعروض للمستخدمين هو uservisibleOrderId، وقد يكون هذا المعرّف قيمة مختلفة وسهلة الاستخدام. الحد الأقصى المسموح به للطول هو 64 حرفًا. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "header": { object ( |
الحقول | ||
---|---|---|
header |
عنوان لطلب التعديل. |
|
orderUpdate.type |
مهملة: يمكنك استخدام OrderUpdate.update_mask بدلاً من ذلك. إذا كان النوع = SNAPSHOT، يجب أن يكون OrderUpdate.order الطلب بالكامل. إذا كان النوع = ORDER_STATUS، فهذا هو التغيير في حالة مستوى الطلب. لا يتم اختيار سوى order.last_update_time وكذلك هذه الحالة الرأسية. ملاحظة: لا يتوافق type.ORDER_STATUS إلا مع تحديثات حالة PurcahaseOrderExtension، وليست هناك خطة لتمديد هذا الدعم. بدلاً من ذلك، ننصح باستخدام updateMask لأنه أكثر عمومية وقابلاً للتوسع ويمكن استخدامه لجميع المجالات. |
|
orderUpdate.order.googleOrderId |
مُعرّف الطلب المخصّص لشركة Google |
|
orderUpdate.order.userVisibleOrderId |
تمثّل هذه السمة معرّف المستخدم الذي يشير إلى الطلب الحالي. ويجب أن يكون هذا المعرّف متسقًا مع المعرّف المعروض لهذا الطلب في السياقات الأخرى، بما في ذلك المواقع الإلكترونية والتطبيقات والبريد الإلكتروني. |
|
orderUpdate.order.userVisibleStateLabel |
مهملة: يمكنك استخدام حالة OrderExtensions بدلاً من ذلك. تصنيف مرئي للمستخدم لحالة هذا الطلب. |
|
orderUpdate.order.buyerInfo |
معلومات حول المشتري. |
|
orderUpdate.order.image |
صورة مرتبطة بالطلب |
|
orderUpdate.order.createTime |
مطلوب: تاريخ ووقت إنشاء الطلب يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
|
orderUpdate.order.lastUpdateTime |
تاريخ ووقت آخر تعديل للطلب مطلوبة من أجل OrderUpdate يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
|
orderUpdate.order.transactionMerchant |
التاجر الذي سهّل عملية الدفع وقد يختلف هذا عن مقدّم الخدمات على مستوى العنصر. مثال: طلب Expedia يحتوي على بند من ANA. |
|
orderUpdate.order.contents |
مطلوب: محتوى الطلب الذي هو مجموعة من العناصر. |
|
orderUpdate.order.priceAttributes[] |
السعر والخصومات والضرائب وما إلى ذلك. |
|
orderUpdate.order.followUpActions[] |
إجراءات المتابعة على مستوى الطلب |
|
orderUpdate.order.paymentData |
البيانات المتعلّقة بالدفع مقابل الطلب |
|
orderUpdate.order.termsOfServiceUrl |
رابط لبنود الخدمة التي تنطبق على الطلب/الطلب المقترح. |
|
orderUpdate.order.note |
الملاحظات المرفقة بالطلب |
|
orderUpdate.order.promotions[] |
جميع العروض الترويجية المرتبطة بهذا الطلب. |
|
orderUpdate.order.disclosures[] |
الإفصاحات المرتبطة بهذا الطلب |
|
orderUpdate.order.vertical |
مهملة: يمكنك استخدام مواضع الإعلانات بدلاً من ذلك. وسيتم تطبيق هذه السمات على جميع العناصر، ما لم يتم إلغاؤها في بعض العناصر. يجب أن يتطابق هذا المجال مع نوع موضع الإعلان على مستوى العنصر. القيم المتاحة: كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
|
orderUpdate.updateMask |
ملاحظة: هناك توصيات/توصيات في ما يلي للحقول الخاصة التالية: 1. سيتم دائمًا تعديل order.last_update_time كجزء من طلب التعديل. 2- سيتم تجاهل order.create_time وorder.google_order_id وorder.merchant_order_id إذا تم توفيرهما كجزء من قناع التحديث. قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
|
orderUpdate.userNotification |
في حال تحديد هذه السمة، يتم عرض إشعار للمستخدم بالعنوان والنص المحدَّدين. تحديد إشعار هو اقتراح للإشعار ولا يمكن ضمان أن ينتج عنه إشعار. |
|
orderUpdate.reason |
سبب التغيير/التحديث. |
|
حقل الاتحاد verticals وسيتم تطبيق هذه السمات على جميع العناصر، ما لم يتم إلغاؤها في بعض العناصر. يجب أن يتطابق هذا المجال مع نوع موضع الإعلان على مستوى العنصر. يمكن أن تكون السمة "verticals " واحدة فقط مما يلي: |
||
orderUpdate.order.purchase |
طلب الشراء |
|
orderUpdate.order.ticket |
طلب التذكرة |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Order
.
OrderUpdate
تعديل الطلب
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مهملة: يمكنك استخدام OrderUpdate.update_mask بدلاً من ذلك. إذا كان النوع = SNAPSHOT، يجب أن يكون OrderUpdate.order الطلب بالكامل. إذا كان النوع = ORDER_STATUS، فهذا هو التغيير في حالة مستوى الطلب. لا يتم اختيار سوى order.last_update_time وكذلك هذه الحالة الرأسية. ملاحظة: لا يتوافق type.ORDER_STATUS إلا مع تحديثات حالة PurcahaseOrderExtension، وليست هناك خطة لتمديد هذا الدعم. بدلاً من ذلك، ننصح باستخدام updateMask لأنه أكثر عمومية وقابلاً للتوسع ويمكن استخدامه لجميع المجالات. |
order |
|
updateMask |
ملاحظة: هناك توصيات/توصيات في ما يلي للحقول الخاصة التالية: 1. سيتم دائمًا تعديل order.last_update_time كجزء من طلب التعديل. 2- سيتم تجاهل order.create_time وorder.google_order_id وorder.merchant_order_id إذا تم توفيرهما كجزء من قناع التحديث. قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
userNotification |
في حال تحديد هذه السمة، يتم عرض إشعار للمستخدم بالعنوان والنص المحدَّدين. تحديد إشعار هو اقتراح للإشعار ولا يمكن ضمان أن ينتج عنه إشعار. |
reason |
سبب التغيير/التحديث. |
Type
مهملة: يمكنك استخدام OrderUpdate.update_mask بدلاً من ذلك. تم السماح بالتحديثات لأحد الطلبات.
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
النوع غير محدّد، ويجب عدم ضبط هذه السمة بشكلٍ صريح. |
ORDER_STATUS |
عدِّل حالة الطلب فقط. |
SNAPSHOT |
تعديل نبذة عن الطلب |
UserNotification
إشعار اختياري للمستخدم لعرضه كجزء من تعديل الطلب
تمثيل JSON | |
---|---|
{ "title": string, "text": string } |
الحقول | |
---|---|
title |
عنوان إشعار المستخدِم. الحد الأقصى المسموح به للطول هو 30 حرفًا. |
text |
محتويات الإشعار. الحد الأقصى المسموح به للطول هو 100 حرف. |