REST Resource: guaranteedOrders

المرجع: GuaranteedOrder

طلب مضمون

الطلبات المضمونة هي عنصر رئيسي لمصادر المستودع الإعلاني المضمون. عند إنشاء مصدر مستودع مضمون، يجب تخصيص مُعرّف طلب مضمون لمصدر المستودع.

تمثيل JSON 
{
  "name": string,
  "legacyGuaranteedOrderId": string,
  "exchange": enum (Exchange),
  "guaranteedOrderId": string,
  "displayName": string,
  "status": {
    object (GuaranteedOrderStatus)
  },
  "updateTime": string,
  "publisherName": string,
  "readAccessInherited": boolean,
  "readAdvertiserIds": [
    string
  ],
  "defaultAdvertiserId": string,
  "defaultCampaignId": string,

  // Union field read_write_accessor can be only one of the following:
  "readWritePartnerId": string,
  "readWriteAdvertiserId": string
  // End of list of possible types for union field read_write_accessor.
}
الحقول
name

string

النتائج فقط. اسم المورد للطلب المضمون.
legacyGuaranteedOrderId

string

النتائج فقط. المعرّف القديم للطلب المضمون. تم تعيينه من قِبل التبادل الأصلي. يكون المعرّف القديم فريدًا في عملية تبادل واحدة، ولكن لا يمكن ضمان أن يكون فريدًا في جميع الطلبات المضمونة. يُستخدَم هذا المعرّف في SDF وواجهة المستخدم.
exchange

enum (Exchange)

مطلوب. غير قابل للتغيير الصرف الذي نشأ منه الطلب المضمون
guaranteedOrderId

string

النتائج فقط. المعرّف الفريد للطلب المضمون يكون تنسيق معرّفات الطلبات المضمونة على النحو التالي: {exchange}-{legacyGuaranteedOrderId}.
displayName

string

مطلوب. تمثّل هذه السمة الاسم المعروض للطلب المضمون.

يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت.
status

object (GuaranteedOrderStatus)

تمثّل هذه السمة إعدادات حالة الطلب المضمون.
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل على الطلب المضمون تمّ تعيينه من قِبل النظام.

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

string

مطلوب. تمثّل هذه السمة اسم ناشر الطلب المضمون.

يجب أن يكون بترميز UTF-8 بحد أقصى 240 بايت.
readAccessInherited

boolean

ما إذا كان لدى جميع المعلِنين في readWritePartnerId إذن بالاطّلاع على الطلب المضمون لا ينطبق ذلك إلا في حال ضبط readWritePartnerId. في حال ضبط السياسة على "صحيح"، يتم إلغاء readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

أرقام تعريف المعلِنين الذين لديهم إذن بالقراءة للطلب المضمون

يجب ألا يتضمّن هذا الحقل المعلِن الذي تمّ تعيينه إلى readWriteAdvertiserId في حال ضبطه. يجب أن يكون جميع المعلِنين في هذا الحقل تابعين readWritePartnerId أو الشريك نفسه الذي يتبعه readWriteAdvertiserId.
defaultAdvertiserId

string (int64 format)

النتائج فقط. رقم تعريف المعلِن التلقائي للطلب المضمون.

المعلِن التلقائي هو "readWriteAdvertiserId" أو المعلِن الأوّل المُدرَج في "readAdvertiserIds" في حال عدم ضبط ذلك. أمّا في حال عدم تحديد المعلِن، فلن يكون هناك معلِن تلقائي.
defaultCampaignId

string (int64 format)

رقم تعريف الحملة التلقائية التي تمّ تعيينها للطلب المضمون.

يجب أن تنتمي الحملة التلقائية إلى المعلن التلقائي.

حقل الربط read_write_accessor مطلوب.

الشريك أو المعلِن الذي لديه إذن بالقراءة/الكتابة في الطلب المضمون يمكن أن يكون read_write_accessor واحدًا فقط مما يلي:
readWritePartnerId

string (int64 format)

الشريك الذي لديه إذن بالقراءة أو الكتابة للطلب المضمون
readWriteAdvertiserId

string (int64 format)

المعلِن الذي لديه إذن بالقراءة/الكتابة في الطلب المضمون وهذا هو أيضًا المعلِن التلقائي للطلب المضمون.

GuaranteedOrderStatus

تمثّل هذه السمة إعدادات حالة الطلب المضمون.

تمثيل JSON 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "configStatus": enum (GuaranteedOrderConfigStatus)
}
الحقول
entityStatus

enum (EntityStatus)

ما إذا كان بالإمكان عرض الطلب المضمون أم لا

القيم المقبولة هي ENTITY_STATUS_ACTIVE وENTITY_STATUS_ARCHIVED وENTITY_STATUS_PAUSED. القيمة التلقائية هي ENTITY_STATUS_ACTIVE.
entityPauseReason

string

السبب الذي قدّمه المستخدم لإيقاف هذا الطلب المضمون مؤقتًا.

يجب أن تكون مرمّزة بترميز UTF-8 وبحد أقصى 100 بايت.

لا يسري هذا الإجراء إلّا عند ضبط السمة entityStatus على ENTITY_STATUS_PAUSED.
configStatus

enum (GuaranteedOrderConfigStatus)

النتائج فقط. حالة الضبط للطلب المضمون.

القيم المقبولة هي PENDING وCOMPLETED.

يجب ضبط طلب مضمون (ملء الحقول المطلوبة واختيار تصميمات الإعلانات واختيار حملة تلقائية) قبل أن يتمكّن من العرض. لا يمكن حاليًا تنفيذ إجراء الضبط إلا من خلال واجهة المستخدم.

GuaranteedOrderConfigStatus

حالات الضبط المحتملة لطلب مضمون.

عمليات التعداد
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED لم يتم تحديد حالة الموافقة أو هي غير معروفة في هذا الإصدار.
PENDING الحالة الأولى لطلب مضمون. يجب ضبط الترتيب المضمون في هذه الحالة قبل أن يتمكّن من العرض.
COMPLETED الحالة بعد إعداد المشتري لطلب مضمون.

الطُرق

create

 لإنشاء طلب مضمون جديد.

editGuaranteedOrderReadAccessors

 تُقرأ التعديلات للمعلِنين عن طلب مضمون.

get

 الحصول على طلب مضمون

list

 يسرد الطلبات المضمونة التي يمكن للمستخدم الحالي الوصول إليها.

patch

 تعديل طلب مضمون حالي