REST Resource: exchanges.orders

المورد: الطلب

عرض غير قابل للتفاوض على المشتري قبوله.

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
الحقول
name

string

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

string

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

string (int64 format)

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

string

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

string

تمثّل هذه السمة اسم الناشر. يمكن استخدام 250 حرفًا كحدّ أقصى. مطلوب.
budget

object (Budget)

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

enum (OrderStatus)

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

object (WSeatConfig)

اختياريّ. يحدّد WSeat Configuration إعدادات WSeat على جهة التبادل. من المتوقّع أن تبقي البورصات التي تستخدم صفقات المقاعد المتعدّدة هذا الحقل مملوءًا ومحدّثًا.
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"
buyerInfo

object (BuyerInfo)

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

الميزانية

تم تحديد الميزانية.

تمثيل JSON 
{
  "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.
}
الحقول
budgetType

enum (BudgetType)

نوع الميزانية المحدّد
حقل الدمج budget يمكن تضمين نوع واحد فقط من الميزانية. يمكن أن تكون budget إحدى القيم التالية فقط:
impressions

string (int64 format)

ميزانية مرات الظهور
money

object (Money)

ميزانية العملة

BudgetType

أنواع الميزانيات

عمليات التعداد
BUDGET_TYPE_UNSPECIFIED ميزانية غير محدّدة غير صالح للإدخال.
BUDGET_TYPE_CURRENCY ميزانية العملة
BUDGET_TYPE_IMPRESSION ميزانية مرات الظهور

OrderStatus

حالة الطلب

عمليات التعداد
ORDER_STATUS_UNSPECIFIED لم يتم تحديد حالة الطلب. قيمة غير متوقّعة، تشير إلى أنّ حالة التفاوض غير معروفة. قيمة الإدخال غير صالحة.
PENDING_ACCEPTANCE حالة الطلب في انتظار الموافقة.
ACCEPTED حالة الطلب مقبولة.
ARCHIVED تم وضع حالة الطلب في الأرشيف.
CANCELLED تم إلغاء حالة الطلب.
NEGOTIATING حالة الطلب هي "التفاوض". لا ينطبق إلا على سيناريوهات "الصفقات الفورية".

WSeatConfig

إعدادات WSeat

تمثيل JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
الحقول
exchangeWseatStatus

enum (WSeatStatus)

اختياريّ. الحالة الحالية على جانب Exchange لإعداد WSeat
exchangeWseatIds[]

string (int64 format)

اختياريّ. أرقام تعريف WSeat على جهة التبادل
updateTime

string (Timestamp format)

النتائج فقط. يتم تعديل هذا الحقل تلقائيًا من خلال "مساحة العرض والفيديو 360" عند تعديل WSeatConfiguration من خلال شبكة التبادل.

يستخدم 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"

WSeatStatus

خيارات تعداد حالة WSeat

عمليات التعداد
W_SEAT_STATUS_UNSPECIFIED لم يتم تحديد WSeatStatus.
W_SEAT_STATUS_ENFORCED تم فرض WSeatStatus. تشير هذه السمة إلى أنّ Exchange يفرض استخدام WSeatId من خلال إرسالها إلى DV3 أو التحقّق من wseatids في ردود عروض الأسعار.
W_SEAT_STATUS_NOT_ENFORCED لم يتم فرض WSeatStatus. يشير إلى أنّ Exchange لا يرسل wseatid في طلبات عروض الأسعار ولا يتحقّق من صحة wseatid في طلبات عروض الأسعار.

BuyerInfo

معلومات المشتري لسيناريوهات "الصفقة الفورية"

تمثيل JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
الحقول
partner

object (PartnerInfo)

النتائج فقط. معلومات الشريك
advertisers[]

object (AdvertiserInfo)

النتائج فقط. معلومات المعلِن

PartnerInfo

معلومات الشريك لسيناريوهات "الصفقة الفورية"

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

string

النتائج فقط. عنوان العرض الخاص بالشريك في "مساحة العرض والفيديو 360"

AdvertiserInfo

معلومات المعلِن لسيناريوهات "الصفقة الفورية"

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

string (int64 format)

النتائج فقط. رقم تعريف المعلِن في "مساحة العرض والفيديو 360"
domainUri

string

النتائج فقط. معرّف الموارد المنتظم (URI) الخاص بنطاق الموقع الإلكتروني للمعلِن.

الطُرق

accept

 يقبل الطلب.

create

 تنشئ هذه الطريقة طلبًا.

get

 الحصول على الطلب

list

 ترتيب القوائم

patch

 تعديل طلب