Method: orders.patch

تعديل الطلب من 3p إلى AOG تعرض ضياء زيت "مُلحَقة" إذا كان معرّف الطلب فارغًا أو لا يساوي طلبًا موجودًا.

طلب HTTP

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

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

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

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

string

مطلوب: مُعرّف الطلب الداخلي الذي عيّنه التاجر. ويجب أن يكون هذا المعرّف فريدًا ومطلوبًا للعمليات اللاحقة الخاصة بتعديل الطلب. قد يتم ضبط هذا المعرّف على googleOrderId المقدَّم أو أي قيمة فريدة أخرى. يُرجى العِلم أنّ المعرّف المقدَّم للمستخدمين هو userVisualOrderId، والذي قد يكون قيمة مختلفة وأكثر سهولة في الاستخدام. الحد الأقصى المسموح به للطول هو 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 إلا مع تحديثات حالة PercahaseOrderExtension، ولا توجد خطة لتوسيع هذا الدعم. بدلاً من ذلك، ننصح باستخدام updateMask لأنّه أكثر عمومية وقابلية للتوسع ويمكن استخدامه لجميع المجالات.

orderUpdate.order.googleOrderId

string

مُعرّف الطلب الذي قدمته Google.

orderUpdate.order.userVisibleOrderId

string

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

orderUpdate.order.userVisibleStateLabel
(deprecated)

string

متوقّفة نهائيًا: استخدِم حالة إضافات الطلب بدلاً منها. تصنيف مرئي للمستخدم للحالة التي تم فيها تقديم هذا الطلب

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 في حال توفيرها كجزء من updateMask.

قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "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 إلا مع تحديثات حالة PercahaseOrderExtension، ولا توجد خطة لتوسيع هذا الدعم. بدلاً من ذلك، ننصح باستخدام 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 في حال توفيرها كجزء من updateMask.

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

object (UserNotification)

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

reason

string

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

النوع

متوقّفة نهائيًا: يُرجى استخدام OrderUpdate.update_mask بدلاً من ذلك. تم السماح بالتعديلات على الطلب.

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

UserNotification

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

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

string

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

text

string

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