YouTube Live Streaming API - Errors
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במסמך הזה מפורטים סוגי השגיאות השונים שיכולים להתקבל מפעולות של YouTube Live Streaming API. אפשר גם למצוא רשימה של שגיאות לכל שיטה בנפרד במסמכי העיון של השיטה.
fanFundingEvents
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי fanFundingEvents
.
fanFundingEvents.list
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
insufficientPermissions |
אין לכם את ההרשאות הדרושות כדי לראות את אירועי מימון המעריצים של הערוץ. |
invalidValue (400) |
fanFundingNotEnabledForChannelId |
בערוץ לא מופעלת התכונה 'מימון על ידי מעריצים'. |
liveBroadcasts
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי liveBroadcasts
.
liveBroadcasts.bind
סוג השגיאה |
פרטי השגיאה |
תיאור |
backendError |
internalError |
אירעה שגיאה פנימית במהלך הקישור. |
forbidden (403) |
liveBroadcastBindingNotAllowed |
הסטטוס הנוכחי של השידור החי לא מאפשר לקשר אותו לשידור. |
insufficientPermissions |
insufficientLivePermissions |
אין הרשאה לבקשה לאחזר את השידור החי שצוין. למידע נוסף, ראו הטמעה של אימות OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
notFound (404) |
liveBroadcastNotFound |
השידור שצוין בפרמטר id לא קיים. |
notFound (404) |
liveStreamNotFound |
השידור שצוין בפרמטר streamId לא קיים. |
rateLimitExceeded |
userRequestsExceedRateLimit |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
required (400) |
idRequired |
הפרמטר הנדרש id צריך לזהות את השידור שאליו רוצים לקשר. |
liveBroadcasts.delete
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
liveBroadcastDeletionNotAllowed |
אי אפשר למחוק את השידור החי בגלל הסטטוס הנוכחי שלו. |
insufficientPermissions |
insufficientLivePermissions |
אין הרשאה למחיקת השידור החי שצוין בבקשה. למידע נוסף, ראו הטמעה של אימות OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
notFound (404) |
liveBroadcastNotFound |
המאפיין id שצוין במקור liveBroadcast לא זיהה שידור. |
liveBroadcasts.insert
סוג השגיאה |
פרטי השגיאה |
תיאור |
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 |
במשאב liveBroadcast לא צוין ערך תקין למאפיין 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 |
במשאב liveBroadcast לא צוין ערך תקין למאפיין snippet.title . אורך הערך של המאפיין צריך להיות בין 1 ל-100 תווים. |
limitExceeded |
userBroadcastsExceedLimit |
המשתמש יצר יותר מדי שידורים חיים או שידורים מתוזמנים, ולכן הוא צריך להפסיק או למחוק חלק מהם. |
rateLimitExceeded |
userRequestsExceedRateLimit |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
required (400) |
privacyStatusRequired |
במשאב liveBroadcast צריך לציין את סטטוס הפרטיות. ערכים חוקיים של privacyStatus |
required (400) |
scheduledEndTimeRequired |
במשאב של שידור חי צריך לציין את המאפיין snippet.scheduledEndTime . |
required (400) |
scheduledStartTimeRequired |
במשאב של שידור חי צריך לציין את המאפיין snippet.scheduledStartTime . |
required (400) |
titleRequired |
במשאב של שידור חי צריך לציין את המאפיין snippet.title . |
liveBroadcasts.list
סוג השגיאה |
פרטי השגיאה |
תיאור |
insufficientPermissions |
insufficientLivePermissions |
לשליחת הבקשה אין הרשאה לאחזר את השידור החי. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
liveBroadcasts.transition
סוג השגיאה |
פרטי השגיאה |
תיאור |
backendError |
errorExecutingTransition |
אירעה שגיאה בשינוי הסטטוס של השידור. |
forbidden (403) |
errorStreamInactive |
המעבר המבוקש לא מותר כשהזרם שמשויך לשידור לא פעיל. |
forbidden (403) |
invalidTransition |
אי אפשר לשנות את הסטטוס הנוכחי של השידור החי לסטטוס המבוקש. |
forbidden (403) |
redundantTransition |
השידור החי כבר בסטטוס המבוקש או בתהליך להגעה לסטטוס המבוקש. |
insufficientPermissions |
insufficientLivePermissions |
לשליחת הבקשה אין הרשאה להעביר את השידור החי. |
insufficientPermissions |
livePermissionBlocked |
בשלב הזה, למשתמש שאישר את הבקשה אין אפשרות להפעיל סטרימינג של סרטון בשידור חי ב-YouTube. יכול להיות שפרטים שמסבירים למה המשתמש לא יכול לשדר סרטון בשידור חי זמינים בהגדרות הערוץ של המשתמש בכתובת https://www.youtube.com/features. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
notFound (404) |
liveBroadcastNotFound |
השידור שצוין בפרמטר id לא קיים. |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
required (400) |
idRequired |
הפרמטר id הנדרש צריך לזהות את השידור שרוצים לשנות את הסטטוס שלו. |
required (400) |
statusRequired |
בבקשת ה-API צריך לציין ערך לפרמטר status . |
liveBroadcasts.update
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
closedCaptionsTypeModificationNotAllowed |
אפשר לשנות את הערך של contentDetails.closedCaptionsType רק כשהשידור נמצא במצב created או ready . |
forbidden (403) |
enableAutoStartModificationNotAllowed |
אפשר לשנות את הערך של contentDetails.enableAutoStart רק כשהסטרימינג לא פעיל והשידור הוא בסטטוס created או ready . |
forbidden (403) |
enableClosedCaptionsModificationNotAllowed |
אפשר לשנות את הערך של contentDetails.enableClosedCaptions רק כשהסטטוס של השידור הוא created או ready . |
forbidden (403) |
enableDvrModificationNotAllowed |
אפשר לשנות את הערך של contentDetails.enableDvr רק כשהסטטוס של השידור הוא created או ready . |
forbidden (403) |
enableMonitorStreamModificationNotAllowed |
אפשר לשנות את הערך של contentDetails.monitorStream.enableMonitorStream רק כשהסטטוס של השידור הוא created או ready . |
forbidden (403) |
recordFromStartModificationNotAllowed |
אפשר לשנות את הערך של contentDetails.recordFromStart רק כשהסטטוס של השידור הוא created או ready . |
insufficientPermissions |
insufficientLivePermissions |
לבקשה אין הרשאה לעדכן את השידור החי שצוין. למידע נוסף, ראו הטמעה של אימות OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
invalidValue (400) |
invalidAutoStart |
המשאב liveBroadcast
הכיל ערך לא חוקי במאפיין contentDetails.enableAutoStart .
אי אפשר לשנות את ההגדרה enableAutoStart לשידור קבוע. |
invalidValue (400) |
invalidAutoStop |
המשאב liveBroadcast
הכיל ערך לא חוקי במאפיין contentDetails.enableAutoStop . אי אפשר לשנות את ההגדרה enableAutoStop לשידור קבוע. |
invalidValue (400) |
invalidDescription |
במשאב liveBroadcast לא צוין ערך תקין למאפיין snippet.description . snippet.description יכול להכיל עד 5,000 תווים. |
invalidValue (400) |
invalidEmbedSetting |
המשאב liveBroadcast הכיל ערך לא חוקי במאפיין contentDetails.enable_embed . אי אפשר להטמיע את השידור הזה. |
invalidValue (400) |
invalidEnableClosedCaptions |
במשאב liveBroadcast, הערך של המאפיין contentDetails.enableClosedCaptions לא תואם לערך של ההגדרה contentDetails.closedCaptionType . משנים את המשאב כך שיכלול רק אחד משני המאפיינים, ואז שולחים מחדש את הבקשה. |
invalidValue (400) |
invalidLatencyPreferenceOptions |
המשאב liveBroadcast
הכיל ערך לא חוקי במאפיין contentDetails.latencyPreference .
לא כל ההגדרות נתמכות בהעדפה הזו של השהיה.
|
invalidValue (400) |
invalidPrivacyStatus |
במשאב liveBroadcast לא צוין סטטוס פרטיות תקין. ערכים חוקיים של privacyStatus |
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 . המחרוזת snippet.title חייבת להיות באורך של 1-100 תווים. |
notFound (404) |
liveBroadcastNotFound |
המאפיין id שצוין במקור liveBroadcast לא זיהה שידור. |
required (400) |
broadcastStreamDelayMsRequired |
במקור המידע liveBroadcast לא צוין המאפיין contentDetails.monitorStream.broadcastStreamDelayMs . |
required (400) |
enableMonitorStreamRequired |
במקור המידע liveBroadcast לא צוין המאפיין contentDetails.monitorStream.enableMonitorStream . |
required (400) |
idRequired |
משאב השידור החי חייב לכלול ערך למאפיין id . |
required (400) |
privacyStatusRequired |
לא צוין סטטוס פרטיות במקור המידע liveBroadcast. לרשימת הערכים התקינים של privacyStatus |
required (400) |
scheduledEndTimeRequired |
במקור המידע liveBroadcast לא צוין המאפיין snippet.scheduledEndTime . |
required (400) |
scheduledStartTimeRequired |
במקור המידע liveBroadcast לא צוין המאפיין snippet.scheduledStartTime . |
required (400) |
titleRequired |
במקור המידע liveBroadcast לא צוין המאפיין snippet.title . |
liveBroadcasts.cuepoint
סוג השגיאה |
פרטי השגיאה |
תיאור |
insufficientPermissions (403) |
insufficientLivePermissions |
לבקשה אין הרשאה להוסיף נקודת ציון לשידור חי. |
insufficientPermissions (403) |
liveStreamingNotEnabled |
למשתמש שהרשה את הבקשה אין אפשרות לשדר סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובות https://support.google.com/youtube/answer/2474026 ו-https://www.youtube.com/features. |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
required (400) |
idRequired |
הפרמטר הנדרש id צריך לזהות את השידור שבו רוצים להוסיף נקודת רמז. |
required (400) |
cueTypeRequired |
צריך לציין את השדה cueType הנדרש בגוף בקשת ה-API. |
notFound (404) |
liveBroadcastNotFound |
השידור שצוין בפרמטר id לא קיים. |
invalidValue (400) |
conflictingTimeFields |
אפשר לציין רק אחד מהערכים insertionOffsetTimeMs ו-walltimeMs . הגדרת שני הערכים גורמת לשגיאה. אם לא תגדירו אף אחד מהערכים, מערכת YouTube תשתמש בערך ברירת המחדל של insertionOffsetTimeMs הזמן (0 ), כלומר נקודת ה-cue תתווסף בהקדם האפשרי. |
invalidValue (400) |
invalidInsertionOffsetTimeMs |
במשאב cuepoint צוין ערך לא חוקי למאפיין insertionOffsetTimeMs . הערך חייב להיות 0 או מספר שלם חיובי. |
invalidValue (400) |
invalidWalltimeMs |
במשאב cuepoint צוין ערך לא חוקי למאפיין walltimeMs . הערך צריך להיות מספר שלם שמייצג חותמת זמן של תקופה. |
backendError (5xx) |
serviceUnavailable |
השירות לא זמין. אפשר לנסות שוב לשלוח את הבקשה בעוד כמה דקות. |
liveChatBans
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי liveChatBans
.
liveChatBans.delete
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
forbidden |
אי אפשר להסיר את ההרחקה שצוינה. השגיאה הזו יכולה להתרחש אם בקשת ההרשאה נשלחת על ידי מנהל אחד שמנסה להסיר חסימה ממנהל אחר. |
forbidden (403) |
insufficientPermissions |
אין לך את ההרשאות הדרושות כדי להסיר את החסימה שצוינה. |
invalidValue (400) |
invalidLiveChatBanId |
הפרמטר id מציין ערך לא תקין. |
notFound (404) |
liveChatBanNotFound |
לא ניתן למצוא את החסימה שצוינה. |
liveChatBans.insert
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
insufficientPermissions |
אין לך את ההרשאות הנדרשות כדי לחסום משתמש בצ'אט החי שצוין. |
forbidden (403) |
liveChatBanInsertionNotAllowed |
אי אפשר ליצור את ההרחקה שצוינה. השגיאה הזו יכולה להתרחש אם הבקשה מנסה לחסום את הבעלים של הצ'אט או מנהל אחר. |
invalidValue (400) |
invalidChannelId |
לא ניתן למצוא את מזהה הערוץ שצוין. |
invalidValue (400) |
invalidLiveChatId |
הערך של snippet.liveChatId שצוין בבקשה לא תקין. בודקים את המשאב המשויך liveBroadcast כדי לוודא שהערך נכון. |
notFound (404) |
liveChatNotFound |
לא ניתן למצוא את הצ'אט בשידור חי שצוין. בודקים את משאב liveBroadcast המשויך כדי לוודא שהגדרתם את המאפיין snippet.liveChatId לערך הנכון. |
notFound (404) |
liveChatUserNotFound |
לא הצלחנו למצוא את המשתמש בצ'אט בשידור חי שרצית לחסום. |
required (400) |
bannedUserChannelIdRequired |
במשאב liveChatBan שנשלח בגוף הבקשה צריך לציין ערך למאפיין snippet.bannedUserDetails.channelId . |
required (400) |
liveChatIdRequired |
במשאב liveChatBan שנשלח בגוף הבקשה צריך לציין ערך למאפיין snippet.liveChatId . |
liveChatMessages
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי liveChatMessages
.
liveChatMessages.delete
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
forbidden |
אין לך את ההרשאות הדרושות כדי למחוק את ההודעה שצוינה. |
forbidden (403) |
modificationNotAllowed |
אי אפשר למחוק את המשאב liveChatMessage שצוין. הפרמטר id עשוי לזהות הודעה שנוצרה על ידי מנהל או משתמש אחר שההודעות שלו לא ניתנות למחיקה. |
notFound (404) |
liveChatMessageNotFound |
לא מצאנו את ההודעה שניסית למחוק. צריך לבדוק את הערך של הפרמטר id ולוודא שהוא נכון. |
liveChatMessages.insert
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
forbidden |
אין לך את ההרשאות הדרושות כדי ליצור את ההודעה שצוינה. |
forbidden (403) |
liveChatDisabled |
הבעלים השבית את הצ'אט בשידור חי שצוין, ולכן אי אפשר להוסיף הודעות לצ'אט. |
forbidden (403) |
liveChatEnded |
הצ'אט בשידור חי שצוין כבר לא פעיל. |
invalidValue (400) |
messageTextInvalid |
טקסט ההודעה (snippet.textMessageDetails.messageText ) לא תקין. |
notFound (404) |
liveChatNotFound |
הצ'אט בשידור חי שצוין בבקשת ה-API לא קיים. השגיאה הזו מתרחשת אם הבעלים מחק את הצ'אט. |
rateLimitExceeded |
rateLimitExceeded |
המשתמש פרסם יותר מדי הודעות בצ'אט בפרק זמן נתון. |
required (400) |
liveChatIdRequired |
במשאב liveChatMessage צריך לכלול ערך למאפיין snippet.liveChatId ולציין אותו. |
required (400) |
messageTextRequired |
במשאב liveChatMessage צריך לכלול ערך למאפיין snippet.textMessageDetails.messageText ולציין אותו. |
required (400) |
typeRequired |
במשאב liveChatMessage צריך לכלול ערך למאפיין snippet.type ולציין אותו. מגדירים את ערך הפרמטר ל-text |
liveChatMessages.list
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
forbidden |
אין לך את ההרשאות הנדרשות כדי לאחזר הודעות מהצ'אט החי שצוין. |
forbidden (403) |
liveChatDisabled |
הצ'אט בשידור חי לא מופעל בשידור שצוין. |
forbidden (403) |
liveChatEnded |
הצ'אט בשידור חי שצוין כבר לא פעיל. |
notFound (404) |
liveChatNotFound |
לא ניתן לאחזר את הצ'אט בשידור חי שניסית לאחזר. צריך לבדוק את הערך של הפרמטר liveChatId בבקשה ולוודא שהוא נכון. |
rateLimitExceeded |
rateLimitExceeded |
הבקשה נשלחה מהר מדי אחרי הבקשה הקודמת. השגיאה הזו מתרחשת כשבקשות API לאחזור הודעות נשלחות בתדירות גבוהה יותר מקצב הרענון של YouTube, מה שגורם לבזבוז מיותר של רוחב פס. |
liveCuepoints
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי liveCuepoints
.
liveCuepoints.insert
סוג השגיאה |
פרטי השגיאה |
תיאור |
invalidValue (400) |
conflictingTimeFields |
אפשר לציין רק אחד מהערכים offsetTimeMs ו-walltime . |
liveChatMessages.streamlist
סוג השגיאה |
פרטי השגיאה |
תיאור |
INVALID_ARGUMENT (3) |
LIVE_CHAT_ENDED |
אי אפשר לאחזר הודעות מצ'אט בשידור חי שהסתיים. |
PERMISSION_DENIED (7) |
forbidden |
אין לך את ההרשאות הנדרשות כדי לאחזר הודעות מהצ'אט החי שצוין. |
PERMISSION_DENIED (7) |
liveChatDisabled |
הצ'אט בשידור חי לא מופעל בשידור שצוין. |
PERMISSION_DENIED (7) |
liveChatEnded |
הצ'אט בשידור חי שצוין כבר לא פעיל. |
NOT_FOUND (5) |
liveChatNotFound |
לא ניתן לאחזר את הצ'אט בשידור חי שניסית לאחזר. צריך לבדוק את הערך של הפרמטר liveChatId בבקשה ולוודא שהוא נכון. |
RESOURCE_EXHAUSTED (8) |
rateLimitExceeded |
הבקשה נשלחה מהר מדי אחרי הבקשה הקודמת. השגיאה הזו מתרחשת כשבקשות API לאחזור הודעות נשלחות בתדירות גבוהה יותר מקצב הרענון של YouTube, מה שגורם לבזבוז מיותר של רוחב פס. |
liveCuepoints
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי liveCuepoints
.
liveCuepoints.insert
סוג השגיאה |
פרטי השגיאה |
תיאור |
invalidValue (400) |
conflictingTimeFields |
אפשר לציין רק אחד מהערכים offsetTimeMs ו-walltime . |
liveStreams
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי liveStreams
.
liveStreams.delete
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
liveStreamDeletionNotAllowed |
אי אפשר למחוק את השידור החי שצוין כי הוא מקושר לשידור שעדיין לא הסתיים. |
insufficientPermissions |
insufficientLivePermissions |
לשולח הבקשה אין הרשאה למחוק את השידור החי שצוין. למידע נוסף, ראו הטמעה של אימות OAuth 2.0. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. מידע נוסף זמין במאמר בנושא התאמה לשימוש בתכונות. |
notFound (404) |
liveStreamNotFound |
השידור החי שצוין לא קיים. |
liveStreams.insert
סוג השגיאה |
פרטי השגיאה |
תיאור |
insufficientPermissions |
insufficientLivePermissions |
לשולח הבקשה אין הרשאה ליצור את השידור החי שצוין. |
insufficientPermissions |
livePermissionBlocked |
בשלב הזה, למשתמש שאישר את הבקשה אין אפשרות להפעיל סטרימינג של סרטון בשידור חי ב-YouTube. יכול להיות שפרטים שמסבירים למה המשתמש לא יכול לשדר סרטון בשידור חי זמינים בהגדרות הערוץ של המשתמש בכתובת https://www.youtube.com/features. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
invalidValue (400) |
invalidDescription |
הערך של מאפיין snippet.description במשאב liveStream יכול להכיל עד 10,000 תווים. |
invalidValue (400) |
invalidFormat |
הערך של הנכס cdn.format במשאב liveStream לא תקין. |
invalidValue (400) |
invalidFrameRate |
הערך של הנכס cdn.frameRate במשאב liveStream לא תקין. |
invalidValue (400) |
invalidIngestionType |
הערך של הנכס cdn.ingestionType במשאב liveStream לא תקין. |
invalidValue (400) |
invalidResolution |
הערך של הנכס cdn.resolution במשאב liveStream לא תקין. |
invalidValue (400) |
invalidTitle |
הערך של המאפיין snippet.title במשאב liveStream צריך להיות באורך של 1 עד 128 תווים. |
rateLimitExceeded |
userRequestsExceedRateLimit |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
required (400) |
cdnRequired |
משאב liveStream חייב להכיל את האובייקט cdn . |
required (400) |
frameRateRequired |
ה-API מחזיר את השגיאה הזו אם מציינים ערך למאפיין cdn.resolution אבל לא למאפיין cdn.frameRate . |
required (400) |
ingestionTypeRequired |
במשאב liveStream צריך לציין ערך למאפיין cdn.ingestionType . |
required (400) |
resolutionRequired |
ה-API מחזיר את השגיאה הזו אם מציינים ערך למאפיין cdn.frameRate אבל לא למאפיין cdn.resolution . |
required (400) |
titleRequired |
במשאב liveStream צריך לציין ערך למאפיין snippet.title . |
liveStreams.list
סוג השגיאה |
פרטי השגיאה |
תיאור |
insufficientPermissions |
insufficientLivePermissions |
לשליחת הבקשה אין הרשאה לאחזר את השידור החי שצוין. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
liveStreams.update
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
liveStreamModificationNotAllowed |
אי אפשר לשנות את השידור החי שצוין במצבו הנוכחי. מידע נוסף זמין במאמר בנושא משך השידור. |
forbidden (403) |
liveStreamModificationNotAllowed |
אי אפשר לשנות את הערך של השדות cdn.format , cdn.frameRate , cdn.ingestionType או cdn.resolution אחרי שיוצרים את הסטרימינג. |
forbidden (403) |
liveStreamModificationNotAllowed |
ממשק ה-API לא מאפשר לשנות שידור שאפשר להשתמש בו שוב לשידור שאפשר להשתמש בו רק פעם אחת, או להיפך. מידע נוסף זמין במאמר הסבר על שידורים וסטרימינג. |
insufficientPermissions |
insufficientLivePermissions |
אין הרשאה לעדכן את השידור החי שצוין בבקשה. למידע נוסף, ראו הטמעה של אימות OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
למשתמש שאישר את הבקשה אין הרשאה להפעיל סטרימינג של סרטונים בשידור חי ב-YouTube. המשתמש יכול למצוא מידע נוסף בכתובת https://www.youtube.com/features. |
invalidValue (400) |
invalidDescription |
הערך של מאפיין snippet.description במשאב liveStream יכול להכיל עד 10,000 תווים. |
invalidValue (400) |
invalidTitle |
הערך של המאפיין snippet.title במשאב liveStream צריך להיות באורך של 1 עד 128 תווים. |
notFound (404) |
liveStreamNotFound |
השידור החי שצוין לא קיים. |
required (400) |
idRequired |
במשאב של שידור חי צריך לציין ערך למאפיין id . |
required (400) |
ingestionTypeRequired |
במשאב של שידור חי צריך לציין ערך למאפיין cdn.ingestionType . |
required (400) |
titleRequired |
במשאב של שידור חי צריך לציין ערך למאפיין snippet.title . |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[[["\u003cp\u003eThe API returns \u003ccode\u003eforbidden (403)\u003c/code\u003e or \u003ccode\u003einsufficientPermissions\u003c/code\u003e errors when a user lacks the necessary authorization to perform an action, such as creating, deleting, or viewing resources.\u003c/p\u003e\n"],["\u003cp\u003eSeveral API calls related to live broadcasts, streams, and cuepoints may return a \u003ccode\u003eliveStreamingNotEnabled\u003c/code\u003e error, which means that the user has not enabled live streaming for their channel.\u003c/p\u003e\n"],["\u003cp\u003eMany errors across different API resources are caused by \u003ccode\u003einvalidValue (400)\u003c/code\u003e issues, including invalid descriptions, titles, privacy status, or time-related fields, which indicate that the provided data does not meet the required criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequests can fail with a \u003ccode\u003erateLimitExceeded\u003c/code\u003e error if a user surpasses the allowed request rate, which could happen in multiple \u003ccode\u003eliveBroadcasts\u003c/code\u003e, \u003ccode\u003eliveChatMessages\u003c/code\u003e, or \u003ccode\u003eliveStreams\u003c/code\u003e operations.\u003c/p\u003e\n"],["\u003cp\u003eMany errors indicate a \u003ccode\u003enotFound (404)\u003c/code\u003e issue, indicating that a broadcast, stream, chat, message, or ban cannot be located, which often signals an incorrect or deleted resource.\u003c/p\u003e\n"]]],["The document details error scenarios within the YouTube Live API, categorized by function. `fanFundingEvents.list` can fail due to insufficient permissions or disabled Fan Funding. Live broadcast actions (`bind`, `delete`, `insert`, `list`, `transition`, `update`) often fail from user permission issues, missing parameters, invalid values, or exceeding limits. Live chat interactions (`bans`, `messages`) face issues with permissions, invalid IDs, missing data, and rate limits. `liveCuepoints` and `liveStreams` can encounter similar errors, including issues with missing data, incorrect configuration, or forbidden actions. `sponsors.list` can be blocked due to permissions or disabled sponsorship.\n"],null,[]]