این روش منسوخ شده و با روش liveBroadcasts.cuepoint جایگزین شده است.
یک نقطه نشانه را در یک پخش زنده درج می کند. در حال حاضر، درخواست‌های این روش باید توسط حساب مرتبط با مالک محتوای YouTube مجاز باشد.
درخواست
درخواست HTTP
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
| محدوده |
|---|
https://www.googleapis.com/auth/youtubepartner |
مولفه های
جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.
| مولفه های | ||
|---|---|---|
| پارامترهای مورد نیاز | ||
channelId | stringپارامتر channelId کانالی را که صاحب پخشی است که نقطه نشانه در آن درج می شود، مشخص می کند. | |
onBehalfOfContentOwner | stringپارامتر onBehalfOfContentOwner مالک محتوا را مشخص می کند که کاربر از طرف او اقدام می کند. | |
درخواست بدن
یک منبع liveCuepoint در بدنه درخواست ارائه دهید. برای آن منبع:
شما باید یک مقدار برای این ویژگی ها مشخص کنید:
-
broadcastId -
settings.cueType
-
شما می توانید مقادیری را برای این ویژگی ها تنظیم کنید:
-
settings.offsetTimeMs -
settings.walltime -
settings.durationSecs
-
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع liveCuepoint را در بدنه پاسخ برمی گرداند.
خطاها
جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
invalidValue (400) | conflictingTimeFields | فقط یکی از offsetTimeMs و walltime ممکن است مشخص شود. |