LiveCuepoints

המשאב 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
הסוג של נקודת המבט. המדריך תחילת העבודה כולל הסבר על הסוגים השונים של הנקודות. אפשר גם לעיין במסמך אורך החיים של השידור כדי לעיין בשיטות המומלצות להוספת סימני מים במהלך השידור.

הערכים החוקיים לנכס הזה הם:
  • ad
settings.durationSecs unsigned integer
משך הזמן בשניות. יש לציין ערך זה אם הערך של cueType הוא ad. אחרת, המערכת תתעלם ממנו.