Method: orders.patch

تعديل الطلب من 3p إلى AOG يتم عرض INVALID_{9} إذا كان الرقم التعريفي للطلب فارغًا أو لا يساوي طلبًا حاليًا.

طلب HTTP

PATCH https://actions.googleapis.com/v3/orders/{orderUpdate.order.merchantOrderId}

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

مَعلمات المسار

المَعلمات
orderUpdate.order.merchantOrderId

string

مطلوب: حصل التاجر على مُعرّف الطلب الداخلي. يجب أن يكون هذا المعرّف فريدًا ومطلوبًا لعمليات تعديل الطلبات اللاحقة. ويمكن ضبط هذا المعرّف على قيمة googleOrderId المقدَّمة أو أي قيمة فريدة أخرى. يُرجى العلم أنّ رقم التعريف المعروض للمستخدمين هو uservisibleOrderId، وقد يكون هذا المعرّف قيمة مختلفة وسهلة الاستخدام. الحد الأقصى المسموح به للطول هو 64 حرفًا.

نص الطلب

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

تمثيل JSON
{
  "header": {
    object (OrderRequestHeader)
  },
  "orderUpdate": {
    "type": enum (Type),
    "order": {
      "googleOrderId": string,
      "userVisibleOrderId": string,
      "userVisibleStateLabel": string,
      "buyerInfo": {
        object (UserInfo)
      },
      "image": {
        object (Image)
      },
      "createTime": string,
      "lastUpdateTime": string,
      "transactionMerchant": {
        object (Merchant)
      },
      "contents": {
        object (Contents)
      },
      "priceAttributes": [
        {
          object (PriceAttribute)
        }
      ],
      "followUpActions": [
        {
          object (Action)
        }
      ],
      "paymentData": {
        object (PaymentData)
      },
      "termsOfServiceUrl": string,
      "note": string,
      "promotions": [
        {
          object (Promotion)
        }
      ],
      "disclosures": [
        {
          object (Disclosure)
        }
      ],
      "vertical": {
        "@type": string,
        field1: ...,
        ...
      },

      // Union field verticals can be only one of the following:
      "purchase": {
        object (PurchaseOrderExtension)
      },
      "ticket": {
        object (TicketOrderExtension)
      }
      // End of list of possible types for union field verticals.
    },
    "updateMask": string,
    "userNotification": {
      object (UserNotification)
    },
    "reason": string
  }
}
الحقول
header

object (OrderRequestHeader)

عنوان لطلب التعديل.

orderUpdate.type
(deprecated)

enum (Type)

مهملة: يمكنك استخدام OrderUpdate.update_mask بدلاً من ذلك. إذا كان النوع = SNAPSHOT، يجب أن يكون OrderUpdate.order الطلب بالكامل. إذا كان النوع = ORDER_STATUS، فهذا هو التغيير في حالة مستوى الطلب. لا يتم اختيار سوى order.last_update_time وكذلك هذه الحالة الرأسية. ملاحظة: لا يتوافق type.ORDER_STATUS إلا مع تحديثات حالة PurcahaseOrderExtension، وليست هناك خطة لتمديد هذا الدعم. بدلاً من ذلك، ننصح باستخدام updateMask لأنه أكثر عمومية وقابلاً للتوسع ويمكن استخدامه لجميع المجالات.

orderUpdate.order.googleOrderId

string

مُعرّف الطلب المخصّص لشركة Google

orderUpdate.order.userVisibleOrderId

string

تمثّل هذه السمة معرّف المستخدم الذي يشير إلى الطلب الحالي. ويجب أن يكون هذا المعرّف متسقًا مع المعرّف المعروض لهذا الطلب في السياقات الأخرى، بما في ذلك المواقع الإلكترونية والتطبيقات والبريد الإلكتروني.

orderUpdate.order.userVisibleStateLabel
(deprecated)

string

مهملة: يمكنك استخدام حالة OrderExtensions بدلاً من ذلك. تصنيف مرئي للمستخدم لحالة هذا الطلب.

orderUpdate.order.buyerInfo

object (UserInfo)

معلومات حول المشتري.

orderUpdate.order.image

object (Image)

صورة مرتبطة بالطلب

orderUpdate.order.createTime

string (Timestamp format)

مطلوب: تاريخ ووقت إنشاء الطلب

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

orderUpdate.order.lastUpdateTime

string (Timestamp format)

تاريخ ووقت آخر تعديل للطلب مطلوبة من أجل OrderUpdate

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

orderUpdate.order.transactionMerchant

object (Merchant)

التاجر الذي سهّل عملية الدفع وقد يختلف هذا عن مقدّم الخدمات على مستوى العنصر. مثال: طلب Expedia يحتوي على بند من ANA.

orderUpdate.order.contents

object (Contents)

مطلوب: محتوى الطلب الذي هو مجموعة من العناصر.

orderUpdate.order.priceAttributes[]

object (PriceAttribute)

