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)
  },
  "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.