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 משתמש ה-CMS אינו מורשה לפעול בשם בעלי התוכן שצוינו.
forbidden (403) insufficientCapabilities למשתמש ה-CMS אין יכולות מספיקות.
forbidden (403) insufficientPermissions אסימון OAuth 2.0 שסופק עבור הבקשה מציין היקפים שאינם מספיקים כדי לגשת לנתונים המבוקשים.
notFound (404) contentOwnerAccountNotFound החשבון של בעלי התוכן שצוין לא נמצא.

Request context errors

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) invalidLanguage ערך הפרמטר hl לא מציין קוד שפה חוקי.
badRequest (400) invalidMine השימוש של הבקשה בפרמטר mine אינו נתמך.
badRequest (400) invalidMine לא ניתן להשתמש בפרמטר mine בבקשות שבהן המשתמש המאומת הוא שותף YouTube. עליך להסיר את הפרמטר mine, לבצע אימות כמשתמש YouTube על ידי הסרת הפרמטר onBehalfOfContentOwner, או לפעול כאחד מערוצי השותף ולספק את הפרמטר onBehalfOfContentOwnerChannel אם הוא זמין לשיטה שנקראת.
badRequest (400) invalidPart הפרמטר part של הבקשה מציין חלקים מסוימים שאי אפשר לכתוב בו-זמנית.
badRequest (400) invalidRegionCode הפרמטר regionCode מציין קוד אזור לא חוקי.
badRequest (400) unexpectedPart הפרמטר part של הבקשה מציין ערך בלתי צפוי.
badRequest (400) unknownPart הפרמטר part של הבקשה מציין ערך לא ידוע.
badRequest (400) unsupportedLanguageCode ערך הפרמטר hl לא מציין קוד שפה נתמך.
badRequest (400) unsupportedRegionCode הפרמטר regionCode מציין קוד אזור שאינו נתמך.
unauthorized (401) authorizationRequired הבקשה משתמשת בפרמטר mine אבל אין לה הרשאה כראוי.
unauthorized (401) youtubeSignupRequired משמעות השגיאה הזו היא שלמשתמש יש חשבון Google לא מקושר, כלומר, למשתמש יש חשבון Google אבל אין לו ערוץ YouTube. למשתמשים כאלה יש גישה לתכונות רבות שתלויות באישור המשתמשים, כמו דירוג סרטונים או הוספת סרטונים לפלייליסט watch_later. עם זאת, לדוגמה, המשתמש צריך ערוץ YouTube כדי להעלות סרטון. למשתמש עם חשבון Gmail או מכשיר Android בטוח יש חשבון Google, אבל יכול להיות שהוא לא קישר כבר את חשבון Google הזה לערוץ YouTube.

השגיאה הזאת נפוצה מאוד כשמנסים להשתמש בתהליך של חשבון שירות OAuth 2.0. YouTube לא תומך בחשבונות שירות, ואם תנסה לבצע אימות באמצעות חשבון שירות תקבל את הודעת השגיאה הזו.

פוסט בבלוג של YouTube API שכולל תמיכה בחשבונות Google כולל הסבר מפורט יותר על השגיאה youtubeSignupRequired. למרות שהפוסט בבלוג מסביר את השגיאה עבור גרסה 2.1 של ה-API, משמעות השגיאה עדיין רלוונטית.

