LiveCuepoints: insert

השיטה הזו הוצאה משימוש והוחלפה בשיטה 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.