המשאב liveCuepoint
והשיטה liveCuepoints.insert
הוצאו משימוש והוחלפו בשיטת liveBroadcasts.cuepoint
.
משאב אחד (liveCuepoint
) מוסיף לזרם הקריאה של הסרטון שידור מה שעלול להפעיל הפסקה למודעה.
הערה: פקודת ה-API הזו היא למעשה חלק מ-YouTube Content ID API, עם דרישות סף שונות מבקשות לניהול משאבים ב-liveBroadcast
וב-liveStream
.
שיטות
ה-API תומך בשיטות הבאות עבור משאבי liveCuepoints
:
- הוספה
- הוספת נקודת מבט לשידור חי. נכון לעכשיו, בקשות המשויכות לשיטה הזו חייבות לקבל אישור מחשבון שמשויך לבעלי תוכן ב-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 ).ממשק ה-API מחזיר שגיאה אם הבקשה מנסה להוסיף סימן וי שמציין ערך עבור הנכס הזה ועבור הנכס settings.offsetTimeMs . |
settings.cueType |
string הסוג של נקודת המבט. המדריך תחילת העבודה כולל הסבר על הסוגים השונים של הנקודות. אפשר גם לעיין במסמך אורך החיים של השידור כדי לעיין בשיטות המומלצות להוספת סימני מים במהלך השידור. הערכים החוקיים לנכס הזה הם:
|
settings.durationSecs |
unsigned integer משך הזמן בשניות. יש לציין ערך זה אם הערך של cueType הוא ad . אחרת, המערכת תתעלם ממנו. |