פעילויות

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 צריך להגדיר את המאפיין snippet.defaultLanguage של המשאב channelSection כדי להוסיף או לעדכן את האובייקט localizations של המשאב הזה.
badRequest (400) invalidLanguage אחד ממפתחות השפה של האובייקט localizations נכשל. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) notEditable לא ניתן ליצור את הקטע הזה בערוץ.
badRequest (400) styleRequired המשאב channelSection חייב לציין ערך עבור השדה snippet.style.
badRequest (400) targetInvalidCountry אחד מהערכים ברשימה targeting.countries נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) targetInvalidLanguage אחד מהערכים ברשימה targeting.languages נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) targetInvalidRegion אחד מהערכים ברשימה targeting.regions נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) typeRequired המשאב channelSection חייב לציין ערך עבור השדה snippet.type.
forbidden (403) channelSectionForbidden הבקשה לא מאומתת כראוי או שאינה נתמכת בערוץ הזה.
invalidValue (400) channelNotActive לפחות אחד מהערוצים שצוינו אינו פעיל.
invalidValue (400) channelsDuplicated הבקשה נכשלה כי צוינו ערוצים כפולים.
invalidValue (400) channelsNeeded אם למאפיין snippet.type יש ערך של multipleChannels, צריך לציין את המאפיין contentDetails.channels[] ולציין לפחות ערוץ אחד.
invalidValue (400) channelsNotExpected במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.channels[], אבל לא צפויים ערוצים עבור סוג הערוץ הזה.
invalidValue (400) contentDetailsNeeded המשאב שברצונך להוסיף חייב להכיל אובייקט contentDetails עבור סוג הערוץ הזה.
invalidValue (400) inValidPosition המאפיין snippet.position מכיל ערך לא חוקי.
invalidValue (400) maxChannelSectionExceeded לא ניתן להשלים את הבקשה כי בערוץ כבר יש את המספר המקסימלי של אוספים בערוץ.
invalidValue (400) maxChannelsExceeded הבקשה נכשלה כי ניסתה לכלול יותר מדי ערוצים בקטע הערוצים.
invalidValue (400) maxPlaylistExceeded הבקשה נכשלה כי ניסתה לכלול יותר מדי פלייליסטים בקטע הערוץ.
invalidValue (400) onePlaylistNeeded אם למאפיין snippet.type יש את הערך singlePlaylist, המאפיין contentDetails.playlists[] צריך לציין פלייליסט אחד בדיוק.
invalidValue (400) ownChannelInChannels לא ניתן לכלול את הערוץ שלכם בקטע שמופיע בערוץ הזה בערוץ.
invalidValue (400) playlistIsPrivate אחד או יותר מהפלייליסטים שצוינו הם פרטיים, ולכן לא ניתן לכלול אותם בקטע הערוץ.
invalidValue (400) playlistsDuplicated הבקשה נכשלה כי צוינו פלייליסטים כפולים.
invalidValue (400) playlistsNeeded אם למאפיין snippet.type יש ערך של singlePlaylist או multiplePlaylists, צריך לציין את המאפיין contentDetails.playlists[].
invalidValue (400) playlistsNotExpected במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.playlists[], אבל לא צריך להשתמש בפלייליסטים בקטעים מהסוג הזה בערוצים.
invalidValue (400) snippetNeeded יש לציין snippet כדי ליצור את הקטע בערוץ.
invalidValue (400) titleLengthExceeded הערך של המאפיין snippet.title ארוך מדי.
invalidValue (400) titleRequired אם למאפיין snippet.type יש ערך של multiplePlaylists או multipleChannels, צריך לציין ערך עבור המאפיין snippet.title כדי להגדיר את כותרת הקטע.
notFound (404) channelNotFound לא ניתן למצוא אחד או יותר מהערוצים שצוינו.
notFound (404) playlistNotFound לא ניתן למצוא אחד או יותר מהפלייליסטים שצוינו.

channelSections.list

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) channelSectionForbidden למגיש הבקשה אין הרשאה לגשת לקטעי הערוץ המבוקשים.
invalidValue (400) idInvalid הבקשה מציינת מזהה לא חוקי של קטע בערוץ.
invalidValue (400) invalidCriteria לא ניתן היה להשלים את הבקשה כי הקריטריונים לסינון אינם חוקיים.
notFound (404) channelNotFound לא ניתן למצוא את הערוץ המשויך לבקשה.
notFound (404) channelSectionNotFound קטע הערוץ המשויך לבקשה לא נמצא.

