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.