LiveBroadcasts: insert

ה-API תומך עכשיו באפשרות לסמן את השידורים החיים בקטגוריה 'במיוחד לילדים', והמשאב liveBroadcast מכיל עכשיו מאפיין שמזהה את הסטטוס 'במיוחד לילדים' של השידור החי. התנאים וההגבלות של שירותי YouTube API והמדיניות למפתחים עודכנו גם הם ב-10 בינואר 2020. למידע נוסף, אפשר לעיין בהיסטוריית הגרסאות של שירות YouTube Live Streaming API ובתנאים ובהגבלות של שירותי YouTube API.

יצירת שידור.

תרחישים נפוצים לדוגמה

בקשה

בקשת HTTP

POST https://www.googleapis.com/youtube/v3/liveBroadcasts

אישור

בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.

פרמטרים
הפרמטרים הנדרשים
part string
הפרמטר part משרת שתי מטרות בפעולה זו. היא מזהה את המאפיינים שפעולת הכתיבה תגדיר, וכן את המאפיינים שייכללו בתגובת ה-API.

מאפייני part שאפשר לכלול בערך הפרמטר הם id, snippet, contentDetails ו-status.
פרמטרים אופציונליים
onBehalfOfContentOwner string
ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית תקינה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה של ההרשאה של הבקשה מזהים משתמש YouTube CMS שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube שהם הבעלים והמנהלים של ערוצי YouTube רבים ושונים. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד. חשבון ה-CMS שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube.
onBehalfOfContentOwnerChannel string
ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית תקינה. ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית כראוי. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

הפרמטר onBehalfOfContentOwnerChannel מציין את מזהה ערוץ YouTube של הערוץ שאליו מוסיפים את הסרטון. הפרמטר הזה נדרש כאשר בקשה מציינת ערך לפרמטר onBehalfOfContentOwner, ואפשר להשתמש בו רק בשילוב עם הפרמטר הזה. בנוסף, יש לאשר את הבקשה באמצעות חשבון CMS שמקושר לבעלי התוכן בפרמטר onBehalfOfContentOwner. לבסוף, הערוץ שצוין בערך הפרמטר onBehalfOfContentOwnerChannel חייב להיות מקושר לבעלי התוכן שהפרמטר onBehalfOfContentOwner מציין.

הפרמטר הזה מיועד לשותפי תוכן של YouTube, שבבעלותם ומנהלים רבים ערוצי YouTube שונים. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולבצע פעולות בשם הערוץ שצוין בערך הפרמטר, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ נפרד.

גוף הבקשה

צריך לספק משאב של שידור חי בגוף הבקשה. במשאב הזה:

  • צריך לציין ערך למאפיינים הבאים:

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

  • ניתן להגדיר ערכים למאפיינים הבאים:

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart

    הערה: טבלת המאפיינים מתעדת את כל ערכי ברירת המחדל שהוגדרו למאפיינים המפורטים למעלה. ערכי ברירת המחדל יוקצו באחד מהמקרים הבאים:
    • אין לציין ערכים למאפיינים האלה.
    • ערך הפרמטר part בבקשה שלך לא מציין את החלק שמכיל את המאפיינים האלה.

תשובה

אם הפעולה בוצעה בהצלחה, השיטה מחזירה משאב של שידור חי בגוף התגובה.

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שה-API עלול להחזיר בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במסמכים בנושא הודעת שגיאה.

סוג השגיאה פרטי השגיאה תיאור
insufficientPermissions insufficientLivePermissions הבקשה לא מורשית ליצור את השידור החי.
insufficientPermissions livePermissionBlocked המשתמש שאישר את הבקשה לא יכול כרגע להפעיל וידאו בשידור חי ב-YouTube. פרטים נוספים לגבי הסיבה לכך שהמשתמש לא יכול לבצע סטרימינג של וידאו בשידור חי עשויים להיות זמינים בהגדרות הערוץ של המשתמש בכתובת https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled המשתמש שאישר את הבקשה אינו יכול להפעיל סטרימינג של וידאו בשידור חי ב-YouTube. המשתמשים יכולים למצוא מידע נוסף בכתובת https://www.youtube.com/features.
invalidValue (400) invalidAutoStart המשאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין contentDetails.enableAutoStart. לא כל השידורים תומכים בהגדרה הזו.
invalidValue (400) invalidAutoStop המשאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין contentDetails.enableAutoStop. אי אפשר לשנות את ההגדרה של enableAutoStop בשידור קבוע.
invalidValue (400) invalidDescription המשאב livecastcast לא ציין ערך חוקי עבור המאפיין snippet.description. ערך המאפיין יכול להכיל עד 5,000 תווים.
invalidValue (400) invalidEmbedSetting משאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין contentDetails.enable_embed. לא ניתן להטמיע את השידור הזה.
invalidValue (400) invalidLatencyPreferenceOptions המשאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין contentDetails.latencyPreference. העדפה זו של זמן אחזור לא תומכת בכל ההגדרות.
invalidValue (400) invalidPrivacyStatus משאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין status.privacy_status.
invalidValue (400) invalidProjection משאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין contentDetails.projection. לא ניתן להגדיר ל-360 היטל ברירת מחדל.
invalidValue (400) invalidScheduledEndTime משאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין snippet.scheduledEndTime. שעת הסיום המתוזמנת חייבת להיות זהה לשעת ההתחלה שנקבעה.
invalidValue (400) invalidScheduledStartTime משאב LiveBroadcast הכיל ערך לא חוקי עבור המאפיין snippet.scheduledStartTime. שעת ההתחלה המתוכננת חייבת להיות עתידית וקרובה מספיק לתאריך הנוכחי כדי שניתן יהיה לתזמן שידור באופן אמין.
invalidValue (400) invalidTitle המשאב livecastcast לא ציין ערך חוקי עבור המאפיין snippet.title. ערך המאפיין חייב להיות באורך של 1 עד 100 תווים.
limitExceeded userBroadcastsExceedLimit המשתמש יצר יותר מדי שידורים חיים או מתוזמנים, והוא צריך להפסיק או למחוק חלק מהם.
rateLimitExceeded userRequestsExceedRateLimit המשתמש שלח יותר מדי בקשות בפרק זמן נתון.
required (400) privacyStatusRequired משאב השידור החי חייב לציין סטטוס פרטיות. הצגת ערכי privacyStatus תקינים.
required (400) scheduledEndTimeRequired המשאב LiveBroadcast חייב לציין את המאפיין snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired המשאב LiveBroadcast חייב לציין את המאפיין snippet.scheduledStartTime.
required (400) titleRequired המשאב LiveBroadcast חייב לציין את המאפיין snippet.title.

רוצה לנסות?

משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.