یک آیتم خط جدید با تنظیمات (از جمله هدفگیری) به ارث رسیده از ترتیب درج و یک ENTITY_STATUS_DRAFT
entityStatus
ایجاد میکند. در صورت موفقیت، آیتم خط جدید ایجاد شده را برمی گرداند. مقادیر پیش فرض بر اساس سه فیلد وجود دارد:
-
insertionOrderType
دستور درج -
automationType
سفارش درج -
lineItemType
داده شده
موارد خط YouTube & Partners را نمی توان با استفاده از API ایجاد یا به روز کرد.
درخواست HTTP
POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:generateDefault
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
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 مراجعه کنید.