Method: advertisers.lineItems.generateDefault

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

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

طلب HTTP

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

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

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

المعلمات
advertiserId

string (int64 format)

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

نص الطلب

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

تمثيل JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
الحقول
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.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

تُستخدَم لتحديد ما إذا كان عنصر الحملة هذا سيعرض إعلانات سياسية عن الاتحاد الأوروبي.

إذا تم ضبط containsEuPoliticalAds على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING في حساب المعلِن الرئيسي، سيتم تعيين قيمة DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING لهذا الحقل ما لم يتم تحديد قيمة أخرى. يمكن بعد ذلك تعديل هذا الحقل باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات أو ملفات البيانات المنظَّمة.

يجب تعيين هذا الحقل عند إنشاء عنصر سطر جديد. وفي ما عدا ذلك، سيتعذّر تنفيذ طلب advertisers.lineItems.create.

نص الاستجابة

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

نطاقات التفويض

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

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

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