channelSections.update

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSetError צריך להגדיר את המאפיין snippet.defaultLanguage של המשאב channelSection כדי להוסיף או לעדכן את האובייקט localizations של המשאב הזה.
badRequest (400) invalidLanguage אחד ממפתחות השפה של האובייקט localizations נכשל. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) notEditable לא ניתן לערוך את קטע הערוץ הזה.
badRequest (400) styleRequired המשאב channelSection חייב לציין ערך עבור השדה snippet.style.
badRequest (400) targetInvalidCountry אחד מהערכים ברשימה targeting.countries נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) targetInvalidLanguage אחד מהערכים ברשימה targeting.languages נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) targetInvalidRegion אחד מהערכים ברשימה targeting.regions נכשל באימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של a href="/https/developers.google.com/youtube/v3/docs/channelSections#resource">channelSections בנושא המשאבים.
badRequest (400) typeRequired המשאב channelSection חייב לציין ערך עבור השדה snippet.type.
forbidden (403) channelSectionForbidden הבקשה לא מאומתת כראוי או שאינה נתמכת בערוץ הזה.
invalidValue (400) channelNotActive לפחות אחד מהערוצים שצוינו אינו פעיל.
invalidValue (400) channelsDuplicated הבקשה נכשלה כי צוינו ערוצים כפולים.
invalidValue (400) channelsNeeded אם למאפיין snippet.type יש ערך של multipleChannels, צריך לציין את המאפיין contentDetails.channels[] ולציין לפחות ערוץ אחד.
invalidValue (400) channelsNotExpected במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.channels[], אבל לא צפויים ערוצים עבור סוג הערוץ הזה.
invalidValue (400) contentDetailsNeeded המשאב שברצונך לעדכן חייב להכיל אובייקט contentDetails עבור סוג הערוץ הזה.
invalidValue (400) idInvalid המאפיין id מציין מזהה קטע לא חוקי בערוץ.
invalidValue (400) idRequired המאפיין id חייב לציין ערך שמזהה את קטע הערוץ שמתעדכן.
invalidValue (400) inValidPosition המאפיין snippet.position מכיל ערך לא חוקי.
invalidValue (400) maxChannelsExceeded הבקשה נכשלה כי ניסתה לכלול יותר מדי ערוצים בקטע הערוצים.
invalidValue (400) maxPlaylistExceeded הבקשה נכשלה כי ניסתה לכלול יותר מדי פלייליסטים בקטע הערוץ.
invalidValue (400) onePlaylistNeeded אם למאפיין snippet.type יש את הערך singlePlaylist, המאפיין contentDetails.playlists[] צריך לציין פלייליסט אחד בדיוק.
invalidValue (400) ownChannelInChannels לא ניתן לכלול את הערוץ שלכם בקטע שמופיע בערוץ הזה בערוץ.
invalidValue (400) playlistIsPrivate אחד או יותר מהפלייליסטים שצוינו הם פרטיים, ולכן לא ניתן לכלול אותם בקטע הערוץ.
invalidValue (400) playlistsDuplicated הבקשה נכשלה כי צוינו פלייליסטים כפולים.
invalidValue (400) playlistsNeeded אם למאפיין snippet.type יש ערך של singlePlaylist או multiplePlaylists, צריך לציין את המאפיין contentDetails.playlists[].
invalidValue (400) playlistsNotExpected במשאב שסופק עם הבקשה צוין ערך למאפיין contentDetails.playlists[], אבל לא צריך להשתמש בפלייליסטים בקטעים מהסוג הזה בערוצים.
invalidValue (400) snippetNeeded עליך לציין snippet כדי לעדכן את קטע הערוץ.
invalidValue (400) titleLengthExceeded הערך של המאפיין snippet.title ארוך מדי.
invalidValue (400) titleRequired אם למאפיין snippet.type יש ערך של multiplePlaylists או multipleChannels, צריך לציין ערך עבור המאפיין snippet.title כדי להגדיר את כותרת הקטע.
notFound (404) channelNotFound לא ניתן למצוא אחד או יותר מהערוצים שצוינו.
notFound (404) channelSectionNotFound קטע הערוץ שניסית לעדכן לא נמצא.
notFound (404) playlistNotFound לא ניתן למצוא אחד או יותר מהפלייליסטים שצוינו.

ערוצים

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של channels. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

channels.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) invalidCriteria אפשר לציין עד אחד מהמסננים הבאים:id, mySubscribers, categoryId, mine, managedByMe, forUsername. במקרה של אימות בעלי התוכן באמצעות הפרמטר onBehalfOfContentOwner, ניתן לציין רק את id או managedByMe.
forbidden (403) channelForbidden הערוץ שצוין בפרמטר id לא תומך בבקשה או שהבקשה לא מורשית כראוי.
notFound (404) categoryNotFound הקטגוריה שזוהתה על ידי הפרמטר categoryId לא נמצאה. אפשר להשתמש בשיטה guideCategories.list כדי לאחזר רשימה של ערכים חוקיים.
notFound (404) channelNotFound לא ניתן למצוא את הערוץ שצוין בפרמטר id.

