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

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