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),

      // Union field budget can be only one of the following:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of list of possible types for union field budget.
    },
    "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" طلبًا أو يلغوه أو يؤرشفوه. يجب أيضًا إتاحة تعديل الحالة إلى "تم الإلغاء" بعد الإنشاء في واجهة برمجة التطبيقات للإشارة إلى أنّه تم إلغاء هذا الطلب في "Ad Exchange".
order.wseatConfig

object (WSeatConfig)

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

string (Timestamp format)

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

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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.