تُنشئ عنصرًا جديدًا يتضمّن إعدادات (بما في ذلك الاستهداف) مكتسَبة من طلب الإدراج وentityStatus
ENTITY_STATUS_DRAFT
. تعرض العنصر الذي تم إنشاؤه حديثًا في حال نجاحه. هناك قيم تلقائية تستند إلى الحقول الثلاثة:
insertionOrderType
لطلب الإدراجautomationType
لطلب الإدراجlineItemType
المحدّد
طلب HTTP
POST https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/lineItems:generateDefault
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
advertiserId |
مطلوب. رقم تعريف المعلِن الذي ينتمي إليه هذا العنصر |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "insertionOrderId": string, "displayName": string, "lineItemType": enum ( |
الحقول | |
---|---|
insertionOrderId |
مطلوب. المعرّف الفريد لطلب الإدراج الذي ينتمي إليه العنصر |
displayName |
مطلوب. الاسم المعروض للعنصر. يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت. |
lineItemType |
مطلوب. نوع العنصر |
mobileApp |
تطبيق الأجهزة الجوّالة الذي يروّج له العنصر. يسري ذلك فقط عندما تكون قيمة |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال LineItem
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.