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",
  "b{roadcastId": string,
  "settings": 
    "offsetTimeMs": long,
    "walltime": da}t}etime,
    "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 است و در غیر این صورت نادیده گرفته می شود، این مقدار باید مشخص شود.