REST Resource: videoAdvertisingOptions

منبع: VideoAdvertisingOption

تنظیمات تبلیغات برای یک ویدیو تنظیمات انواع تبلیغاتی را که می‌توانند در طول ویدیو اجرا شوند و همچنین زمان‌هایی که تبلیغات مجاز به نمایش در طول ویدیو هستند را مشخص می‌کند.

نمایندگی JSON
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
زمینه های
kind

string

نوع منبع API. برای این منبع، مقدار youtubePartner#videoAdvertisingOption است.

adFormats[]

string

فهرستی از قالب‌های تبلیغاتی که ویدیو مجاز به نمایش آن‌ها است. توجه: از نوامبر 2023، فقط third_party_ads را می توان در این ستون فعال/غیرفعال کرد. برای اطلاعات بیشتر به مقاله پشتیبانی مراجعه کنید. کنترل‌های قالب آگهی زیر دیگر در دسترس نیستند و نباید در درخواست API گنجانده شوند: instream_standard ، display ، preroll ، postroll .

breakPosition[]

string

نقطه ای که در آن وقفه در حین پخش ویدیو رخ می دهد.

adBreaks[]

object ( AdBreak )

فهرستی از زمان‌هایی که YouTube می‌تواند یک تبلیغ درون جریانی را در حین پخش ویدیو نشان دهد.

autoGeneratedBreaks

boolean

این ویدیو را برای وقفه‌های میان‌پرده تولید شده به‌طور خودکار فعال می‌کند.

id

string

شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیوی مرتبط با تنظیمات تبلیغات استفاده می کند.

tpAdServerVideoId

string

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

tpTargetingUrl

string

نشانی وب پایه یک سرور تبلیغات شخص ثالث که YouTube می‌تواند تبلیغات درون جریانی ویدیو را از آن بازیابی کند.

tpUrlParameters

string

یک رشته پارامتر برای افزودن به انتهای درخواست به سرور آگهی شخص ثالث.

AdBreak

یک منبع adBreak حاوی اطلاعاتی درباره زمانی است که YouTube می‌تواند یک تبلیغ درون جریانی را در حین پخش ویدیو نشان دهد.

نمایندگی JSON
{
  "position": string,
  "midrollSeconds": integer
}
زمینه های
position

string

نقطه ای که در آن وقفه در حین پخش ویدیو رخ می دهد.

midrollSeconds

integer

زمان وقفه آگهی به‌عنوان تعداد ثانیه‌های پس از شروع ویدیو که وقفه رخ می‌دهد مشخص شده است.

مواد و روش ها

get

 تنظیمات تبلیغاتی را برای ویدیوی مشخص شده بازیابی می کند.

getEnabledAds

 جزئیات مربوط به انواع تبلیغات مجاز را برای یک ویدیوی بارگذاری شده توسط شریک یا کاربر مشخص شده بازیابی می کند.

patch

 تنظیمات تبلیغات را برای ویدیوی مشخص شده وصله می کند.

update

 تنظیمات تبلیغات را برای ویدیوی مشخص شده به روز می کند.