channels.update

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) brandingValidationError אחד מהערכים באובייקט brandingSettings נכשל באימות. אפשר להשתמש בשיטה channels.list כדי לאחזר את ההגדרות הקיימות של הערוץ, ולעדכן את ערכי המאפיינים בהתאם להנחיות במסמכי התיעוד בנושא המשאבים של channels.
badRequest (400) channelTitleUpdateForbidden כשמעדכנים את brandingSettings part של ערוץ, צריך להגדיר את ערך המאפיין brandingSettings.channel.title לשם הערוץ הנוכחי או להשמיט את המאפיין. ה-API מחזיר שגיאה אם משנים את הערך של הנכס.
badRequest (400) defaultLanguageNotSetError צריך להגדיר את defaultLanguage כדי לעדכן את localizations.
badRequest (400) invalidBrandingOption אחת מהגדרות המיתוג שציינת לא קיימת. צריך להשתמש בשיטה channels.list כדי לאחזר ערכים חוקיים, וחשוב לעדכן אותם בהתאם להנחיות במסמכי התיעוד של מקורות המידע של channels.
badRequest (400) invalidCustomMessage המטא-נתונים של הבקשה מציינים הודעה מותאמת אישית לא חוקית. צריך לבדוק את הערך של המאפיין invideoPromotion.items[].customMessage במשאב שהבקשה שלחה.
badRequest (400) invalidDuration המטא-נתונים של הבקשה מציינים משך זמן לא חוקי בחלק invideoPromotion.
badRequest (400) invalidDuration המטא-נתונים של הבקשה מציינים סוג מיקום לא חוקי שמאפשר לקבוע את המיקום של הפריט המקודם בנגן הווידאו. צריך לבדוק את הערך של המאפיין invideoPromotion.position.type במשאב שהבקשה שלחה.
badRequest (400) invalidRecentlyUploadedBy המטא-נתונים של הבקשה מציינים מזהה ערוץ לא חוקי. צריך לבדוק את הערך של המאפיין invideoPromotion.items[].id.recentlyUploadedBy במשאב שהבקשה שלחה.
badRequest (400) invalidTimingOffset המטא-נתונים של הבקשה מציינים קיזוז תזמון לא חוקי בחלק invideoPromotion.
badRequest (400) invalidTimingOffset המטא-נתונים של הבקשה מציינים קיזוז תזמון לא חוקי שמאפשר לקבוע מתי יש להציג את הפריט המקודם בנגן הווידאו. צריך לבדוק את הערך של המאפיין invideoPromotion.timing.offsetMs במשאב שהבקשה שלחה.
badRequest (400) invalidTimingType המטא-נתונים של הבקשה מציינים שיטת תזמון לא חוקית שמאפשרת לקבוע מתי יש להציג את הפריט המקודם בנגן הווידאו. צריך לבדוק את הערך של המאפיין invideoPromotion.timing.type במשאב שהבקשה שלחה.
badRequest (400) localizationValidationError אחד הערכים באובייקט הלוקליזציה נכשל. אפשר להשתמש בשיטה channels.list כדי לאחזר ערכים חוקיים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד בנושא מקורות של ערוצים.
badRequest (400) tooManyPromotedItems חריגה ממספר הפריטים המקודמים המותרים בחלק invideoPromotion.
forbidden (403) channelForbidden הערוץ שצוין בפרמטר id לא תומך בבקשה או שהבקשה לא מורשית כראוי.
forbidden (403) promotedVideoNotAllowed לא ניתן למצוא את הערוץ שבקשת ה-API מנסה לעדכן. צריך לבדוק את הערך של המאפיין id במשאב channel שנשלחה בבקשה כדי לוודא שמזהה הערוץ נכון.
forbidden (403) websiteLinkNotAllowed כתובת האתר שצוינה אינה מותרת.
notFound (404) channelNotFound הערוץ שצוין באמצעות הפרמטר id לא נמצא או שאין בו אפשרויות מיתוג.
notFound (404) channelNotFound לא ניתן למצוא את הערוץ שצוין בפרמטר id.
notFound (404) unknownChannelId לא נמצא מזהה הערוץ שצוין.
notFound (404) unknownChannelId מזהה הערוץ שצוין לאחרונה UploadedBy לא נמצא.
notFound (404) unknownVideoId מזהה הווידאו שצוין כפריט מקודם לא נמצא.
required (400) requiredItemIdType במטא-נתונים של הבקשה צריך לציין סוג פריט בחלק invideoPromotion.
required (400) requiredItemId במטא-נתונים של הבקשה צריך לציין פריט בחלק invideoPromotion.
required (400) requiredTimingOffset המטא-נתונים של הבקשה צריכים לציין קיזוז תזמון שמוגדר כברירת מחדל, כדי שהמערכת של YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.offsetMs במשאב שהבקשה שולחת.
required (400) requiredTimingOffset המטא-נתונים של הבקשה צריכים לציין קיזוז תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.offsetMs במשאב שהבקשה שולחת.
required (400) requiredTimingType המטא-נתונים של הבקשה צריכים לציין שיטת תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.type במשאב שהבקשה שולחת.
required (400) requiredTimingType המטא-נתונים של הבקשה צריכים לציין שיטת תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.type במשאב שהבקשה שולחת.
required (400) requiredTiming המטא-נתונים של הבקשה צריכים לציין תזמון לכל פריט בחלק invideoPromotion.
required (400) requiredVideoId המטא-נתונים של הבקשה צריכים לכלול מזהה וידאו שישמש לזיהוי הפריט המקודם.
required (400) requiredWebsiteUrl המטא-נתונים של הבקשה חייבים לציין כתובת אתר בקטע invideoPromotion. מגדירים את הערך של המאפיין invideoPromotion.items[].id.websiteUrl במשאב שהבקשה שולחת.

