Method: advertisers.lineItems.generateDefault

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

موارد خط YouTube & Partners را نمی توان با استفاده از API ایجاد یا به روز کرد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

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

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

بدن پاسخگو

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

محدوده مجوز

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

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

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