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 לא תומך בחשבונות שירות, ואם תנסו לבצע אימות באמצעות חשבון שירות, תופיע הודעת השגיאה הזו.

הפוסט בבלוג של ממשק ה-API של YouTube שכולל תמיכה בחשבונות 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 לא נמצא.

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 של הבקשה כדי לוודא שהוא נכון.

מודעות באנר של ערוצים

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

channelBanners.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) bannerAlbumFull באלבום העיצוב של הערוץ ב-YouTube יש יותר מדי תמונות. ניתן להיכנס לדף http://photos.google.com, לנווט לדף האלבומים ולהסיר חלק מהתמונות מהאלבום.
badRequest (400) mediaBodyRequired הבקשה לא כוללת את תוכן התמונה.

מדורי ערוצים

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

channelSections.delete

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

channelSections.insert

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

channelSections.list

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

channelSections.update

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

ערוצים

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

channels.list

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

channels.update

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

שרשורי תגובות

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

commentThreads.list

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

commentThreads.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) channelOrVideoIdMissing כל שרשור של תגובה חייב להיות מקושר לערוץ או לסרטון.
  • אם ההערה רלוונטית לערוץ, צריך לוודא שהמשאב שצוין בגוף הבקשה מספק ערך למאפיין snippet.channelId. תגובה שרלוונטית לערוץ מופיעה בכרטיסייה דיון של הערוץ.
  • אם ההערה חלה על סרטון, חשוב לוודא שבמשאב מציינים ערכים גם למאפיין 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 מסנן המזהים תואם רק לתגובות המבוססות על Google+.
forbidden (403) forbidden לא ניתן לאחזר אחת או יותר מהתגובות המבוקשות עקב הרשאות לא מספיקות. יכול להיות שהבקשה לא מורשית כראוי.
notFound (404) commentNotFound לא ניתן למצוא אחת או יותר מהתגובות שצוינו. צריך לבדוק את ערכי הפרמטרים id ו-parentId של הבקשה כדי לוודא שהם נכונים.

comments.setModerationStatus

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) banWithoutReject ניתן להשתמש בפרמטר banAuthor רק אם ערך הפרמטר moderationStatus הוא rejected.
badRequest (400) operationNotSupported תגובות שאינן מבוססות על Google+ מציעות פונקציונליות ניהול מוגבלת בלבד.
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 ניתן לעדכן רק תגובות המבוססות על Google+.
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 ערוצים.

רמות החברות במועדון

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

membershipsLevels.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) channelMembershipsNotEnabled בערוץ של היוצר שמאשר את הבקשה לא הופעל 'מועדון החברים של הערוץ'.

פריטים מפלייליסט

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

videoAbuseReportסיבות

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

videoAbuseReportReasons.list

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

קטגוריות סרטונים

בטבלאות הבאות מפורטות הודעות השגיאה שה-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 מוגדר ערך לא חוקי.