commentThreads

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של commentThreads. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

commentThreads.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) operationNotSupported בקשת ה-API לא תקינה או שנוצרה באופן שגוי, וכתוצאה מכך שרת ה-API לא הבין את הבקשה.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי. כדי לוודא שהוא תקין, צריך לבדוק את המבנה של המשאב commentThread בגוף הבקשה.
forbidden (403) commentsDisabled בסרטון שזוהה באמצעות הפרמטר videoId הושבתו תגובות.
forbidden (403) forbidden לא ניתן לאחזר אחד או יותר משרשורי התגובות המבוקשים עקב הרשאות לא מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך.
notFound (404) channelNotFound הערוץ שזוהה על ידי הפרמטר allThreadsRelatedToChannelId לא נמצא.
notFound (404) commentThreadNotFound לא ניתן למצוא אחד או יותר משרשורי התגובות שצוינו. צריך לבדוק את ערכי הפרמטר id של הבקשה כדי לוודא שהם נכונים.
notFound (404) videoNotFound הסרטון שזוהה על ידי הפרמטר videoId לא נמצא.

commentThreads.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) channelOrVideoIdMissing כל שרשור תגובות צריך להיות מקושר לערוץ או לסרטון. צריך לוודא שהמשאב מציין ערכים למאפיין snippet.channelId וגם למאפיין snippet.videoId. הערה על סרטון מופיעה בדף הצפייה של הסרטון.
badRequest (400) commentTextRequired המשאב comment שאתם מוסיפים חייב לציין ערך עבור המאפיין snippet.topLevelComment.snippet.textOriginal. התגובות לא יכולות להיות ריקות.
badRequest (400) commentTextTooLong המשאב comment שנוסף מכיל יותר מדי תווים במאפיין snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata המטא-נתונים של הבקשה לא חוקיים.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי. כדי לוודא שהוא תקין, צריך לבדוק את המבנה של המשאב commentThread בגוף הבקשה.
forbidden (403) forbidden יכול להיות שיצרת את שרשור התגובות כי אין לך הרשאות מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך.
forbidden (403) ineligibleAccount חשבון YouTube שמשמש לאישור בקשת ה-API צריך להיות ממוזג עם חשבון Google של המשתמש כדי להוסיף שרשור תגובה או שרשור תגובות.
notFound (404) channelNotFound לא ניתן למצוא את הערוץ שציינת. יש לבדוק את הערך של המאפיין snippet.channelId כדי לוודא שהוא נכון.
notFound (404) videoNotFound לא ניתן למצוא את הסרטון שציינת. יש לבדוק את הערך של המאפיין snippet.videoId כדי לוודא שהוא נכון.

comments

השיטה comments.markAsSpam לא נתמכת יותר.

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של comments. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

comments.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) operationNotSupported בקשת ה-API לא תקינה או שנוצרה באופן שגוי, וכתוצאה מכך שרת ה-API לא הבין את הבקשה.
forbidden (403) forbidden לא ניתן לאחזר אחת או יותר מהתגובות המבוקשות עקב הרשאות לא מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך.
notFound (404) commentNotFound לא ניתן למצוא אחת או יותר מהתגובות שצוינו. צריך לבדוק את ערכי הפרמטרים id ו-parentId של הבקשה כדי לוודא שהם נכונים.

