تُنشئ عنصرًا جديدًا يتضمّن إعدادات (بما في ذلك الاستهداف) مكتسَبة من طلب الإدراج و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.