LiveCuepoints

منبع liveCuepoint و روش liveCuepoints.insert منسوخ شده و با روش liveBroadcasts.cuepoint جایگزین شده است.

یک منبع liveCuepoint یک نقطه نشانه را در جریان ویدیوی پخش درج می کند، که ممکن است باعث وقفه تبلیغاتی شود.

توجه: این دستور API در واقع بخشی از YouTube Content ID API است و دارای الزامات مجوز متفاوتی نسبت به درخواست‌های مدیریت liveBroadcast و منابع liveStream است.

مواد و روش ها

API از روش های زیر برای منابع liveCuepoints پشتیبانی می کند:

insert
یک نقطه نشانه را در یک پخش زنده درج می کند. در حال حاضر، درخواست‌های این روش باید توسط حساب مرتبط با مالک محتوای YouTube مجاز باشد. اکنون آن را امتحان کنید .

نمایندگی منابع

ساختار JSON زیر فرمت یک منبع liveCuepoints را نشان می دهد:

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

خواص

جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:

خواص
id string
مقداری که YouTube برای شناسایی منحصربه‌فرد نقطه نشانه اختصاص می‌دهد.
kind string
نوع منبع API. برای منابع liveCuepoint ، مقدار youtubePartner#liveCuepoint است.
broadcastId string
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد پخشی که نقطه نشانه در آن درج شده است اختصاص می‌دهد.
settings object
شی settings ، تنظیمات نقطه نشانه را تعریف می کند.
settings. offsetTimeMs long
این مقدار زمانی را در ویدیو مشخص می‌کند که بینندگان باید یک آگهی یا فهرست درون جریانی را ببینند. مقدار مشخصه، یک فاصله زمانی را، بر حسب میلی ثانیه، از ابتدای جریان مانیتور مشخص می کند. اگرچه در میلی ثانیه اندازه گیری می شود، اما در واقع یک تقریبی است و YouTube نقطه نشانه را تا حد امکان به آن زمان نزدیک می کند. اگر پخش شما جریان مانیتور ندارد، نباید مقداری برای این پارامتر تعیین کنید.

مقدار پیش‌فرض این ویژگی 0 است که نشان می‌دهد نقطه نشانه باید در اسرع وقت درج شود. اگر پخش جریانی شما تاخیر نداشته باشد، 0 نیز تنها مقدار معتبر است. با این حال، اگر پخش جریانی شما تأخیر داشته باشد، مقدار ویژگی می تواند زمانی را مشخص کند که نقطه نشانه باید درج شود. برای جزئیات بیشتر به راهنمای شروع کار مراجعه کنید.

توجه: اگر پخش شما مرحله آزمایشی داشت، افست از زمانی که مرحله آزمایش شروع شد اندازه گیری می شود.
settings. walltime datetime
این مقدار زمان ساعت دیواری را مشخص می کند که در آن نقطه نشانه باید درج شود. مقدار در قالب ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ) مشخص شده است.

اگر درخواستی بخواهد نقطه ای را وارد کند که مقداری برای این ویژگی و ویژگی settings.offsetTimeMs مشخص می کند، API یک خطا برمی گرداند.
settings. cueType string
نوع نقطه نشانه. برای توضیح انواع مختلف نقاط نشانه به راهنمای شروع کار مراجعه کنید. همچنین برای بهترین روش‌ها در مورد درج نقطه‌های نشانه در طول پخش، به زندگی یک سند پخش مراجعه کنید.

مقادیر معتبر برای این ویژگی عبارتند از:
  • ad
settings. durationSecs unsigned integer
مدت زمان نقطه نشانه، بر حسب ثانیه. اگر cueType ad است و در غیر این صورت نادیده گرفته می شود، این مقدار باید مشخص شود.