LiveBroadcasts: insert

ה-API תומך עכשיו באפשרות לסמן שידורים חיים כתוכן 'במיוחד לילדים'. בנוסף, המשאב liveBroadcast מכיל עכשיו מאפיין שמציין את הסטטוס 'במיוחד לילדים' של השידור החי. ב-10 בינואר 2020 עדכנו גם את התנאים וההגבלות של שירותי ה-API של YouTube ואת כללי המדיניות למפתחים. מידע נוסף זמין בהיסטוריית הגרסאות של שירות 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, ואפשר להשתמש בו רק בשילוב עם הפרמטר הזה. בנוסף, צריך לאשר את הבקשה באמצעות חשבון במערכת ניהול התוכן שמקושר לבעל התוכן שמוגדר בפרמטר onBehalfOfContentOwner. לבסוף, הערוץ שערך הפרמטר onBehalfOfContentOwnerChannel מציין צריך להיות מקושר לבעל התוכן שערך הפרמטר onBehalfOfContentOwner מציין.

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

גוף הבקשה

מציינים משאב liveBroadcast בגוף הבקשה. במשאב הזה:

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

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

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

    • snippet.title
    • snippet.description
    • snippet.categoryId
    • 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
    • contentDetails.availabilityConfig
    הערה: בטבלת המאפיינים מתועדים ערכי ברירת המחדל שמוגדרים למאפיינים שברשימה. ערכי ברירת המחדל יוקצו באחד מהמקרים הבאים:
    • לא מציינים ערכים למאפיינים האלה.
    • ערך הפרמטר part בבקשה לא מציין את החלק שמכיל את המאפיינים האלה.

תשובה

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

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שיכולות להתקבל מה-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 במשאב של שידור חי לא צוין ערך תקין במאפיין 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 במשאב של שידור חי לא צוין ערך תקין במאפיין snippet.title. ערך המאפיין צריך להיות באורך של 1 עד 100 תווים.
limitExceeded userBroadcastsExceedLimit המשתמש יצר יותר מדי שידורים חיים או שידורים מתוזמנים, והוא צריך להפסיק או למחוק חלק מהם.
rateLimitExceeded userRequestsExceedRateLimit המשתמש שלח יותר מדי בקשות בפרק זמן נתון.
required (400) privacyStatusRequired במשאב liveBroadcast צריך לציין את סטטוס הפרטיות. ערכים חוקיים של privacyStatus
required (400) scheduledEndTimeRequired המשאב liveBroadcast חייב לציין את המאפיין snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired המשאב liveBroadcast חייב לציין את המאפיין snippet.scheduledStartTime.
required (400) titleRequired במשאב liveBroadcast צריך לציין את המאפיין snippet.title.

רוצה לנסות?

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