Method: advertisers.lineItems.generateDefault

تُنشئ هذه السمة عنصرًا جديدًا في الصفحة يتضمّن إعدادات (بما في ذلك الاستهداف) مُكتسَبة من طلب الإدراج وENTITY_STATUS_DRAFT entityStatus. تعرِض هذه الدالة العنصر الذي تم إنشاؤه حديثًا في حال نجاح العملية. هناك قيم تلقائية استنادًا إلى الحقول الثلاثة التالية:

لا يمكن إنشاء عناصر YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات.

طلب HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:generateDefault

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
advertiserId

string (int64 format)

مطلوب. معرّف المعلِن الذي ينتمي إليه هذا العنصر

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
الحقول
insertionOrderId

string (int64 format)

مطلوب. المعرّف الفريد لطلب الإدراج الذي ينتمي إليه العنصر
displayName

string

مطلوب. الاسم المعروض للعنصر.

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

enum (LineItemType)

مطلوب. نوع عنصر العرض
mobileApp

object (MobileApp)

تطبيق الأجهزة الجوّالة الذي يتم الترويج له من خلال العنصر

لا ينطبق ذلك إلا عندما يكون lineItemType هو LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL أو LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال LineItem.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/display-video

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.