LiveBroadcasts: insert

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

יצירת שידור.

תרחישים נפוצים

שליחת בקשה

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

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
insufficientPermissions insufficientLivePermissions הבקשה לא מורשית ליצור את השידור החי.
insufficientPermissions livePermissionBlocked בשלב זה, המשתמש שאישר את הבקשה לא יכול לצפות בווידאו בשידור חי ב-YouTube. בכתובת https://www.youtube.com/features אפשר למצוא פרטים על הסיבה לכך שהמשתמש לא יכול לשדר וידאו בשידור חי.
insufficientPermissions liveStreamingNotEnabled המשתמש שאישר את הבקשה לא מורשה לצפות בווידאו בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features.
invalidValue (400) invalidAutoStart משאב Broadcastcast הכיל ערך לא חוקי במאפיין contentDetails.enableAutoStart. לא כל השידורים תומכים בהגדרה הזו.
invalidValue (400) invalidAutoStop משאב Broadcastcast הכיל ערך לא חוקי במאפיין contentDetails.enableAutoStop. לא ניתן לשנות את ההגדרה של enableAutoStop עבור שידור קבוע.
invalidValue (400) invalidDescription במשאב liveBroadcast לא צוין ערך חוקי למאפיין snippet.description. ערך המאפיין יכול להכיל עד 5,000 תווים.
invalidValue (400) invalidEmbedSetting המשאב של liveBroadcast הכיל ערך לא חוקי למאפיין contentDetails.enable_embed. לא ניתן להטמיע את השידור הזה.
invalidValue (400) invalidLatencyPreferenceOptions משאב Broadcastcast הכיל ערך לא חוקי במאפיין 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 במשאב liveBroadcast לא צוין ערך חוקי למאפיין 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 ואת התשובה.