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 |
למשתמש ב-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 Service Account. YouTube לא תומך בחשבונות שירות, ואם תנסו לבצע אימות באמצעות חשבון שירות, תקבלו את השגיאה הזו.
בפוסט בבלוג בנושא YouTube API שבו מוצג התמיכה בחשבון Google, יש גם הסבר מפורט יותר על השגיאה youtubeSignupRequired . למרות שבפוסט בבלוג מוסברת השגיאה לגבי גרסה 2.1 של ה-API, המשמעות של השגיאה רלוונטית גם כאן. |
פעילויות
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-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 . |
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 |
לא נמצא מזהה הערוץ שצוין ב-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 |
במטא-נתונים של הבקשה צריך לציין כתובת אתר בחלק 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 |
אחד מהערכים באובייקט הלוקליזציות לא עבר אימות. כדי לאחזר ערכים תקינים, צריך להשתמש בשיטה 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 |
בבקשה צריך לציין שם לפלייליסט. |
חיפוש
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-API בתגובה לקריאות שקשורות למשאבי search
. יכול להיות שהשיטות האלה יחזירו שגיאות שמופיעות בקטע שגיאות נפוצות בבקשות.
search.list
סוג השגיאה |
פרטי השגיאה |
תיאור |
badRequest (400) |
invalidChannelId |
הפרמטר channelId ציין מזהה ערוץ לא תקין. |
badRequest (400) |
invalidLocation |
הפורמט של ערך הפרמטר location או locationRadius שגוי. |
badRequest (400) |
invalidRelevanceLanguage |
הפורמט של ערך הפרמטר relevanceLanguage שגוי. |
badRequest (400) |
invalidSearchFilter |
הבקשה מכילה שילוב לא תקין של מסנני חיפוש או הגבלות. אם מגדירים ערך לפרמטרים eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated או videoType , צריך להגדיר את הפרמטר type לערך video . |
מנויים
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-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-10-06 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-10-06 (שעון UTC)."],[],["API errors include `forbidden (403)` for access or quota issues, and `notFound (404)` for missing resources. `badRequest (400)` signals invalid parameters or missing data. `unauthorized (401)` means proper authorization is missing. Actions like `insert`, `update`, `delete`, `list` and `rate` are subject to errors, such as invalid input, authorization failures, or resource unavailability. Operations involving channels, captions, playlists, comments, videos, and subscriptions have specific error conditions, like duplicate entries or channel/video not found. Error descriptions often indicate necessary parameter corrections or authorization requirements.\n"]]
תגובות
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-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
בגוף הבקשה ומוודאים שהוא נכון.