Method: exchanges.orders.patch

يعدِّل طلبًا.

طلب HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

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

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

المعلمات
order.name

string

اسم المورد النسبي للطلب. يتم إنشاؤه من قِبل الخادم. مثال: "exchanges/1234/orders/5678" النتائج فقط.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
الحقول
order.displayName

string

اسم الطلب المعروض للمشتري. 250 حرفًا كحد أقصى. اختياريّ.
order.partnerId[]

string (int64 format)

رقم تعريف الشريك في "مساحة العرض والفيديو 360" من Google، المعروفة سابقًا باسم Doubleclick Bid Manager‏(DBM). لا يُسمح إلا برقم تعريف شريك واحد. الحقل مطلوب.
order.publisherEmail

string

البريد الإلكتروني للناشر. يجب أن يكون بتنسيق بريد إلكتروني صالح. 250 حرفًا كحد أقصى. اختياريّ.
order.publisherName

string

اسم الناشر. 250 حرفًا كحد أقصى. الحقل مطلوب.
order.budget

object (Budget)

النتائج فقط. الميزانية التي يحدّدها المشتري. لا ينطبق هذا الحقل إلا على سيناريوهات "الصفقة الفورية".
order.status

enum (OrderStatus)

حالة الطلب. يمكن أن تتغيّر الحالة بعد أن يقبل مستخدمو "مساحة العرض والفيديو 360" طلبًا أو يلغونه أو يؤرشفونه. يمكن أيضًا تعديل الحالة إلى "تم الإلغاء" بعد إنشاء الطلب في واجهة برمجة التطبيقات للإشارة إلى أنّه تم إلغاء هذا الطلب على منصة التبادل.
order.wseatConfig

object (WSeatConfig)

اختياريّ. تحدّد إعدادات WSeat إعدادات WSeat على جانب منصة التبادل. من المتوقّع أن تحتفظ منصات التبادل التي تستخدم صفقات متعددة المقاعد بهذا الحقل مملوءًا ومحدّثًا.
order.updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني الذي تم فيه تعديل الطلب أو المنتجات الأساسية.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
order.buyerInfo

object (BuyerInfo)

النتائج فقط. معلومات المشتري، بما في ذلك تفاصيل الشريك والمعلِن. لا ينطبق هذا الحقل إلا على سيناريوهات "الصفقة الفورية".
updateMask

string (FieldMask format)

القناع الذي يتحكّم في الحقول التي سيتم تعديلها. الحقل مطلوب.

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

نص الاستجابة

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/doubleclickbidmanager

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.