comments.setModerationStatus

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) banWithoutReject אפשר להשתמש בפרמטר banAuthor רק אם ערך הפרמטר moderationStatus הוא rejected.
badRequest (400) operationNotSupported בקשת ה-API לא תקינה או שנוצרה באופן שגוי, וכתוצאה מכך שרת ה-API לא הבין את הבקשה.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי.
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 משתמש ה-API לא יכול להוסיף תגובה בתגובה לתגובה ברמה העליונה שזוהתה על ידי נכס snippet.parentId. במשאב commentThread, המאפיין snippet.canReply מציין אם הצופה הנוכחי יכול להשיב לשרשור.
badRequest (400) parentCommentIsPrivate תגובת ההורה שצוינה מוגדרת כפרטית. ה-API לא תומך בתשובות לתגובות פרטיות.
badRequest (400) parentIdMissing התגובה שאתם מוסיפים חייבת להיות מקושרת לתגובה של הורה. עם זאת, במשאב comment בגוף בקשת ה-API לא צוין ערך למאפיין snippet.parentId.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי. כדי לוודא שהוא תקין, צריך לבדוק את המבנה של המשאב comment בגוף הבקשה.
forbidden (403) forbidden אי אפשר ליצור את התגובה כי אין לך הרשאות מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך.
forbidden (403) ineligibleAccount חשבון YouTube שמשמש לאישור בקשת ה-API צריך להיות ממוזג עם חשבון Google של המשתמש כדי להוסיף שרשור תגובה או שרשור תגובות.
notFound (404) parentCommentNotFound לא ניתן היה למצוא את תגובת ההורה שצוינה. יש לבדוק את הערך של המאפיין snippet.parentId בגוף הבקשה כדי לוודא שהוא נכון.

comments.delete

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי.
forbidden (403) forbidden לא ניתן למחוק את התגובה בגלל הרשאות לא מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך.
notFound (404) commentNotFound לא ניתן היה למצוא את התגובה שציינת. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון.

comments.update

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) commentTextTooLong המשאב comment שמתעדכן מכיל יותר מדי תווים בנכס snippet.textOriginal.
badRequest (400) invalidCommentMetadata המטא-נתונים של הבקשה לא חוקיים.
badRequest (400) operationNotSupported בקשת ה-API לא תקינה או שנוצרה באופן שגוי, וכתוצאה מכך שרת ה-API לא הבין את הבקשה.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. זו יכולה להיות שגיאה זמנית, אבל בדרך כלל היא מעידה על כך שהקלט של הבקשה לא חוקי. כדי לוודא שהוא תקין, צריך לבדוק את המבנה של המשאב comment בגוף הבקשה.
forbidden (403) forbidden התגובה לא עודכנה כי אין הרשאות מספיקות. יכול להיות שהבקשה לא מורשית כמו שצריך.
forbidden (403) ineligibleAccount חשבון YouTube שמשמש לאישור בקשת ה-API צריך למזג עם חשבון Google של המשתמש כדי לעדכן שרשור תגובה או שרשור תגובות.
notFound (404) commentNotFound לא ניתן היה למצוא את התגובה שציינת. יש לבדוק את הערך של המאפיין id בגוף הבקשה כדי לוודא שהוא נכון.

חברים

בטבלאות הבאות מפורטות הודעות שגיאה שה-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 מחזיר בתגובה לקריאות שקשורות למשאבים של subscriptions. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

subscriptions.delete

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) subscriptionForbidden הבקשה לא מאומתת כראוי או אינה נתמכת בערוץ הזה.
notFound (404) subscriptionNotFound המינוי שניסית למחוק לא נמצא. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון.

subscriptions.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) subscriptionDuplicate המינוי שניסית ליצור כבר קיים.
badRequest (400) subscriptionForbidden הגעת למספר המינויים המרבי.
badRequest (400) subscriptionForbidden יותר מדי מינויים לאחרונה. יש לנסות שוב בעוד מספר שעות.
badRequest (400) subscriptionForbidden אין תמיכה להירשם לערוץ שלך.
forbidden (403) subscriptionForbidden הבקשה לא מאומתת כראוי או אינה נתמכת בערוץ הזה.
notFound (404) publisherNotFound המשאב שצוין במאפיין snippet.resourceId של הבקשה לא נמצא.
notFound (404) subscriberNotFound לא ניתן למצוא את המנוי שצוין בבקשה.
required (400) publisherRequired משאב המינוי שצוין בבקשה חייב להשתמש במאפיין snippet.resourceId כדי לזהות את הערוץ שנרשמת אליו.

subscriptions.list

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) accountClosed לא ניתן היה לאחזר את המינויים כי החשבון של המנוי סגור.
forbidden (403) accountSuspended לא ניתן היה לאחזר את המינויים כי החשבון של המנוי מושעה.
forbidden (403) subscriptionForbidden אין למגיש הבקשה גישה למינויים המבוקשים.
notFound (404) subscriberNotFound לא ניתן למצוא את המנוי שצוין בבקשה.

