YouTube Data API - Errors
במסמך הזה מפורטים הסוגים השונים של השגיאות שיכולות להופיע בפעולות 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 |
למשתמש במערכת ניהול התוכן אין הרשאה לפעול בשם בעלי התוכן שצוין. |
forbidden (403) |
insufficientCapabilities |
למשתמש במערכת ניהול התוכן אין מספיק יכולות. |
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 , אם הוא זמין ל-method שנקרא. |
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, המשמעות שלה עדיין רלוונטית. |
פעילויות
YouTube הפסיקה את השימוש בתכונה 'עדכוני ערוץ'. אין יותר תמיכה בשיטה
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 אבל לא אושרה כראוי. |
כתוביות
בטבלאות הבאות מפורטות הודעות השגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים מסוג captions
. השיטות האלה עשויות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשות.
captions.delete
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
forbidden |
ההרשאות שמשויכות לבקשה לא מספיקות כדי למחוק את הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי. |
notFound (404) |
captionNotFound |
רצועת הכתוביות לא נמצאה. צריך לבדוק את הערך של הפרמטר id בבקשה כדי לוודא שהוא נכון. |
captions.download
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
forbidden |
ההרשאות שמשויכות לבקשה לא מספיקות כדי להוריד את הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי. |
invalidValue (400) |
couldNotConvert |
לא ניתן היה להמיר את נתוני הטראק של הכתוביות לשפה ו/או לפורמט המבוקשים. מוודאים שהערכים המבוקשים של tfmt ו-tlang תקינים, ושהערך snippet.status של טראק הכתוביות המבוקש הוא לא failed . |
notFound (404) |
captionNotFound |
רצועת הכתוביות לא נמצאה. צריך לבדוק את הערך של הפרמטר id בבקשה כדי לוודא שהוא נכון. |
captions.insert
סוג השגיאה |
פרטי השגיאה |
תיאור |
badRequest (400) |
contentRequired |
הבקשה לא מכילה את התוכן של טראק הכתוביות. |
conflict (409) |
captionExists |
כבר יש לסרטון שצוין רצועת כתוביות עם snippet.language ו-snippet.name שצוינו. אפשר להוסיף לסרטון כמה רצועות של כתוביות באותה שפה, אבל לכל רצועה צריך להיות שם שונה.
יש כמה דרכים לתקן את השגיאה. אפשר למחוק את הטראק הקיים ולהוסיף טראק חדש, או לשנות את השם של הטראק החדש לפני שמוסיפים אותו. |
forbidden (403) |
forbidden |
ההרשאות שמשויכות לבקשה לא מספיקות כדי להעלות את הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי. |
invalidValue (400) |
invalidMetadata |
הבקשה מכילה ערכים לא חוקיים של מטא-נתונים, שמונעים את יצירת הטראק. מוודאים שהבקשה מציינת ערכים תקינים למאפיינים snippet.language , snippet.name ו-snippet.videoId . אפשר לכלול גם את המאפיין snippet.isDraft , אבל הוא לא נדרש. |
notFound (404) |
videoNotFound |
לא נמצא הסרטון שזוהה באמצעות הפרמטר videoId . |
invalidValue (400) |
nameTooLong |
השדה snippet.name שצוין בבקשה ארוך מדי. האורך המקסימלי הנתמך הוא 150 תווים. |
captions.list
סוג השגיאה |
פרטי השגיאה |
תיאור |
forbidden (403) |
forbidden |
לא ניתן היה לאחזר טראק כתוביות אחד או יותר כי ההרשאות שמשויכות לבקשה לא מספיקות לאחזור המשאבים המבוקשים. יכול להיות שהבקשה לא אושרה כראוי. |
notFound (404) |
captionNotFound |
לא הצלחנו למצוא אחד או יותר מהטראקים של הכתוביות שצוינו. השגיאה הזו מתרחשת אם הפרמטר videoId מזהה סרטון בפועל, אבל הפרמטר id מזהה מזהי רצועות כתוביות שלא קיימים או מזהי טראקים שמשויכים לסרטונים אחרים. בודקים את הערכים של הפרמטרים id ו-videoId בבקשה כדי לוודא שהם נכונים. |
notFound (404) |
videoNotFound |
לא נמצא הסרטון שזוהה באמצעות הפרמטר videoId . |
captions.update
סוג השגיאה |
פרטי השגיאה |
תיאור |
badRequest (400) |
contentRequired |
בבקשה לא הועלה קובץ כתוביות מעודכן. תוכן הטראק בפועל נדרש אם הפרמטר sync מוגדר כ-true . |
forbidden (403) |
forbidden |
ההרשאות שמשויכות לבקשה לא מספיקות לעדכון הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי. |
notFound (404) |
captionNotFound |
לא ניתן למצוא את רצועת הכתוביות שצוינה. צריך לבדוק את הערך של הפרמטר id בבקשה כדי לוודא שהוא נכון. |
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 |
כדי להוסיף או לעדכן את האובייקט localizations של המשאב הזה, צריך להגדיר את המאפיין snippet.defaultLanguage של המשאב channelSection . |
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 |
כדי להוסיף או לעדכן את האובייקט localizations של המשאב הזה, צריך להגדיר את המאפיין snippet.defaultLanguage של המשאב channelSection . |
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 נכשל בתהליך האימות. משתמשים ב-method 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 |
אחד מהערכים באובייקט localizations נכשל באימות. משתמשים בשיטה channels.list כדי לאחזר ערכים חוקיים, ומוודאים לעדכן אותם בהתאם להנחיות שמפורטות במסמכי העזרה של משאב הערוצים. |
badRequest (400) |
tooManyPromotedItems |
חרגת ממספר הפריטים המקודמים המותר בקטע invideoPromotion. |
forbidden (403) |
channelForbidden |
הערוץ שצוין בפרמטר id לא תומך בבקשה או שהבקשה לא אושרה כראוי. |
forbidden (403) |
promotedVideoNotAllowed |
לא ניתן למצוא את הערוץ שרוצים לעדכן באמצעות בקשת ה-API. בודקים את הערך של המאפיין id במשאב channel שאליו נשלחה הבקשה, כדי לוודא שמזהה הערוץ נכון. |
forbidden (403) |
websiteLinkNotAllowed |
כתובת ה-URL של האתר שצוינה לא מותרת. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את הערוץ שצוין באמצעות הפרמטר id או שאין לו אפשרויות מיתוג. |
notFound (404) |
channelNotFound |
לא ניתן למצוא את הערוץ שצוין בפרמטר id . |
notFound (404) |
unknownChannelId |
מזהה הערוץ שצוין לא נמצא. |
notFound (404) |
unknownChannelId |
לא נמצא מזהה הערוץ שצוין ב-recentlyUploadedBy. |
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 |
המטא-נתונים של הבקשה חייבים לציין כתובת URL של אתר בקטע invideoPromotion. מגדירים את הערך של המאפיין invideoPromotion.items[].id.websiteUrl במשאב שאליו נשלחת הבקשה. |
חברים
בטבלאות הבאות מפורטות הודעות השגיאה שה-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 |
אחד מהערכים באובייקט localizations נכשל באימות. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומוודאים לעדכן אותם בהתאם להנחיות שמפורטות במסמכי העזרה של משאב הפלייליסטים. |
badRequest (400) |
maxPlaylistExceeded |
לא ניתן ליצור את הפלייליסט כי הערוצים כבר מכיל את המספר המקסימלי של פלייליסטים. |
forbidden (403) |
playlistForbidden |
הפעולה אסורה או שהבקשה לא אושרה כראוי. |
invalidValue (400) |
invalidPlaylistSnippet |
הבקשה כוללת קטע פלייליסט לא חוקי. |
required (400) |
playlistTitleRequired |
בבקשה צריך לציין שם של פלייליסט. |
playlists.update
סוג השגיאה |
פרטי השגיאה |
תיאור |
badRequest (400) |
defaultLanguageNotSetError |
צריך להגדיר את defaultLanguage כך שיעדכן את localizations . |
badRequest (400) |
localizationValidationError |
אחד מהערכים באובייקט localizations נכשל באימות. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומוודאים לעדכן אותם בהתאם להנחיות שמפורטות במסמכי העזרה של משאב הפלייליסטים. |
forbidden (403) |
playlistForbidden |
הפעולה אסורה או שהבקשה לא אושרה כראוי. |
invalidValue (400) |
invalidPlaylistSnippet |
הבקשה כוללת קטע פלייליסט לא חוקי. |
invalidValue (400) |
playlistOperationUnsupported |
ה-API לא תומך באפשרות לעדכן את הפלייליסט שצוין. לדוגמה, אי אפשר לעדכן את המאפיינים של פלייליסט הסרטונים שהועלו. |
notFound (404) |
playlistNotFound |
לא ניתן למצוא את הפלייליסט שזוהה באמצעות הפרמטר id של הבקשה. |
required (400) |
playlistTitleRequired |
בבקשה צריך לציין שם של פלייליסט. |
חיפוש
בטבלאות הבאות מפורטות הודעות השגיאה שה-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 |
לא הצלחנו למצוא את הסרטון שעליו ניסית לדווח על שימוש לרעה. |
סימני מים
בטבלאות הבאות מפורטות הודעות השגיאה שה-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 מוגדר לערך לא חוקי. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-02-06 (שעון UTC).
[null,null,["עדכון אחרון: 2025-02-06 (שעון UTC)."],[[["The YouTube Data API commonly returns errors such as `forbidden (403)` for authorization issues, `badRequest (400)` for invalid requests, and `notFound (404)` for missing resources."],["Specific API methods like `activities`, `captions`, `channelBanners`, `channelSections`, `playlists`, and `videos` have unique error conditions, including missing parameters, content issues, and permission constraints."],["Errors related to channel management, such as creating, deleting, listing, or updating channel sections or playlists, often involve issues with invalid IDs, missing required fields, exceeding limits, or conflicting configurations."],["Comment and comment thread errors can arise from insufficient permissions, disabled commenting, character limits, private comments, or attempting to reply to non-existent parent comments."],["Errors related to video operations may include problems with category IDs, descriptions, titles, privacy settings, invalid licensing, missing content, exceeding upload limits, and improper reporting of abuse."]]],[]]
תגובות
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
בגוף הבקשה כדי לוודא שהוא נכון.