المرجع: الضمان المضمون
طلب مضمون.
الطلبات المضمونة هي كيان رئيسي لمصادر المستودع المضمون. عند إنشاء مصدر مستودع مضمون، يجب تخصيص مُعرّف طلب مضمون لمصدر المستودع.
تمثيل JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد للطلب المضمون. |
legacyGuaranteedOrderId |
النتائج فقط. المعرّف القديم للطلب المضمون تم تعيينه من قِبل عملية الاستبدال الأصلية. يكون رقم التعريف القديم فريدًا في عملية تبادل واحدة، ولكن لا يمكن ضمان أن يكون فريدًا في جميع الطلبات المضمونة. يُستخدَم رقم التعريف هذا في SDF وواجهة المستخدم. |
exchange |
مطلوبة. غير قابل للتغيير. تمثّل هذه السمة أسعار التبادل التي نشأ فيها الطلب المضمون. |
guaranteedOrderId |
النتائج فقط. المعرّف الفريد للطلب المضمون تكون مُعرّفات الطلبات المضمونة بالتنسيق |
displayName |
مطلوبة. الاسم المعروض للطلب المضمون يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 240 بايت. |
status |
تمثّل هذه السمة إعدادات حالة الطلب المضمون. |
updateTime |
النتائج فقط. الطابع الزمني لآخر مرة تم فيها تعديل الطلب المضمون. تم تعيينه من قِبل النظام. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
publisherName |
مطلوبة. اسم الناشر للطلب المضمون. يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 240 بايت. |
readAccessInherited |
ما إذا كان لدى جميع المعلِنين في " |
readAdvertiserIds[] |
أرقام تعريف المعلِنين الذين لديهم إذن وصول للقراءة إلى الطلب المضمون يجب ألا يتضمّن هذا الحقل المعلِن الذي تم إسناده إلى |
defaultAdvertiserId |
النتائج فقط. رقم تعريف المعلِن التلقائي للطلب المضمون. المعلِن التلقائي هو |
defaultCampaignId |
رقم تعريف الحملة التلقائية التي يتم تخصيصها للطلب المضمون. يجب أن تنتمي الحملة الافتراضية إلى المعلن الافتراضي. |
حقل الاتحاد الشريك أو المعلِن الذي يملك إذن الوصول للقراءة/الكتابة إلى الطلب المضمون يمكن أن تكون السمة " |
|
readWritePartnerId |
الشريك الذي يملك إذن الوصول للقراءة/الكتابة إلى الطلب المضمون |
readWriteAdvertiserId |
المعلِن الذي لديه إذن وصول للقراءة/الكتابة إلى الطلب المضمون وهو أيضًا المعلِن التلقائي للطلب المضمون. |
GuaranteedOrderStatus
تمثّل هذه السمة إعدادات حالة الطلب المضمون.
تمثيل JSON |
---|
{ "entityStatus": enum ( |
الحقول | |
---|---|
entityStatus |
ما إذا كان الطلب المضمون قابلاً للعرض أم لا. القيم المقبولة هي |
entityPauseReason |
السبب الذي قدمه المستخدم لإيقاف هذا الطلب المضمون مؤقتًا. يجب ترميزها باستخدام UTF-8 بحد أقصى للطول يبلغ 100 بايت. ينطبق ذلك فقط عند ضبط |
configStatus |
النتائج فقط. حالة إعدادات الطلب المضمون القيمتان المقبولتان هما يجب ضبط طلب مضمون (ملء الحقول المطلوبة واختيار تصميمات الإعلانات واختيار حملة تلقائية) قبل أن يتمكّن من عرض الإعلانات. في الوقت الحالي، لا يمكن تنفيذ إجراء الضبط إلا من خلال واجهة المستخدم. |
GuaranteedOrderConfigStatus
حالات الضبط المحتملة لطلب مضمون
عمليات التعداد | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
حالة الموافقة غير محدّدة أو غير معروفة في هذا الإصدار. |
PENDING |
حالة بداية الطلب المضمون. يجب ضبط الترتيب المضمون في هذه الحالة قبل عرض الإعلانات. |
COMPLETED |
الحالة التي تلي إعداد المشتري لطلب مضمون |
الطُرق |
|
---|---|
|
ينشئ طلبًا جديدًا مضمونًا. |
|
تقرأ التعديلات المعلِنين الذين يقدّمون طلبات مضمونة. |
|
الحصول على طلب مضمون |
|
يسرد الطلبات المضمونة التي يمكن للمستخدم الحالي الوصول إليها. |
|
تعديل طلب حالي مضمون |