YouTube Data API - Errors

במסמך הזה מפורטים הסוגים השונים של השגיאות שיכולות להופיע בפעולות YouTube Data API. אפשר גם למצוא רשימה של שגיאות לכל שיטה בנפרד במסמכי העזרה של השיטה הזו.

שגיאות כלליות

בטבלאות הבאות מפורטות הודעות שגיאה של API שלא ספציפיות לשיטת API מסוימת.

Core API errors

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

Common request errors

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) incompatibleParameters בבקשה צוינו שני פרמטרים או יותר שאי אפשר להשתמש בהם באותה בקשה.
badRequest (400) invalidFilters בבקשה צוין פרמטר מסנן לא חוקי.
badRequest (400) invalidPageToken בבקשה צוין טוקן דף לא חוקי.
badRequest (400) missingRequiredParameter חסר פרמטר נדרש בבקשה.
badRequest (400) unexpectedParameter בבקשה צוין פרמטר לא צפוי.
forbidden (403) accountDelegationForbidden המשתמש המאומת לא יכול לפעול בשם חשבון Google שצוין.
forbidden (403) authenticatedUserAccountClosed חשבון YouTube של המשתמש המאומת סגור. אם המשתמש המאומת פועל בשם חשבון Google אחר, השגיאה הזו מתייחסת לחשבון האחר.
forbidden (403) authenticatedUserAccountSuspended חשבון YouTube של המשתמש המאומת מושעה. אם המשתמש המאומת פועל בשם חשבון Google אחר, השגיאה הזו מתייחסת לחשבון האחר.
forbidden (403) authenticatedUserNotChannel בבקשה הזו, המשתמש המאומת צריך לפתור לערוץ, אבל הוא לא עושה זאת. אם הבקשה מאומתת ומשתמשת בפרמטר הענקת הגישה onBehalfOfContentOwner, צריך להגדיר גם את הפרמטר onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed הערוץ שצוין בבקשה נסגר.
forbidden (403) channelNotFound לא הצלחנו למצוא את הערוץ שצוין בבקשה.
forbidden (403) channelSuspended הערוץ שצוין בבקשה הושעה.
forbidden (403) cmsUserAccountNotFound למשתמש במערכת ניהול התוכן אין הרשאה לפעול בשם בעלי התוכן שצוין.
forbidden (403) insufficientCapabilities למשתמש במערכת ניהול התוכן אין מספיק יכולות.
forbidden (403) insufficientPermissions אסימון ה-OAuth 2.0 שסופק לבקשה מציין היקפי הרשאות לא מספיקים כדי לגשת לנתונים המבוקשים.
notFound (404) contentOwnerAccountNotFound חשבון הבעלים של התוכן שצוין לא נמצא.

Request context errors

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

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

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

פעילויות

YouTube הפסיקה את השימוש בתכונה 'עדכוני ערוץ'. אין יותר תמיכה בשיטה activities.insert.

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

activities.list

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) homeParameterDeprecated נתוני הפעילות של המשתמש בדף הבית לא זמינים דרך ה-API הזה. השגיאה הזו עשויה להתרחש אם מגדירים את הפרמטר home לערך true בבקשה לא מורשית.
forbidden (403) forbidden הבקשה לא אושרה כראוי.
notFound (404) channelNotFound לא ניתן למצוא את מזהה הערוץ שזוהה על ידי הפרמטר channelId בבקשה.
notFound (404) homeChannelNotFound לא ניתן למצוא פיד של דף הבית של YouTube עבור המשתמש המאומת הנוכחי.
unauthorized (401) authorizationRequired הבקשה משתמשת בפרמטר home אבל לא אושרה כראוי.

כתוביות

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

captions.delete

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

captions.download

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) forbidden ההרשאות שמשויכות לבקשה לא מספיקות כדי להוריד את הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי.
invalidValue (400) couldNotConvert לא ניתן היה להמיר את נתוני הטראק של הכתוביות לשפה ו/או לפורמט המבוקשים. מוודאים שהערכים המבוקשים של tfmt ו-tlang תקינים, ושהערך snippet.status של טראק הכתוביות המבוקש הוא לא failed.
notFound (404) captionNotFound רצועת הכתוביות לא נמצאה. צריך לבדוק את הערך של הפרמטר id בבקשה כדי לוודא שהוא נכון.

