Method: advertisers.lineItems.generateDefault

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

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

درخواست HTTP

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

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

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

پارامترها
advertiser Id

string ( int64 format)

مورد نیاز. شناسه تبلیغ‌کننده‌ای که این مورد خطی به آن تعلق دارد.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
فیلدها
insertion Order Id

string ( int64 format)

مورد نیاز. شناسه منحصر به فرد سفارش درج که مورد خط به آن تعلق دارد.

display Name

string

مورد نیاز. نام نمایشی مورد خط.

باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود.

line Item Type

enum ( LineItemType )

مورد نیاز. نوع آیتم خط.

mobile App

object ( MobileApp )

برنامه تلفن همراه که توسط مورد خط تبلیغ می شود.

این فقط زمانی قابل اعمال است که نوع lineItemType LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL یا LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL باشد.

بدن پاسخگو

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.