ينشئ عنصرًا جديدًا باستخدام الإعدادات (بما في ذلك الاستهداف) المكتسبة من طلب الإدراج وENTITY_STATUS_DRAFT
entityStatus
. تعرض البند الذي تم إنشاؤه حديثًا إذا نجح. هناك قيم تلقائية تستند إلى الحقول الثلاثة:
- السمة
insertionOrderType
لطلب الإدراج - السمة
automationType
لطلب الإدراج - السمة
lineItemType
المحدّدة
لا يمكن إنشاء عناصر YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات.
طلب HTTP
POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:generateDefault
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
advertiserId |
مطلوبة. رقم تعريف المعلن الذي ينتمي إليه هذا العنصر. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "insertionOrderId": string, "displayName": string, "lineItemType": enum ( |
الحقول | |
---|---|
insertionOrderId |
مطلوبة. المعرّف الفريد لطلب الإدراج الذي ينتمي إليه العنصر. |
displayName |
مطلوبة. الاسم المعروض للعنصر. يجب ترميزها باستخدام UTF-8 بحجم 240 بايت كحد أقصى. |
lineItemType |
مطلوبة. تمثّل هذه السمة نوع العنصر. |
mobileApp |
تطبيق الأجهزة الجوّالة الذي تم الترويج له من خلال العنصر. ولا ينطبق ذلك إلا إذا كانت قيمة |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال LineItem
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.