תמונות ממוזערות

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של thumbnails. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

thumbnails.set

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) invalidImage תוכן התמונה שסיפקת לא חוקי.
badRequest (400) mediaBodyRequired הבקשה אינה כוללת את תוכן התמונה.
forbidden (403) forbidden לא ניתן להגדיר את התמונה הממוזערת לסרטון שצוין. יכול להיות שהבקשה לא מורשית כמו שצריך.
forbidden (403) forbidden למשתמש שאומת אין הרשאות להעלות סרטונים ולהגדיר להם תמונות ממוזערות מותאמות אישית.
notFound (404) videoNotFound הסרטון שניסית להוסיף לו תמונה ממוזערת לא נמצא. צריך לבדוק את ערך הפרמטר videoId של הבקשה כדי לוודא שהוא נכון.
tooManyRequests (429) uploadRateLimitExceeded הערוץ העלה יותר מדי תמונות ממוזערות לאחרונה. אפשר לנסות לשלוח את הבקשה שוב מאוחר יותר.

videoAbuseReportReasons

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של videoAbuseReportReasons. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

videoAbuseReportReasons.list

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) forbidden הגישה אסורה. ייתכן שהבקשה לא מורשית כראוי.

videoCategories

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של videoCategories. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

videoCategories.list

סוג השגיאה פרטי השגיאה תיאור
notFound (404) videoCategoryNotFound קטגוריית הסרטון שזוהתה על ידי הפרמטר id לא נמצאה. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר רשימה של ערכים חוקיים.

סרטונים

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של videos. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

videos.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSet הבקשה מנסה להוסיף פרטי סרטון שמותאמים לשוק המקומי, בלי לציין את שפת ברירת המחדל של פרטי הסרטון.
badRequest (400) invalidCategoryId המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר קטגוריות נתמכות.
badRequest (400) invalidDescription המטא-נתונים של הבקשה מציינים תיאור סרטון לא חוקי.
badRequest (400) invalidFilename שם הקובץ של הסרטון שצוין בכותרת Slug לא תקין.
badRequest (400) invalidPublishAt המטא-נתונים של הבקשה מציינים זמן פרסום מתוזמן לא חוקי.
badRequest (400) invalidRecordingDetails האובייקט recordingDetails במטא-נתונים של הבקשה מציין פרטי הקלטה לא חוקיים.
badRequest (400) invalidTags המטא-נתונים של הבקשה מציינים מילות מפתח לא חוקיות בסרטון.
badRequest (400) invalidTitle המטא-נתונים של הבקשה מציינים שם סרטון ריק או לא חוקי.
badRequest (400) invalidVideoGameRating המטא-נתונים של הבקשה מציינים סיווג לא חוקי של משחק וידאו.
badRequest (400) invalidVideoMetadata המטא-נתונים של הבקשה לא חוקיים. השגיאה הזו מתקבלת אם הבקשה מעדכנת את החלק snippet במשאב video, אבל לא מגדירה ערך לנכסים snippet.title ו-snippet.categoryId.
badRequest (400) mediaBodyRequired הבקשה לא כוללת את תוכן הסרטון.
badRequest (400) uploadLimitExceeded המשתמש חרג ממספר הסרטונים שהוא יכול להעלות.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting הבקשה מנסה להגדיר רישיון לא תקף לסרטון.
forbidden (403) forbiddenPrivacySetting הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לסרטון.

videos.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) videoChartNotFound תרשים הווידאו המבוקש לא נתמך או שאינו זמין.
forbidden (403) forbidden לבקשה אין הרשאה מתאימה לגשת לקובץ הווידאו או למידע לעיבוד. החלקים fileDetails, processingDetails ו-suggestions זמינים רק לבעלים של הסרטון.
forbidden (403) forbidden הבקשה לא יכולה לגשת למידע על דירוגי משתמשים. יכול להיות שהשגיאה הזו מתרחשת כי הבקשה לא מורשית להשתמש כראוי בפרמטר myRating.
notFound (404) videoNotFound לא ניתן למצוא את הסרטון שאתם מנסים לאחזר. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון.

videos.delete

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) forbidden לא ניתן למחוק את הסרטון שניסית למחוק. יכול להיות שהבקשה לא מורשית כמו שצריך.
notFound (404) videoNotFound הסרטון שניסית למחוק לא נמצא. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון.