السعر والخصومات والضرائب وما إلى ذلك.

orderUpdate.order.followUpActions[]

object (Action)

إجراءات المتابعة على مستوى الطلب

orderUpdate.order.paymentData

object (PaymentData)

البيانات المتعلّقة بالدفع مقابل الطلب

orderUpdate.order.termsOfServiceUrl

string

رابط لبنود الخدمة التي تنطبق على الطلب/الطلب المقترح.

orderUpdate.order.note

string

الملاحظات المرفقة بالطلب

orderUpdate.order.promotions[]

object (Promotion)

جميع العروض الترويجية المرتبطة بهذا الطلب.

orderUpdate.order.disclosures[]

object (Disclosure)

الإفصاحات المرتبطة بهذا الطلب

orderUpdate.order.vertical
(deprecated)

object

مهملة: يمكنك استخدام مواضع الإعلانات بدلاً من ذلك. وسيتم تطبيق هذه السمات على جميع العناصر، ما لم يتم إلغاؤها في بعض العناصر. يجب أن يتطابق هذا المجال مع نوع موضع الإعلان على مستوى العنصر. القيم المتاحة: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي "@type" على معرّف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }

orderUpdate.updateMask

string (FieldMask format)

ملاحظة: هناك توصيات/توصيات في ما يلي للحقول الخاصة التالية: 1. سيتم دائمًا تعديل order.last_update_time كجزء من طلب التعديل. 2- سيتم تجاهل order.create_time وorder.google_order_id وorder.merchant_order_id إذا تم توفيرهما كجزء من قناع التحديث.

قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"

orderUpdate.userNotification

object (UserNotification)

في حال تحديد هذه السمة، يتم عرض إشعار للمستخدم بالعنوان والنص المحدَّدين. تحديد إشعار هو اقتراح للإشعار ولا يمكن ضمان أن ينتج عنه إشعار.

orderUpdate.reason

string

سبب التغيير/التحديث.

حقل الاتحاد verticals وسيتم تطبيق هذه السمات على جميع العناصر، ما لم يتم إلغاؤها في بعض العناصر. يجب أن يتطابق هذا المجال مع نوع موضع الإعلان على مستوى العنصر. يمكن أن تكون السمة "verticals" واحدة فقط مما يلي:
orderUpdate.order.purchase

object (PurchaseOrderExtension)

طلب الشراء

orderUpdate.order.ticket

object (TicketOrderExtension)

طلب التذكرة

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Order.

OrderUpdate

تعديل الطلب

تمثيل JSON
{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}
الحقول
type
(deprecated)

enum (Type)

مهملة: يمكنك استخدام OrderUpdate.update_mask بدلاً من ذلك. إذا كان النوع = SNAPSHOT، يجب أن يكون OrderUpdate.order الطلب بالكامل. إذا كان النوع = ORDER_STATUS، فهذا هو التغيير في حالة مستوى الطلب. لا يتم اختيار سوى order.last_update_time وكذلك هذه الحالة الرأسية. ملاحظة: لا يتوافق type.ORDER_STATUS إلا مع تحديثات حالة PurcahaseOrderExtension، وليست هناك خطة لتمديد هذا الدعم. بدلاً من ذلك، ننصح باستخدام updateMask لأنه أكثر عمومية وقابلاً للتوسع ويمكن استخدامه لجميع المجالات.

order

object (Order)

updateMask

string (FieldMask format)

ملاحظة: هناك توصيات/توصيات في ما يلي للحقول الخاصة التالية: 1. سيتم دائمًا تعديل order.last_update_time كجزء من طلب التعديل. 2- سيتم تجاهل order.create_time وorder.google_order_id وorder.merchant_order_id إذا تم توفيرهما كجزء من قناع التحديث.

قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"

userNotification

object (UserNotification)

في حال تحديد هذه السمة، يتم عرض إشعار للمستخدم بالعنوان والنص المحدَّدين. تحديد إشعار هو اقتراح للإشعار ولا يمكن ضمان أن ينتج عنه إشعار.

reason

string

سبب التغيير/التحديث.

Type

مهملة: يمكنك استخدام OrderUpdate.update_mask بدلاً من ذلك. تم السماح بالتحديثات لأحد الطلبات.

عمليات التعداد
TYPE_UNSPECIFIED النوع غير محدّد، ويجب عدم ضبط هذه السمة بشكلٍ صريح.
ORDER_STATUS عدِّل حالة الطلب فقط.
SNAPSHOT تعديل نبذة عن الطلب

UserNotification

إشعار اختياري للمستخدم لعرضه كجزء من تعديل الطلب

تمثيل JSON
{
  "title": string,
  "text": string
}
الحقول
title

string

عنوان إشعار المستخدِم. الحد الأقصى المسموح به للطول هو 30 حرفًا.

text

string

محتويات الإشعار. الحد الأقصى المسموح به للطول هو 100 حرف.