captions.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) contentRequired הבקשה לא מכילה את התוכן של טראק הכתוביות.
conflict (409) captionExists כבר יש לסרטון שצוין רצועת כתוביות עם snippet.language ו-snippet.name שצוינו. אפשר להוסיף לסרטון כמה רצועות של כתוביות באותה שפה, אבל לכל רצועה צריך להיות שם שונה.

יש כמה דרכים לתקן את השגיאה. אפשר למחוק את הטראק הקיים ולהוסיף טראק חדש, או לשנות את השם של הטראק החדש לפני שמוסיפים אותו.
forbidden (403) forbidden ההרשאות שמשויכות לבקשה לא מספיקות כדי להעלות את הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי.
invalidValue (400) invalidMetadata הבקשה מכילה ערכים לא חוקיים של מטא-נתונים, שמונעים את יצירת הטראק. מוודאים שהבקשה מציינת ערכים תקינים למאפיינים snippet.language,‏ snippet.name ו-snippet.videoId. אפשר לכלול גם את המאפיין snippet.isDraft, אבל הוא לא נדרש.
notFound (404) videoNotFound לא נמצא הסרטון שזוהה באמצעות הפרמטר videoId.
invalidValue (400) nameTooLong השדה snippet.name שצוין בבקשה ארוך מדי. האורך המקסימלי הנתמך הוא 150 תווים.

captions.list

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

captions.update

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) contentRequired בבקשה לא הועלה קובץ כתוביות מעודכן. תוכן הטראק בפועל נדרש אם הפרמטר sync מוגדר כ-true.
forbidden (403) forbidden ההרשאות שמשויכות לבקשה לא מספיקות לעדכון הטראק של הכתוביות. יכול להיות שהבקשה לא אושרה כראוי.
notFound (404) captionNotFound לא ניתן למצוא את רצועת הכתוביות שצוינה. צריך לבדוק את הערך של הפרמטר id בבקשה כדי לוודא שהוא נכון.

channelBanners

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

channelBanners.insert

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

channelSections

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

channelSections.delete

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

channelSections.insert

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

channelSections.list

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

channelSections.update

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

ערוצים

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

channels.list

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

channels.update

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

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.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 אחד מהערכים באובייקט localizations נכשל באימות. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומוודאים לעדכן אותם בהתאם להנחיות שמפורטות במסמכי העזרה של משאב הפלייליסטים.
badRequest (400) maxPlaylistExceeded לא ניתן ליצור את הפלייליסט כי הערוצים כבר מכיל את המספר המקסימלי של פלייליסטים.
forbidden (403) playlistForbidden הפעולה אסורה או שהבקשה לא אושרה כראוי.
invalidValue (400) invalidPlaylistSnippet הבקשה כוללת קטע פלייליסט לא חוקי.
required (400) playlistTitleRequired בבקשה צריך לציין שם של פלייליסט.

playlists.update

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSetError צריך להגדיר את defaultLanguage כך שיעדכן את localizations.
badRequest (400) localizationValidationError אחד מהערכים באובייקט localizations נכשל באימות. משתמשים בשיטה playlists.list כדי לאחזר ערכים חוקיים, ומוודאים לעדכן אותם בהתאם להנחיות שמפורטות במסמכי העזרה של משאב הפלייליסטים.
forbidden (403) playlistForbidden הפעולה אסורה או שהבקשה לא אושרה כראוי.
invalidValue (400) invalidPlaylistSnippet הבקשה כוללת קטע פלייליסט לא חוקי.
invalidValue (400) playlistOperationUnsupported ה-API לא תומך באפשרות לעדכן את הפלייליסט שצוין. לדוגמה, אי אפשר לעדכן את המאפיינים של פלייליסט הסרטונים שהועלו.
notFound (404) playlistNotFound לא ניתן למצוא את הפלייליסט שזוהה באמצעות הפרמטר id של הבקשה.
required (400) playlistTitleRequired בבקשה צריך לציין שם של פלייליסט.

מנויים

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

subscriptions.delete

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

subscriptions.insert

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

subscriptions.list

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

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

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

thumbnails.set

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

videoAbuseReportReasons

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

videoAbuseReportReasons.list

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

videoCategories

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

videoCategories.list

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

סרטונים

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

videos.insert

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

videos.list

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

videos.delete

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

videos.update

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

videos.rate

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

videos.reportAbuse

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

סימני מים

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

watermarks.set

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

watermarks.unset

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