videos.update

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSet בקשת ה-API מנסה להוסיף פרטי סרטון שמותאמים לשוק המקומי בלי לציין את שפת ברירת המחדל של פרטי הסרטון.
badRequest (400) invalidCategoryId המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. אפשר להשתמש בשיטה videoCategories.list כדי לאחזר קטגוריות נתמכות.
badRequest (400) invalidDefaultBroadcastPrivacySetting הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לשידור ברירת המחדל.
badRequest (400) invalidDescription המטא-נתונים של הבקשה מציינים תיאור סרטון לא חוקי.
badRequest (400) invalidPublishAt המטא-נתונים של הבקשה מציינים זמן פרסום מתוזמן לא חוקי.
badRequest (400) invalidRecordingDetails האובייקט recordingDetails במטא-נתונים של הבקשה מציין פרטי הקלטה לא חוקיים.
badRequest (400) invalidTags המטא-נתונים של הבקשה מציינים מילות מפתח לא חוקיות בסרטון.
badRequest (400) invalidTitle המטא-נתונים של הבקשה מציינים שם סרטון ריק או לא חוקי.
badRequest (400) invalidVideoMetadata המטא-נתונים של הבקשה לא חוקיים. השגיאה הזו מתקבלת אם הבקשה מעדכנת את החלק snippet במשאב video, אבל לא מגדירה ערך לנכסים snippet.title ו-snippet.categoryId.
forbidden (403) forbidden הגישה אסורה. ייתכן שהבקשה לא מורשית כראוי.
forbidden (403) forbiddenEmbedSetting הבקשה מנסה לקבוע הגדרת הטמעה לא חוקית לסרטון. ייתכן שלערוצים מסוימים אין הרשאה להציע נגנים מוטמעים לשידורים חיים. מידע נוסף זמין במרכז העזרה של YouTube.
forbidden (403) forbiddenLicenseSetting הבקשה מנסה להגדיר רישיון לא תקף לסרטון.
forbidden (403) forbiddenPrivacySetting הבקשה מנסה לקבוע הגדרת פרטיות לא חוקית לסרטון.
notFound (404) videoNotFound הסרטון שניסית לעדכן לא נמצא. צריך לבדוק את הערך בשדה id בגוף הבקשה כדי לוודא שהוא נכון.

videos.rate

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) emailNotVerified המשתמש צריך לאמת את כתובת האימייל שלו לפני הדירוג.
badRequest (400) invalidRating הבקשה הכילה ערך לא צפוי לפרמטר rating.
badRequest (400) videoPurchaseRequired סרטונים ששכרתם ניתנים לדירוג רק על ידי משתמשים ששכרו אותם.
forbidden (403) forbidden לא ניתן לדרג את הסרטון שניסית לדרג. יכול להיות שהבקשה לא מורשית כמו שצריך.
forbidden (403) videoRatingDisabled הבעלים של הסרטון שאתה מנסה לדרג השבית את הדירוגים של הסרטון הזה.
notFound (404) videoNotFound לא ניתן למצוא את הסרטון שניסית לדרג. צריך לבדוק את ערך הפרמטר id של הבקשה כדי לוודא שהוא נכון.

videos.reportAbuse

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) invalidAbuseReason הבקשה הכילה ערך לא צפוי בשדה reason_id, או שילוב של השדות reason_id ו-secondary_reason_id.
badRequest (400) rateLimitExceeded המשתמש שלח יותר מדי בקשות בפרק זמן נתון.
forbidden (403) forbidden
notFound (404) videoNotFound לא מצאנו את הסרטון שעליו ניסית לדווח על שימוש לרעה.

watermarks

בטבלאות הבאות מפורטות הודעות שגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבים של watermarks. השיטות האלה יכולות גם להחזיר שגיאות שמפורטות בקטע שגיאות נפוצות בבקשה.

watermarks.set

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) imageFormatUnsupported אין תמיכה בפורמט של התמונה שסיפקת.
badRequest (400) imageTooTall התמונה שסיפקת גבוהה מדי.
badRequest (400) imageTooWide התמונה שסיפקת רחבה מדי.
badRequest (400) mediaBodyRequired הבקשה אינה כוללת את תוכן התמונה.
forbidden (403) forbidden לא ניתן להגדיר את סימן המים בערוץ שצוין. יכול להיות שהבקשה לא מורשית כמו שצריך, או שהפרמטר channelId מוגדר לערך לא חוקי.

watermarks.unset

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) forbidden לא ניתן לבטל את הגדרת סימן המים בערוץ שצוין. יכול להיות שהבקשה לא מורשית כמו שצריך, או שהפרמטר channelId מוגדר לערך לא חוקי.