Method: advertisers.lineItems.generateDefault

یک آیتم سطری جدید با تنظیماتی (از جمله هدف‌گیری) که از ترتیب درج و یک entityStatus از نوع ENTITY_STATUS_DRAFT به ارث برده شده است، ایجاد می‌کند. در صورت موفقیت، آیتم سطری تازه ایجاد شده را برمی‌گرداند. مقادیر پیش‌فرض بر اساس سه فیلد وجود دارد:

موارد مربوط به یوتیوب و شرکا را نمی‌توان با استفاده از API ایجاد یا به‌روزرسانی کرد.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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 و حداکثر اندازه ۲۴۰ بایت کدگذاری شود.

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 اختصاص داده می‌شود. سپس می‌توان این فیلد را با استفاده از رابط کاربری، API یا فایل‌های داده‌ی ساختاریافته به‌روزرسانی کرد.

این فیلد باید هنگام ایجاد یک ردیف جدید اختصاص داده شود. در غیر این صورت، درخواست advertisers.lineItems.create با شکست مواجه خواهد شد .

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از LineItem است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .