Method: advertisers.lineItems.generateDefault

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

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.