במסמך הזה מפורטים סוגי השגיאות השונים שפעולות YouTube Data API יכולות להחזיר. תוכלו גם למצוא רשימה של שגיאות לכל שיטה בנפרד במסמכי התיעוד של השיטה.
שגיאות כלליות
בטבלאות הבאות מפורטות הודעות שגיאה של API שאינן ספציפיות לשיטת API מסוימת.
Core API errors
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
forbidden |
הגישה אסורה. ייתכן שהבקשה לא מורשית כראוי. |
quotaExceeded (403) |
quotaExceeded |
לא ניתן להשלים את הבקשה מכיוון שחרגת מהמכסה. |
Common request errors
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
incompatibleParameters |
הבקשה מציינת שני פרמטרים או יותר שלא ניתן להשתמש בהם באותה בקשה. |
badRequest (400) |
invalidFilters |
הבקשה מציינת פרמטר לא חוקי של מסנן. |
badRequest (400) |
invalidPageToken |
הבקשה מציינת אסימון דף לא חוקי. |
badRequest (400) |
missingRequiredParameter |
חסר פרמטר נדרש בבקשה. |
badRequest (400) |
unexpectedParameter |
הבקשה מציינת פרמטר בלתי צפוי. |
forbidden (403) |
accountDelegationForbidden |
המשתמש המאומת לא יכול לפעול בשם חשבון Google שצוין. |
forbidden (403) |
authenticatedUserAccountClosed |
חשבון YouTube של המשתמש המאומת נסגר. אם המשתמש המאומת פועל מטעם חשבון Google אחר, השגיאה הזו מתייחסת לחשבון השני. |
forbidden (403) |
authenticatedUserAccountSuspended |
חשבון YouTube של המשתמש המאומת מושעה. אם המשתמש המאומת פועל מטעם חשבון Google אחר, השגיאה הזו מתייחסת לחשבון השני. |
forbidden (403) |
authenticatedUserNotChannel |
לבקשה הזו, המשתמש המאומת צריך לעבור לערוץ, אבל לא. אם הבקשה מאומתת ומשתמשת בפרמטר הענקת הגישה onBehalfOfContentOwner , צריך להגדיר גם את הפרמטר onBehalfOfContentOwnerChannel . |
forbidden (403) |
channelClosed |
הערוץ שזוהה בבקשה נסגר. |
forbidden (403) |
channelNotFound |
לא ניתן למצוא את הערוץ שצוין בבקשה. |
forbidden (403) |
channelSuspended |
הערוץ שצוין בבקשה הושעה. |
forbidden (403) |
cmsUserAccountNotFound |
משתמש ה-CMS אינו מורשה לפעול בשם בעלי התוכן שצוינו. |
forbidden (403) |
insufficientCapabilities |
למשתמש ה-CMS אין יכולות מספיקות. |
forbidden (403) |
insufficientPermissions |
אסימון OAuth 2.0 שסופק עבור הבקשה מציין היקפים שאינם מספיקים כדי לגשת לנתונים המבוקשים. |
notFound (404) |
contentOwnerAccountNotFound |
החשבון של בעלי התוכן שצוין לא נמצא. |
Request context errors
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
invalidLanguage |
ערך הפרמטר hl לא מציין קוד שפה חוקי. |
badRequest (400) |
invalidMine |
השימוש של הבקשה בפרמטר mine אינו נתמך. |
badRequest (400) |
invalidMine |
לא ניתן להשתמש בפרמטר mine בבקשות שבהן המשתמש המאומת הוא שותף YouTube. עליך להסיר את הפרמטר mine , לבצע אימות כמשתמש YouTube על ידי הסרת הפרמטר onBehalfOfContentOwner , או לפעול כאחד מערוצי השותף ולספק את הפרמטר onBehalfOfContentOwnerChannel אם הוא זמין לשיטה שנקראת. |
badRequest (400) |
invalidPart |
הפרמטר part של הבקשה מציין חלקים מסוימים שאי אפשר לכתוב בו-זמנית. |
badRequest (400) |
invalidRegionCode |
הפרמטר regionCode מציין קוד אזור לא חוקי. |
badRequest (400) |
unexpectedPart |
הפרמטר part של הבקשה מציין ערך בלתי צפוי. |
badRequest (400) |
unknownPart |
הפרמטר part של הבקשה מציין ערך לא ידוע. |
badRequest (400) |
unsupportedLanguageCode |
ערך הפרמטר hl לא מציין קוד שפה נתמך. |
badRequest (400) |
unsupportedRegionCode |
הפרמטר regionCode מציין קוד אזור שאינו נתמך. |
unauthorized (401) |
authorizationRequired |
הבקשה משתמשת בפרמטר mine אבל אין לה הרשאה כראוי. |
unauthorized (401) |
youtubeSignupRequired |
משמעות השגיאה הזו היא שלמשתמש יש חשבון Google לא מקושר, כלומר, למשתמש יש חשבון Google אבל אין לו ערוץ YouTube. למשתמשים כאלה יש גישה לתכונות רבות שתלויות באישור המשתמשים, כמו דירוג סרטונים או הוספת סרטונים לפלייליסט watch_later . עם זאת, לדוגמה, המשתמש צריך ערוץ YouTube כדי להעלות סרטון. למשתמש עם חשבון Gmail או מכשיר Android בטוח יש חשבון Google, אבל יכול להיות שהוא לא קישר כבר את חשבון Google הזה לערוץ YouTube.השגיאה הזאת נפוצה מאוד כשמנסים להשתמש בתהליך של חשבון שירות OAuth 2.0. YouTube לא תומך בחשבונות שירות, ואם תנסה לבצע אימות באמצעות חשבון שירות תקבל את הודעת השגיאה הזו. פוסט בבלוג של YouTube API שכולל תמיכה בחשבונות Google כולל הסבר מפורט יותר על השגיאה youtubeSignupRequired . למרות שהפוסט בבלוג מסביר את השגיאה עבור גרסה 2.1 של ה-API, משמעות השגיאה עדיין רלוונטית. |
פעילויות
activities.insert
.
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של activities
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
activities.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
homeParameterDeprecated |
נתוני הפעילות בדף הבית של המשתמש לא זמינים דרך ה-API הזה. השגיאה הזו יכולה להתרחש אם מגדירים את הפרמטר home לערך true במסגרת בקשה לא מורשית. |
forbidden (403) |
forbidden |
הבקשה לא מורשית כראוי. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את מזהה הערוץ שזוהה על ידי הפרמטר channelId של הבקשה. |
notFound (404) |
homeChannelNotFound |
לא ניתן למצוא פיד של דף הבית של YouTube למשתמש המאומת הנוכחי. |
unauthorized (401) |
authorizationRequired |
הבקשה משתמשת בפרמטר home אבל אין לה הרשאה כראוי. |
channelBanners
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של channelBanners
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
channelBanners.insert
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
bannerAlbumFull |
באלבום הגרפיקה בערוץ YouTube שלך יש יותר מדי תמונות. אפשר להיכנס לאתר http://photos.google.com, לנווט לדף האלבומים ולהסיר חלק מהתמונות מהאלבום. |
badRequest (400) |
mediaBodyRequired |
הבקשה אינה כוללת את תוכן התמונה. |
channelSections
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של channelSections
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
channelSections.delete
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
notEditable |
לא ניתן למחוק את קטע הערוץ הזה. |
forbidden (403) |
channelSectionForbidden |
הבקשה לא מאומתת כראוי או אינה נתמכת בערוץ הזה. |
invalidValue (400) |
idInvalid |
המאפיין id מציין מזהה קטע לא חוקי בערוץ. |
invalidValue (400) |
idRequired |
המאפיין id חייב לציין ערך שמזהה את קטע הערוץ שנמחק. |
notFound (404) |
channelNotFound |
הערוץ לא נמצא. |
notFound (404) |
channelSectionNotFound |
קטע הערוץ שניסית לעדכן לא נמצא. |
channelSections.insert
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
צריך להגדיר את המאפיין snippet.defaultLanguage של המשאב channelSection כדי להוסיף או לעדכן את האובייקט localizations של המשאב הזה. |
badRequest (400) |
invalidLanguage |
אחד ממפתחות השפה של האובייקט localizations נכשל. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
notEditable |
לא ניתן ליצור את הקטע הזה בערוץ. |
badRequest (400) |
styleRequired |
המשאב channelSection חייב לציין ערך עבור השדה snippet.style . |
badRequest (400) |
targetInvalidCountry |
אחד מהערכים ברשימה targeting.countries נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
targetInvalidLanguage |
אחד מהערכים ברשימה targeting.languages נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
targetInvalidRegion |
אחד מהערכים ברשימה targeting.regions נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
typeRequired |
המשאב channelSection חייב לציין ערך עבור השדה snippet.type . |
forbidden (403) |
channelSectionForbidden |
הבקשה לא מאומתת כראוי או שאינה נתמכת בערוץ הזה. |
invalidValue (400) |
channelNotActive |
לפחות אחד מהערוצים שצוינו אינו פעיל. |
invalidValue (400) |
channelsDuplicated |
הבקשה נכשלה כי צוינו ערוצים כפולים. |
invalidValue (400) |
channelsNeeded |
אם למאפיין snippet.type יש ערך של multipleChannels , צריך לציין את המאפיין contentDetails.channels[] ולציין לפחות ערוץ אחד. |
invalidValue (400) |
channelsNotExpected |
במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.channels[] , אבל לא צפויים ערוצים עבור סוג הערוץ הזה. |
invalidValue (400) |
contentDetailsNeeded |
המשאב שברצונך להוסיף חייב להכיל אובייקט contentDetails עבור סוג הערוץ הזה. |
invalidValue (400) |
inValidPosition |
המאפיין snippet.position מכיל ערך לא חוקי. |
invalidValue (400) |
maxChannelSectionExceeded |
לא ניתן להשלים את הבקשה כי בערוץ כבר יש את המספר המקסימלי של אוספים בערוץ. |
invalidValue (400) |
maxChannelsExceeded |
הבקשה נכשלה כי ניסתה לכלול יותר מדי ערוצים בקטע הערוצים. |
invalidValue (400) |
maxPlaylistExceeded |
הבקשה נכשלה כי ניסתה לכלול יותר מדי פלייליסטים בקטע הערוץ. |
invalidValue (400) |
onePlaylistNeeded |
אם למאפיין snippet.type יש את הערך singlePlaylist , המאפיין contentDetails.playlists[] צריך לציין פלייליסט אחד בדיוק. |
invalidValue (400) |
ownChannelInChannels |
לא ניתן לכלול את הערוץ שלכם בקטע שמופיע בערוץ הזה בערוץ. |
invalidValue (400) |
playlistIsPrivate |
אחד או יותר מהפלייליסטים שצוינו הם פרטיים, ולכן לא ניתן לכלול אותם בקטע הערוץ. |
invalidValue (400) |
playlistsDuplicated |
הבקשה נכשלה כי צוינו פלייליסטים כפולים. |
invalidValue (400) |
playlistsNeeded |
אם למאפיין snippet.type יש ערך של singlePlaylist או multiplePlaylists , צריך לציין את המאפיין contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.playlists[] , אבל לא צריך להשתמש בפלייליסטים בקטעים מהסוג הזה בערוצים. |
invalidValue (400) |
snippetNeeded |
יש לציין snippet כדי ליצור את הקטע בערוץ. |
invalidValue (400) |
titleLengthExceeded |
הערך של המאפיין snippet.title ארוך מדי. |
invalidValue (400) |
titleRequired |
אם למאפיין snippet.type יש ערך של multiplePlaylists או multipleChannels , צריך לציין ערך עבור המאפיין snippet.title כדי להגדיר את כותרת הקטע. |
notFound (404) |
channelNotFound |
לא ניתן למצוא אחד או יותר מהערוצים שצוינו. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא אחד או יותר מהפלייליסטים שצוינו. |
channelSections.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
channelSectionForbidden |
למגיש הבקשה אין הרשאה לגשת לקטעי הערוץ המבוקשים. |
invalidValue (400) |
idInvalid |
הבקשה מציינת מזהה לא חוקי של קטע בערוץ. |
invalidValue (400) |
invalidCriteria |
לא ניתן היה להשלים את הבקשה כי הקריטריונים לסינון אינם חוקיים. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את הערוץ המשויך לבקשה. |
notFound (404) |
channelSectionNotFound |
קטע הערוץ המשויך לבקשה לא נמצא. |
channelSections.update
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
צריך להגדיר את המאפיין snippet.defaultLanguage של המשאב channelSection כדי להוסיף או לעדכן את האובייקט localizations של המשאב הזה. |
badRequest (400) |
invalidLanguage |
אחד ממפתחות השפה של האובייקט localizations נכשל. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
notEditable |
לא ניתן לערוך את קטע הערוץ הזה. |
badRequest (400) |
styleRequired |
המשאב channelSection חייב לציין ערך עבור השדה snippet.style . |
badRequest (400) |
targetInvalidCountry |
אחד מהערכים ברשימה targeting.countries נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
targetInvalidLanguage |
אחד מהערכים ברשימה targeting.languages נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
targetInvalidRegion |
אחד מהערכים ברשימה targeting.regions נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים. |
badRequest (400) |
typeRequired |
המשאב channelSection חייב לציין ערך עבור השדה snippet.type . |
forbidden (403) |
channelSectionForbidden |
הבקשה לא מאומתת כראוי או שאינה נתמכת בערוץ הזה. |
invalidValue (400) |
channelNotActive |
לפחות אחד מהערוצים שצוינו אינו פעיל. |
invalidValue (400) |
channelsDuplicated |
הבקשה נכשלה כי צוינו ערוצים כפולים. |
invalidValue (400) |
channelsNeeded |
אם למאפיין snippet.type יש ערך של multipleChannels , צריך לציין את המאפיין contentDetails.channels[] ולציין לפחות ערוץ אחד. |
invalidValue (400) |
channelsNotExpected |
במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.channels[] , אבל לא צפויים ערוצים עבור סוג הערוץ הזה. |
invalidValue (400) |
contentDetailsNeeded |
המשאב שברצונך לעדכן חייב להכיל אובייקט contentDetails עבור סוג הערוץ הזה. |
invalidValue (400) |
idInvalid |
המאפיין id מציין מזהה קטע לא חוקי בערוץ. |
invalidValue (400) |
idRequired |
המאפיין id חייב לציין ערך שמזהה את קטע הערוץ שמתעדכן. |
invalidValue (400) |
inValidPosition |
המאפיין snippet.position מכיל ערך לא חוקי. |
invalidValue (400) |
maxChannelsExceeded |
הבקשה נכשלה כי ניסתה לכלול יותר מדי ערוצים בקטע הערוצים. |
invalidValue (400) |
maxPlaylistExceeded |
הבקשה נכשלה כי ניסתה לכלול יותר מדי פלייליסטים בקטע הערוץ. |
invalidValue (400) |
onePlaylistNeeded |
אם למאפיין snippet.type יש את הערך singlePlaylist , המאפיין contentDetails.playlists[] צריך לציין פלייליסט אחד בדיוק. |
invalidValue (400) |
ownChannelInChannels |
לא ניתן לכלול את הערוץ שלכם בקטע שמופיע בערוץ הזה בערוץ. |
invalidValue (400) |
playlistIsPrivate |
אחד או יותר מהפלייליסטים שצוינו הם פרטיים, ולכן לא ניתן לכלול אותם בקטע הערוץ. |
invalidValue (400) |
playlistsDuplicated |
הבקשה נכשלה כי צוינו פלייליסטים כפולים. |
invalidValue (400) |
playlistsNeeded |
אם למאפיין snippet.type יש ערך של singlePlaylist או multiplePlaylists , צריך לציין את המאפיין contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.playlists[] , אבל לא צריך להשתמש בפלייליסטים בקטעים מהסוג הזה בערוצים. |
invalidValue (400) |
snippetNeeded |
עליך לציין snippet כדי לעדכן את קטע הערוץ. |
invalidValue (400) |
titleLengthExceeded |
הערך של המאפיין snippet.title ארוך מדי. |
invalidValue (400) |
titleRequired |
אם למאפיין snippet.type יש ערך של multiplePlaylists או multipleChannels , צריך לציין ערך עבור המאפיין snippet.title כדי להגדיר את כותרת הקטע. |
notFound (404) |
channelNotFound |
לא ניתן למצוא אחד או יותר מהערוצים שצוינו. |
notFound (404) |
channelSectionNotFound |
קטע הערוץ שניסית לעדכן לא נמצא. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא אחד או יותר מהפלייליסטים שצוינו. |
ערוצים
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של channels
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
channels.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
invalidCriteria |
אפשר לציין עד אחד מהמסננים הבאים:id , mySubscribers , categoryId , mine , managedByMe , forUsername . במקרה של אימות בעלי התוכן באמצעות הפרמטר onBehalfOfContentOwner , ניתן לציין רק את id או managedByMe . |
forbidden (403) |
channelForbidden |
הערוץ שצוין בפרמטר id לא תומך בבקשה או שהבקשה לא מורשית כראוי. |
notFound (404) |
categoryNotFound |
הקטגוריה שזוהתה על ידי הפרמטר categoryId לא נמצאה. אפשר להשתמש בשיטה guideCategories.list כדי לאחזר רשימה של ערכים חוקיים. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את הערוץ שצוין בפרמטר id . |
channels.update
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
brandingValidationError |
אחד מהערכים באובייקט brandingSettings נכשל באימות. אפשר להשתמש בשיטה channels.list כדי לאחזר את ההגדרות הקיימות של הערוץ, ולעדכן את ערכי המאפיינים בהתאם להנחיות במסמכי התיעוד בנושא המשאבים של channels . |
badRequest (400) |
channelTitleUpdateForbidden |
כשמעדכנים את brandingSettings part של ערוץ, צריך להגדיר את ערך המאפיין brandingSettings.channel.title לשם הערוץ הנוכחי או להשמיט את המאפיין. ה-API מחזיר שגיאה אם משנים את הערך של הנכס. |
badRequest (400) |
defaultLanguageNotSetError |
צריך להגדיר את defaultLanguage כדי לעדכן את localizations . |
badRequest (400) |
invalidBrandingOption |
אחת מהגדרות המיתוג שציינת לא קיימת. צריך להשתמש בשיטה channels.list כדי לאחזר ערכים חוקיים, וחשוב לעדכן אותם בהתאם להנחיות במסמכי התיעוד של מקורות המידע של channels . |
badRequest (400) |
invalidCustomMessage |
המטא-נתונים של הבקשה מציינים הודעה מותאמת אישית לא חוקית. צריך לבדוק את הערך של המאפיין invideoPromotion.items[].customMessage במשאב שהבקשה שלחה. |
badRequest (400) |
invalidDuration |
המטא-נתונים של הבקשה מציינים משך זמן לא חוקי בחלק invideoPromotion. |
badRequest (400) |
invalidDuration |
המטא-נתונים של הבקשה מציינים סוג מיקום לא חוקי שמאפשר לקבוע את המיקום של הפריט המקודם בנגן הווידאו. צריך לבדוק את הערך של המאפיין invideoPromotion.position.type במשאב שהבקשה שלחה. |
badRequest (400) |
invalidRecentlyUploadedBy |
המטא-נתונים של הבקשה מציינים מזהה ערוץ לא חוקי. צריך לבדוק את הערך של המאפיין invideoPromotion.items[].id.recentlyUploadedBy במשאב שהבקשה שלחה. |
badRequest (400) |
invalidTimingOffset |
המטא-נתונים של הבקשה מציינים קיזוז תזמון לא חוקי בחלק invideoPromotion. |
badRequest (400) |
invalidTimingOffset |
המטא-נתונים של הבקשה מציינים קיזוז תזמון לא חוקי שמאפשר לקבוע מתי יש להציג את הפריט המקודם בנגן הווידאו. צריך לבדוק את הערך של המאפיין invideoPromotion.timing.offsetMs במשאב שהבקשה שלחה. |
badRequest (400) |
invalidTimingType |
המטא-נתונים של הבקשה מציינים שיטת תזמון לא חוקית שמאפשרת לקבוע מתי יש להציג את הפריט המקודם בנגן הווידאו. צריך לבדוק את הערך של המאפיין invideoPromotion.timing.type במשאב שהבקשה שלחה. |
badRequest (400) |
localizationValidationError |
אחד הערכים באובייקט הלוקליזציה נכשל. אפשר להשתמש בשיטה channels.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד בנושא מקורות של ערוצים. |
badRequest (400) |
tooManyPromotedItems |
חריגה ממספר הפריטים המקודמים המותרים בחלק invideoPromotion. |
forbidden (403) |
channelForbidden |
הערוץ שצוין בפרמטר id לא תומך בבקשה או שהבקשה לא מורשית כראוי. |
forbidden (403) |
promotedVideoNotAllowed |
לא ניתן למצוא את הערוץ שבקשת ה-API מנסה לעדכן. צריך לבדוק את הערך של המאפיין id במשאב channel שנשלחה בבקשה כדי לוודא שמזהה הערוץ נכון. |
forbidden (403) |
websiteLinkNotAllowed |
כתובת האתר שצוינה אינה מותרת. |
notFound (404) |
channelNotFound |
הערוץ שצוין באמצעות הפרמטר id לא נמצא או שאין בו אפשרויות מיתוג. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את הערוץ שצוין בפרמטר id . |
notFound (404) |
unknownChannelId |
לא נמצא מזהה הערוץ שצוין. |
notFound (404) |
unknownChannelId |
מזהה הערוץ שצוין לאחרונה UploadedBy לא נמצא. |
notFound (404) |
unknownVideoId |
מזהה הווידאו שצוין כפריט מקודם לא נמצא. |
required (400) |
requiredItemIdType |
במטא-נתונים של הבקשה צריך לציין סוג פריט בחלק invideoPromotion. |
required (400) |
requiredItemId |
במטא-נתונים של הבקשה צריך לציין פריט בחלק invideoPromotion. |
required (400) |
requiredTimingOffset |
המטא-נתונים של הבקשה צריכים לציין קיזוז תזמון שמוגדר כברירת מחדל, כדי שהמערכת של YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.offsetMs במשאב שהבקשה שולחת. |
required (400) |
requiredTimingOffset |
המטא-נתונים של הבקשה צריכים לציין קיזוז תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.offsetMs במשאב שהבקשה שולחת. |
required (400) |
requiredTimingType |
המטא-נתונים של הבקשה צריכים לציין שיטת תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.type במשאב שהבקשה שולחת. |
required (400) |
requiredTimingType |
המטא-נתונים של הבקשה צריכים לציין שיטת תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.type במשאב שהבקשה שולחת. |
required (400) |
requiredTiming |
המטא-נתונים של הבקשה צריכים לציין תזמון לכל פריט בחלק invideoPromotion . |
required (400) |
requiredVideoId |
המטא-נתונים של הבקשה צריכים לכלול מזהה וידאו שישמש לזיהוי הפריט המקודם. |
required (400) |
requiredWebsiteUrl |
המטא-נתונים של הבקשה חייבים לציין כתובת אתר בקטע invideoPromotion. מגדירים את הערך של המאפיין invideoPromotion.items[].id.websiteUrl במשאב שהבקשה שולחת. |
commentThreads
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של commentThreads
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
commentThreads.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
operationNotSupported |
בקשת ה-API לא תקינה או שנוצרה באופן שגוי, וכתוצאה מכך שרת ה-API לא הבין את הבקשה. |
badRequest (400) |
processingFailure |
שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי. כדי לוודא שהוא תקין, צריך לבדוק את המבנה של המשאב commentThread בגוף הבקשה. |
forbidden (403) |
commentsDisabled |
בסרטון שזוהה באמצעות הפרמטר videoId הושבתו תגובות. |
forbidden (403) |
forbidden |
לא ניתן לאחזר אחד או יותר משרשורי התגובות המבוקשים עקב הרשאות לא מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך. |
notFound (404) |
channelNotFound |
הערוץ שזוהה על ידי הפרמטר allThreadsRelatedToChannelId לא נמצא. |
notFound (404) |
commentThreadNotFound |
לא ניתן למצוא אחד או יותר משרשורי התגובות שצוינו. צריך לבדוק את ערכי הפרמטר id של הבקשה כדי לוודא שהם נכונים. |
notFound (404) |
videoNotFound |
הסרטון שזוהה על ידי הפרמטר videoId לא נמצא. |
commentThreads.insert
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
כל שרשור תגובות צריך להיות מקושר לערוץ או לסרטון. צריך לוודא שהמשאב מציין ערכים למאפיין snippet.channelId וגם למאפיין snippet.videoId . הערה על סרטון מופיעה בדף הצפייה של הסרטון. |
badRequest (400) |
commentTextRequired |
המשאב comment שאתם מוסיפים חייב לציין ערך עבור המאפיין snippet.topLevelComment.snippet.textOriginal . התגובות לא יכולות להיות ריקות. |
badRequest (400) |
commentTextTooLong |
המשאב comment שנוסף מכיל יותר מדי תווים במאפיין snippet.topLevelComment.snippet.textOriginal . |
badRequest (400) |
invalidCommentThreadMetadata |
המטא-נתונים של הבקשה לא חוקיים. |
badRequest (400) |
processingFailure |
שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי. כדי לוודא שהוא תקין, צריך לבדוק את המבנה של המשאב commentThread בגוף הבקשה. |
forbidden (403) |
forbidden |
יכול להיות שיצרת את שרשור התגובות כי אין לך הרשאות מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך. |
forbidden (403) |
ineligibleAccount |
חשבון YouTube שמשמש לאישור בקשת ה-API צריך להיות ממוזג עם חשבון Google של המשתמש כדי להוסיף שרשור תגובה או שרשור תגובות. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את הערוץ שציינת. יש לבדוק את הערך של המאפיין snippet.channelId כדי לוודא שהוא נכון. |
notFound (404) |
videoNotFound |
לא ניתן למצוא את הסרטון שציינת. יש לבדוק את הערך של המאפיין snippet.videoId כדי לוודא שהוא נכון. |
חברים
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של members
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
members.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
בערוץ של היוצר שמאשר את הבקשה לא מופעל מועדון החברים של הערוץ. |
badRequest (400) |
invalidMode |
ערך הפרמטר mode אינו חוקי.
השגיאה הזו יכולה להתרחש אם בפרמטר pageToken
מצוין אסימון שאוחזר באמצעות מצב שונה מזה שצוין. |
badRequest (400) |
invalidPageToken |
ערך הפרמטר pageToken
לא חוקי. השגיאה הזו מתרחשת אם פג התוקף של אסימון הדף שבו נעשה שימוש בבקשה. |
badRequest (400) |
invalidHasAccessToLevel |
ערך הפרמטר hasAccessToLevel
לא חוקי. אין רמה עם
id שצוין. |
badRequest (400) |
invalidFilterByMemberChannelId |
ערך הפרמטר filterByMemberChannelId
לא חוקי. השגיאה הזו מתקבלת אם
ערך הפרמטר filterByMemberChannelId
מציין יותר מ-100 ערוצים. |
membershipsLevels
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של members
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
membershipsLevels.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
בערוץ של היוצר שמאשר את הבקשה לא מופעל מועדון החברים של הערוץ. |
playlistItems
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של playlistItems
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
playlistItems.delete
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
הבקשה אינה מורשית כראוי למחוק את פריט הפלייליסט שצוין. |
notFound (404) |
playlistItemNotFound |
לא ניתן למצוא את הפריט בפלייליסט שזוהה בפרמטר id של הבקשה. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך ביכולת למחוק סרטונים מהפלייליסט שצוין. לדוגמה: אין אפשרות למחוק סרטון מהפלייליסט של הסרטונים שהעליתם. |
playlistItems.insert
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
duplicate |
videoAlreadyInPlaylist |
הסרטון שאתם מנסים להוסיף לפלייליסט כבר נמצא בפלייליסט. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
הפלייליסט כבר מכיל את מספר הפריטים המקסימלי. |
forbidden (403) |
playlistItemsNotAccessible |
הבקשה אינה מורשית כראוי להוסיף את פריט הפלייליסט שצוין. |
invalidValue (400) |
invalidContentDetails |
המאפיין contentDetails בבקשה לא חוקי. סיבה אפשרית לכך היא שהשדה contentDetails.note ארוך מ-280 תווים. |
invalidValue (400) |
invalidPlaylistItemPosition |
הבקשה מנסה להגדיר את מיקום הפריט בפלייליסט לערך לא חוקי או לא נתמך. צריך לבדוק את הערך של המאפיין position ב-snippet של המשאב. |
invalidValue (400) |
invalidResourceType |
הערך type שצוין עבור מזהה המשאב לא נתמך בפעולה הזו. מזהה המשאב מזהה את הפריט שרוצים להוסיף לפלייליסט – למשל youtube#video . |
invalidValue (400) |
manualSortRequired |
הבקשה מנסה להגדיר את מיקום הפריט בפלייליסט, אבל הפלייליסט לא כולל מיון ידני. (לדוגמה, פריטים בפלייליסט עשויים להיות ממוינים לפי תאריך או פופולריות). כדי לטפל בשגיאה, אפשר להסיר את הרכיב snippet.position מהמשאב שהבקשה מכניסה. אם רוצים שפריט הפלייליסט יקבל מיקום מסוים ברשימה, צריך קודם לעדכן את האפשרות סידור של הפלייליסט לידני בהגדרות הפלייליסט. אפשר לשנות את ההגדרות האלה במנהל הסרטונים של YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
הסרטון שאתם מנסים להוסיף לפלייליסט כבר נמצא בפלייליסט של סדרה אחרת. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך באפשרות להוסיף סרטונים לפלייליסט שצוין. לדוגמה: אי אפשר להוסיף סרטון לפלייליסט של הסרטונים שהעליתם. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה עם הפרמטר playlistId של הבקשה. |
notFound (404) |
videoNotFound |
הסרטון שניסית להוסיף לפלייליסט לא נמצא. יש לבדוק את הערך של המאפיין videoId כדי לוודא שהוא נכון. |
required (400) |
channelIdRequired |
הבקשה לא מציינת ערך למאפיין channelId הנדרש. |
required (400) |
playlistIdRequired |
הבקשה לא מציינת ערך למאפיין playlistId הנדרש. |
required (400) |
resourceIdRequired |
הבקשה חייבת להכיל משאב שבו האובייקט snippet מציין resourceId . |
playlistItems.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
לבקשה אין הרשאה מתאימה לאחזר את הפלייליסט שצוין. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה עם הפרמטר playlistId של הבקשה. |
notFound (404) |
videoNotFound |
לא ניתן למצוא את הסרטון שזוהה עם הפרמטר videoId של הבקשה. |
required (400) |
playlistIdRequired |
בקשת ההרשמה לא מציינת ערך למאפיין playlistId הנדרש. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך באפשרות ליצור רשימה של סרטונים בפלייליסט שצוין. לדוגמה: אי אפשר להוסיף סרטון לפלייליסט 'לצפייה בהמשך'. |
playlistItems.update
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
הבקשה אינה מורשית כראוי לעדכן את פריט הפלייליסט שצוין. |
invalidValue (400) |
invalidPlaylistItemPosition |
הבקשה מנסה להגדיר את מיקום הפריט בפלייליסט לערך לא חוקי או לא נתמך. צריך לבדוק את הערך של המאפיין position ב-snippet של המשאב. |
invalidValue (400) |
invalidResourceType |
הערך type שצוין עבור מזהה המשאב לא נתמך בפעולה הזו. מזהה המשאב מזהה את הפריט שרוצים להוסיף לפלייליסט – למשל youtube#video . |
invalidValue (400) |
invalidSnippet |
הבקשה לא מציינת מאפיין snippet חוקי. |
invalidValue (400) |
manualSortRequired |
הבקשה מנסה להגדיר את מיקום הפריט בפלייליסט, אבל הפלייליסט לא כולל מיון ידני. (לדוגמה, פריטים בפלייליסט עשויים להיות ממוינים לפי תאריך או פופולריות). כדי לטפל בשגיאה, אפשר להסיר את הרכיב snippet.position מהמשאב שהבקשה מכניסה. אם רוצים שפריט הפלייליסט יקבל מיקום מסוים ברשימה, צריך קודם לעדכן את האפשרות סידור של הפלייליסט לידני בהגדרות הפלייליסט. אפשר לשנות את ההגדרות האלה במנהל הסרטונים של YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך באפשרות לעדכן סרטונים בפלייליסט שצוין. לדוגמה, אי אפשר לעדכן סרטון בפלייליסט של הסרטונים שהעליתם. |
notFound (404) |
playlistItemNotFound |
לא ניתן למצוא את הפריט בפלייליסט שזוהה בנכס id של הבקשה. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה עם הפרמטר playlistId של הבקשה. |
required (400) |
channelIdRequired |
הבקשה לא מציינת ערך למאפיין channelId הנדרש. |
required (400) |
playlistIdRequired |
הבקשה לא מציינת ערך למאפיין playlistId הנדרש. |
required (400) |
playlistItemIdRequired |
משאב הפריט של הפלייליסט שצוין בבקשה חייב להשתמש במאפיין id כדי לזהות את הפריט בפלייליסט שמתעדכן. |
פלייליסטים
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של playlists
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
playlists.delete
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
playlistForbidden |
פעולה זו אסורה או שהבקשה אינה מורשית כראוי. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה עם הפרמטר id של הבקשה. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך באפשרות למחוק את הפלייליסט שצוין. לדוגמה: אי אפשר למחוק את הפלייליסט של הסרטונים שהעליתם. |
playlists.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
channelClosed |
הערוץ שצוין בפרמטר channelId נסגר. |
forbidden (403) |
channelSuspended |
הערוץ שצוין בפרמטר channelId הושעה. |
forbidden (403) |
playlistForbidden |
הפלייליסט שזוהה עם הפרמטר id של הבקשה לא תומך בבקשה, או שהבקשה לא מורשית כראוי. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את הערוץ שצוין בפרמטר channelId . |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה עם הפרמטר id של הבקשה. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך ביכולת ליצור רשימה של הפלייליסטים שצוינו. לדוגמה: אי אפשר להוסיף לרשימה את הפלייליסט לצפייה בהמשך. |
playlists.insert
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
צריך להגדיר את defaultLanguage כדי לעדכן את localizations . |
badRequest (400) |
localizationValidationError |
אחד הערכים באובייקט הלוקליזציה נכשל. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומקפידים לעדכן אותם לפי ההנחיות בתיעוד המשאבים של הפלייליסט. |
badRequest (400) |
maxPlaylistExceeded |
לא ניתן ליצור את הפלייליסט כי הערוץ כבר כולל את מספר הפלייליסטים המרבי המותר. |
forbidden (403) |
playlistForbidden |
פעולה זו אסורה או שהבקשה אינה מורשית כראוי. |
invalidValue (400) |
invalidPlaylistSnippet |
הבקשה מספקת קטע טקסט לא חוקי של פלייליסט. |
required (400) |
playlistTitleRequired |
הבקשה חייבת לציין כותרת לפלייליסט. |
playlists.update
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
צריך להגדיר את defaultLanguage כדי לעדכן את localizations . |
badRequest (400) |
localizationValidationError |
אחד הערכים באובייקט הלוקליזציה נכשל. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומקפידים לעדכן אותם לפי ההנחיות בתיעוד המשאבים של הפלייליסט. |
forbidden (403) |
playlistForbidden |
פעולה זו אסורה או שהבקשה אינה מורשית כראוי. |
invalidValue (400) |
invalidPlaylistSnippet |
הבקשה מספקת קטע טקסט לא חוקי של פלייליסט. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך באפשרות לעדכן את הפלייליסט שצוין. לדוגמה, אי אפשר לעדכן את המאפיינים של הפלייליסט של הסרטונים שהעליתם. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה עם הפרמטר id של הבקשה. |
required (400) |
playlistTitleRequired |
הבקשה חייבת לציין כותרת לפלייליסט. |
search
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של search
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
search.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
invalidChannelId |
הפרמטר channelId ציין מזהה ערוץ לא חוקי. |
badRequest (400) |
invalidLocation |
הפורמט של ערך הפרמטר location ו/או locationRadius שגוי. |
badRequest (400) |
invalidRelevanceLanguage |
הפורמט של ערך הפרמטר relevanceLanguage שגוי. |
badRequest (400) |
invalidSearchFilter |
הבקשה מכילה שילוב לא חוקי של מסנני חיפוש ו/או הגבלות חיפוש. צריך להגדיר את הפרמטר type לערך video אם מגדירים ערך לפרמטרים eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated או videoType . |
מנויים
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של subscriptions
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
subscriptions.delete
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
subscriptionForbidden |
הבקשה לא מאומתת כראוי או אינה נתמכת בערוץ הזה. |
notFound (404) |
subscriptionNotFound |
המינוי שניסית למחוק לא נמצא. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון. |
subscriptions.insert
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
subscriptionDuplicate |
המינוי שניסית ליצור כבר קיים. |
badRequest (400) |
subscriptionForbidden |
הגעת למספר המינויים המרבי. |
badRequest (400) |
subscriptionForbidden |
יותר מדי מינויים לאחרונה. יש לנסות שוב בעוד מספר שעות. |
badRequest (400) |
subscriptionForbidden |
אין תמיכה להירשם לערוץ שלך. |
forbidden (403) |
subscriptionForbidden |
הבקשה לא מאומתת כראוי או אינה נתמכת בערוץ הזה. |
notFound (404) |
publisherNotFound |
המשאב שצוין במאפיין snippet.resourceId של הבקשה לא נמצא. |
notFound (404) |
subscriberNotFound |
לא ניתן למצוא את המנוי שצוין בבקשה. |
required (400) |
publisherRequired |
משאב המינוי שצוין בבקשה חייב להשתמש במאפיין snippet.resourceId כדי לזהות את הערוץ שנרשמת אליו. |
subscriptions.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
accountClosed |
לא ניתן היה לאחזר את המינויים כי החשבון של המנוי סגור. |
forbidden (403) |
accountSuspended |
לא ניתן היה לאחזר את המינויים כי החשבון של המנוי מושעה. |
forbidden (403) |
subscriptionForbidden |
אין למגיש הבקשה גישה למינויים המבוקשים. |
notFound (404) |
subscriberNotFound |
לא ניתן למצוא את המנוי שצוין בבקשה. |
תמונות ממוזערות
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של thumbnails
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
thumbnails.set
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
invalidImage |
תוכן התמונה שסיפקת לא חוקי. |
badRequest (400) |
mediaBodyRequired |
הבקשה אינה כוללת את תוכן התמונה. |
forbidden (403) |
forbidden |
לא ניתן להגדיר את התמונה הממוזערת לסרטון שצוין. יכול להיות שהבקשה לא מורשית כמו שצריך. |
forbidden (403) |
forbidden |
למשתמש שאומת אין הרשאות להעלות סרטונים ולהגדיר להם תמונות ממוזערות מותאמות אישית. |
notFound (404) |
videoNotFound |
הסרטון שניסית להוסיף לו תמונה ממוזערת לא נמצא. צריך לבדוק את ערך הפרמטר videoId של הבקשה כדי לוודא שהוא נכון. |
tooManyRequests (429) |
uploadRateLimitExceeded |
הערוץ העלה יותר מדי תמונות ממוזערות לאחרונה. אפשר לנסות לשלוח את הבקשה שוב מאוחר יותר. |
videoAbuseReportReasons
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של videoAbuseReportReasons
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
videoAbuseReportReasons.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
forbidden |
הגישה אסורה. ייתכן שהבקשה לא מורשית כראוי. |
videoCategories
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של videoCategories
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
videoCategories.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
notFound (404) |
videoCategoryNotFound |
קטגוריית הסרטון שזוהתה על ידי הפרמטר id לא נמצאה. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר רשימה של ערכים חוקיים. |
סרטונים
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של videos
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
videos.insert
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
הבקשה מנסה להוסיף פרטי סרטון שמותאמים לשוק המקומי, בלי לציין את שפת ברירת המחדל של פרטי הסרטון. |
badRequest (400) |
invalidCategoryId |
המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר קטגוריות נתמכות. |
badRequest (400) |
invalidDescription |
המטא-נתונים של הבקשה מציינים תיאור סרטון לא חוקי. |
badRequest (400) |
invalidFilename |
שם הקובץ של הסרטון שצוין בכותרת Slug לא תקין. |
badRequest (400) |
invalidPublishAt |
המטא-נתונים של הבקשה מציינים זמן פרסום מתוזמן לא חוקי. |
badRequest (400) |
invalidRecordingDetails |
האובייקט recordingDetails במטא-נתונים של הבקשה מציין פרטי הקלטה לא חוקיים. |
badRequest (400) |
invalidTags |
המטא-נתונים של הבקשה מציינים מילות מפתח לא חוקיות בסרטון. |
badRequest (400) |
invalidTitle |
המטא-נתונים של הבקשה מציינים שם סרטון ריק או לא חוקי. |
badRequest (400) |
invalidVideoGameRating |
המטא-נתונים של הבקשה מציינים סיווג לא חוקי של משחק וידאו. |
badRequest (400) |
invalidVideoMetadata |
המטא-נתונים של הבקשה לא חוקיים. השגיאה הזו מתקבלת אם הבקשה מעדכנת את החלק snippet במשאב video , אבל לא מגדירה ערך לנכסים snippet.title ו-snippet.categoryId . |
badRequest (400) |
mediaBodyRequired |
הבקשה לא כוללת את תוכן הסרטון. |
badRequest (400) |
uploadLimitExceeded |
המשתמש חרג ממספר הסרטונים שהוא יכול להעלות. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
הבקשה מנסה להגדיר רישיון לא תקף לסרטון. |
forbidden (403) |
forbiddenPrivacySetting |
הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לסרטון. |
videos.list
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
videoChartNotFound |
תרשים הווידאו המבוקש לא נתמך או שאינו זמין. |
forbidden (403) |
forbidden |
לבקשה אין הרשאה מתאימה לגשת לקובץ הווידאו או למידע לעיבוד. החלקים fileDetails , processingDetails ו-suggestions זמינים רק לבעלים של הסרטון. |
forbidden (403) |
forbidden |
הבקשה לא יכולה לגשת למידע על דירוגי משתמשים. יכול להיות שהשגיאה הזו מתרחשת כי הבקשה לא מורשית להשתמש כראוי בפרמטר myRating . |
notFound (404) |
videoNotFound |
לא ניתן למצוא את הסרטון שאתם מנסים לאחזר. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון. |
videos.delete
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
forbidden |
לא ניתן למחוק את הסרטון שניסית למחוק. יכול להיות שהבקשה לא מורשית כמו שצריך. |
notFound (404) |
videoNotFound |
הסרטון שניסית למחוק לא נמצא. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון. |
videos.update
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
בקשת ה-API מנסה להוסיף פרטי סרטון שמותאמים לשוק המקומי בלי לציין את שפת ברירת המחדל של פרטי הסרטון. |
badRequest (400) |
invalidCategoryId |
המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר קטגוריות נתמכות. |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לשידור ברירת המחדל. |
badRequest (400) |
invalidDescription |
המטא-נתונים של הבקשה מציינים תיאור סרטון לא חוקי. |
badRequest (400) |
invalidPublishAt |
המטא-נתונים של הבקשה מציינים זמן פרסום מתוזמן לא חוקי. |
badRequest (400) |
invalidRecordingDetails |
האובייקט recordingDetails במטא-נתונים של הבקשה מציין פרטי הקלטה לא חוקיים. |
badRequest (400) |
invalidTags |
המטא-נתונים של הבקשה מציינים מילות מפתח לא חוקיות בסרטון. |
badRequest (400) |
invalidTitle |
המטא-נתונים של הבקשה מציינים שם סרטון ריק או לא חוקי. |
badRequest (400) |
invalidVideoMetadata |
המטא-נתונים של הבקשה לא חוקיים. השגיאה הזו מתקבלת אם הבקשה מעדכנת את החלק snippet במשאב video , אבל לא מגדירה ערך לנכסים snippet.title ו-snippet.categoryId . |
forbidden (403) |
forbidden |
הגישה אסורה. ייתכן שהבקשה לא מורשית כראוי. |
forbidden (403) |
forbiddenEmbedSetting |
הבקשה מנסה לקבוע הגדרת הטמעה לא חוקית לסרטון. ייתכן שלערוצים מסוימים אין הרשאה להציע נגנים מוטמעים לשידורים חיים. מידע נוסף זמין במרכז העזרה של YouTube. |
forbidden (403) |
forbiddenLicenseSetting |
הבקשה מנסה להגדיר רישיון לא תקף לסרטון. |
forbidden (403) |
forbiddenPrivacySetting |
הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לסרטון. |
notFound (404) |
videoNotFound |
הסרטון שניסית לעדכן לא נמצא. צריך לבדוק את הערך בשדה id בגוף הבקשה כדי לוודא שהוא נכון. |
videos.rate
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
emailNotVerified |
המשתמש צריך לאמת את כתובת האימייל שלו לפני הדירוג. |
badRequest (400) |
invalidRating |
הבקשה הכילה ערך לא צפוי לפרמטר rating . |
badRequest (400) |
videoPurchaseRequired |
סרטונים ששכרתם ניתנים לדירוג רק על ידי משתמשים ששכרו אותם. |
forbidden (403) |
forbidden |
לא ניתן לדרג את הסרטון שניסית לדרג. יכול להיות שהבקשה לא מורשית כמו שצריך. |
forbidden (403) |
videoRatingDisabled |
הבעלים של הסרטון שאתה מנסה לדרג השבית את הדירוגים של הסרטון הזה. |
notFound (404) |
videoNotFound |
לא ניתן למצוא את הסרטון שניסית לדרג. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון. |
videos.reportAbuse
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
invalidAbuseReason |
הבקשה הכילה ערך לא צפוי בשדה reason_id , או שילוב של השדות reason_id ו-secondary_reason_id . |
badRequest (400) |
rateLimitExceeded |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
לא מצאנו את הסרטון שעליו ניסית לדווח על שימוש לרעה. |
watermarks
בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של watermarks
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.
watermarks.set
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
badRequest (400) |
imageFormatUnsupported |
אין תמיכה בפורמט של התמונה שסיפקת. |
badRequest (400) |
imageTooTall |
התמונה שסיפקת גבוהה מדי. |
badRequest (400) |
imageTooWide |
התמונה שסיפקת רחבה מדי. |
badRequest (400) |
mediaBodyRequired |
הבקשה אינה כוללת את תוכן התמונה. |
forbidden (403) |
forbidden |
לא ניתן להגדיר את סימן המים בערוץ שצוין. יכול להיות שהבקשה לא מורשית כמו שצריך, או שהפרמטר channelId מוגדר לערך לא חוקי. |
watermarks.unset
סוג השגיאה | פרטי השגיאה | תיאור |
---|---|---|
forbidden (403) |
forbidden |
לא ניתן לבטל את הגדרת סימן המים בערוץ שצוין. יכול להיות שהבקשה לא מורשית כמו שצריך, או שהפרמטר channelId מוגדר לערך לא חוקי. |
comments
comments.markAsSpam
לא נתמכת יותר.בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של
comments
. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
ו-parentId
של הבקשה כדי לוודא שהם נכונים.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
רק אם ערך הפרמטרmoderationStatus
הואrejected
.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
של הבקשה כדי לוודא שהם נכונים.comments.insert
badRequest (400)
commentTextRequired
comment
שאתם מוסיפים חייב לציין ערך עבור המאפייןsnippet.textOriginal
. התגובות לא יכולות להיות ריקות.badRequest (400)
commentTextTooLong
comment
שנוסף מכיל יותר מדי תווים במאפייןsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
. במשאבcommentThread
, המאפייןsnippet.canReply
מציין אם הצופה הנוכחי יכול להשיב לשרשור.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
בגוף בקשת ה-API לא צוין ערך למאפייןsnippet.parentId
.badRequest (400)
processingFailure
comment
בגוף הבקשה.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
בגוף הבקשה כדי לוודא שהוא נכון.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
של הבקשה כדי לוודא שהוא נכון.comments.update
badRequest (400)
commentTextTooLong
comment
שמתעדכן מכיל יותר מדי תווים בנכסsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
בגוף הבקשה.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
בגוף הבקשה כדי לוודא שהוא נכון.