إنشاء عنصر جديد مع إعدادات (بما في ذلك الاستهداف) المكتسبة من طلب الإدراج وENTITY_STATUS_DRAFT
entityStatus
. تعرض البند الذي تم إنشاؤه حديثًا إذا نجح ذلك. هناك قيم تلقائية تستند إلى الحقول الثلاثة:
insertionOrderType
لطلب الإدراجautomationType
لطلب الإدراج- السمة
lineItemType
المقدَّمة
طلب HTTP
POST https://displayvideo.googleapis.com/v1/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.