YouTube Data API - Errors

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

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

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

Core API errors

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

Common request errors

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

Request context errors

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) invalidLanguage ערך הפרמטר hl לא מציין קוד שפה חוקי.
badRequest (400) invalidMine אין תמיכה בשימוש בפרמטר mine בבקשה.
badRequest (400) invalidMine אי אפשר להשתמש בפרמטר mine בבקשות שבהן המשתמש המאומת הוא שותף של YouTube. צריך להסיר את הפרמטר mine, לבצע אימות כמשתמש YouTube על ידי הסרת הפרמטר onBehalfOfContentOwner, או לפעול כאחד מהערוצים של השותף על ידי ציון הפרמטר onBehalfOfContentOwnerChannel אם הוא זמין ל-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, המשמעות של השגיאה עדיין רלוונטית.

פעילויות

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

ערוצים

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

channels.list

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

channels.update

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) brandingValidationError אחד מהערכים באובייקט brandingSettings נכשל באימות. משתמשים ב-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 אחד מהערכים באובייקט הלוקליזציות נכשל באימות. כדי לאחזר ערכים תקינים, צריך להשתמש בשיטה channels.list ולעדכן אותם בהתאם להנחיות במסמכי העזרה בנושא משאבי ערוצים.
badRequest (400) tooManyPromotedItems חרגת ממספר הפריטים המותרים לקידום בחלק invideoPromotion.
forbidden (403) channelForbidden הבקשה לא נתמכת בערוץ שצוין בפרמטר id או שההרשאה לבקשה לא תקינה.
forbidden (403) promotedVideoNotAllowed הערוץ שבקשת ה-API מנסה לעדכן לא נמצא. צריך לבדוק את הערך של המאפיין id במשאב channel שהבקשה שלחה כדי לוודא שמזהה הערוץ נכון.
forbidden (403) websiteLinkNotAllowed כתובת האתר שצוינה אסורה.
notFound (404) channelNotFound הערוץ שצוין בפרמטר id לא נמצא או שאין לו אפשרויות מיתוג.
notFound (404) channelNotFound הערוץ שצוין בפרמטר id לא נמצא.
notFound (404) unknownChannelId מזהה הערוץ שצוין לא נמצא.
notFound (404) unknownChannelId מזהה הערוץ שצוין ב-recentlyUploadedBy לא נמצא.
notFound (404) unknownVideoId לא נמצא מזהה הסרטון שצוין כפריט מקודם.
required (400) requiredItemIdType במטא-נתונים של הבקשה צריך לציין סוג פריט בחלק invideoPromotion.
required (400) requiredItemId המטא-נתונים של הבקשה חייבים לציין פריט בחלק invideoPromotion.
required (400) requiredTimingOffset המטא-נתונים של הבקשה חייבים לציין היסט תזמון שמוגדר כברירת מחדל, כדי שהמערכת של YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.offsetMs במשאב שהבקשה שולחת.
required (400) requiredTimingOffset במטא-נתונים של הבקשה צריך לציין היסט תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.offsetMs במשאב שהבקשה שולחת.
required (400) requiredTimingType המטא-נתונים של הבקשה חייבים לציין שיטת תזמון כדי ש-YouTube יוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.type במשאב שהבקשה שולחת.
required (400) requiredTimingType המטא-נתונים של הבקשה חייבים לציין שיטת תזמון כדי ש-YouTube יוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.type במשאב שהבקשה שולחת.
required (400) requiredTiming המטא-נתונים של הבקשה חייבים לציין תזמון לכל פריט בחלק invideoPromotion.
required (400) requiredVideoId המטא-נתונים של הבקשה חייבים לכלול מזהה סרטון כדי לזהות את הפריט המקודם.
required (400) requiredWebsiteUrl המטא-נתונים של הבקשה חייבים לכלול כתובת אתר בחלק invideoPromotion. מגדירים את הערך של המאפיין invideoPromotion.items[].id.websiteUrl במשאב שהבקשה שולחת.

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

תגובות

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

comments.list

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

comments.setModerationStatus

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

comments.insert

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

comments.delete

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

comments.update

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

חברים

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

members.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) channelMembershipsNotEnabled בערוץ של היוצר שאישר את הבקשה לא מופעל מועדון חברים.
badRequest (400) invalidMode ערך הפרמטר mode לא תקין. השגיאה הזו יכולה להתרחש אם הפרמטר pageToken מציין אסימון שאוחזר באמצעות מצב שונה מזה שצוין.
badRequest (400) invalidPageToken הערך של הפרמטר pageToken לא תקין. השגיאה הזו מתרחשת אם פג התוקף של אסימון הדף שנעשה בו שימוש בבקשה.
badRequest (400) invalidHasAccessToLevel ערך הפרמטר hasAccessToLevel לא תקין. אין רמה עם הערך שצוין id.
badRequest (400) invalidFilterByMemberChannelId הערך של הפרמטר filterByMemberChannelId לא תקין. השגיאה הזו מתרחשת אם הערך של הפרמטר filterByMemberChannelId מציין יותר מ-100 ערוצים.

membershipsLevels

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

membershipsLevels.list

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

playlistItems

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

playlistItems.delete

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) playlistItemsNotAccessible אין הרשאה מתאימה בבקשה למחיקת הפריט שצוין בפלייליסט.
notFound (404) playlistItemNotFound לא נמצא הפריט בפלייליסט שזוהה באמצעות הפרמטר id של הבקשה.
invalidValue (400) playlistOperationUnsupported ה-API לא תומך באפשרות למחוק סרטונים מהפלייליסט שצוין. לדוגמה, אי אפשר למחוק סרטון מהפלייליסט 'סרטונים שהועלו'.

playlistItems.insert

סוג השגיאה פרטי השגיאה תיאור
duplicate videoAlreadyInPlaylist הסרטון שאתם מנסים להוסיף לפלייליסט כבר נמצא בו.
forbidden (403) playlistContainsMaximumNumberOfVideos הפלייליסט כבר מכיל את המספר המקסימלי המותר של פריטים.
forbidden (403) playlistItemsNotAccessible הבקשה לא קיבלה הרשאה מתאימה להוספת הפריט שצוין לפלייליסט.
invalidValue (400) invalidContentDetails המאפיין contentDetails בבקשה לא תקין. סיבה אפשרית לכך היא שהשדה contentDetails.note ארוך מ-280 תווים.
invalidValue (400) invalidPlaylistItemPosition הבקשה מנסה להגדיר את המיקום של הפריט בפלייליסט לערך לא חוקי או לא נתמך. בודקים את הערך של המאפיין position ב-snippet של המשאב.
invalidValue (400) invalidResourceType הערך type שצוין למזהה המשאב לא נתמך בפעולה הזו. מזהה המשאב מזהה את הפריט שנוסף לפלייליסט, למשל youtube#video.
invalidValue (400) manualSortRequired הבקשה מנסה להגדיר את המיקום של פריט בפלייליסט, אבל בפלייליסט לא נעשה שימוש במיון ידני. (לדוגמה, פריטים בפלייליסט יכולים להיות ממוינים לפי תאריך או פופולריות). כדי לטפל בשגיאה, צריך להסיר את הרכיב snippet.position מהמשאב שהבקשה מוסיפה. אם רוצים שהפריט בפלייליסט יהיה במיקום מסוים ברשימה, צריך קודם לעדכן את האפשרות סדר של הפלייליסט לידני בהגדרות הפלייליסט. אפשר לשנות את ההגדרות האלה במנהל הסרטונים ב-YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist הסרטון שאתם מנסים להוסיף לפלייליסט כבר נמצא בפלייליסט אחר של סדרה.
invalidValue (400) playlistOperationUnsupported ה-API לא תומך באפשרות להוסיף סרטונים לפלייליסט שצוין. לדוגמה, אי אפשר להוסיף סרטון לפלייליסט של הסרטונים שהעליתם.
notFound (404) playlistNotFound לא נמצאה הפלייליסט שזוהתה באמצעות הפרמטר playlistId של הבקשה.
notFound (404) videoNotFound הסרטון שאתם מנסים להוסיף לפלייליסט לא נמצא. צריך לבדוק את הערך של המאפיין videoId ולוודא שהוא נכון.
required (400) channelIdRequired בבקשה לא צוין ערך למאפיין החובה channelId.
required (400) playlistIdRequired בבקשה לא צוין ערך למאפיין החובה playlistId.
required (400) resourceIdRequired הבקשה צריכה להכיל משאב שבו האובייקט snippet מציין resourceId.

playlistItems.list

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) playlistItemsNotAccessible הבקשה לא קיבלה הרשאה מתאימה לאחזור הפלייליסט שצוין.
notFound (404) playlistNotFound לא נמצאה הפלייליסט שזוהתה באמצעות הפרמטר playlistId של הבקשה.
notFound (404) videoNotFound לא נמצא הסרטון שזוהה באמצעות הפרמטר videoId של הבקשה.
required (400) playlistIdRequired בבקשת ההרשמה לא צוין ערך למאפיין החובה playlistId.
invalidValue (400) playlistOperationUnsupported ה-API לא תומך באפשרות להציג רשימה של סרטונים בפלייליסט שצוין. לדוגמה, אי אפשר להוסיף סרטון לפלייליסט 'לצפייה בהמשך'.

playlistItems.update

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) playlistItemsNotAccessible הבקשה לא קיבלה הרשאה מתאימה לעדכון הפריט שצוין בפלייליסט.
invalidValue (400) invalidPlaylistItemPosition הבקשה מנסה להגדיר את המיקום של הפריט בפלייליסט לערך לא חוקי או לא נתמך. צריך לבדוק את הערך של המאפיין position ב-snippet של המשאב.
invalidValue (400) invalidResourceType הערך של type שצוין במזהה המשאב לא נתמך בפעולה הזו. מזהה המשאב מציין את הפריט שמוסיפים לפלייליסט – לדוגמה, youtube#video.
invalidValue (400) invalidSnippet בבקשה לא צוין נכס snippet תקין.
invalidValue (400) manualSortRequired הבקשה מנסה להגדיר את המיקום של הפריט בפלייליסט, אבל הפלייליסט לא משתמש במיון ידני. (לדוגמה, פריטים בפלייליסט יכולים להיות ממוינים לפי תאריך או פופולריות). כדי לטפל בשגיאה, צריך להסיר את הרכיב snippet.position מהמשאב שהבקשה מוסיפה. אם רוצים שהפריט בפלייליסט יהיה במיקום מסוים ברשימה, צריך קודם לעדכן את האפשרות סדר של הפלייליסט לידני בהגדרות הפלייליסט. אפשר לשנות את ההגדרות האלה במנהל הסרטונים ב-YouTube.
invalidValue (400) playlistOperationUnsupported ה-API לא תומך באפשרות לעדכן סרטונים בפלייליסט שצוין. לדוגמה, אי אפשר לעדכן סרטון בפלייליסט של הסרטונים שהעליתם.
notFound (404) playlistItemNotFound לא ניתן למצוא את הפריט בפלייליסט שמזוהה באמצעות המאפיין id של הבקשה.
notFound (404) playlistNotFound לא נמצאה הפלייליסט שזוהתה באמצעות הפרמטר playlistId של הבקשה.
required (400) channelIdRequired בבקשה לא צוין ערך למאפיין החובה channelId.
required (400) playlistIdRequired בבקשה לא צוין ערך למאפיין החובה playlistId.
required (400) playlistItemIdRequired המשאב של הפריט בפלייליסט שצוין בבקשה חייב להשתמש במאפיין id כדי לזהות את הפריט בפלייליסט שמתעדכן.

פלייליסטים

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

playlists.delete

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

playlists.list

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) channelClosed הערוץ שצוין בפרמטר channelId נסגר.
forbidden (403) channelSuspended הערוץ שצוין בפרמטר channelId הושעה.
forbidden (403) playlistForbidden הפלייליסט שזוהה באמצעות הפרמטר id של הבקשה לא תומך בבקשה, או שהבקשה לא אושרה כראוי.
notFound (404) channelNotFound לא נמצא הערוץ שצוין בפרמטר channelId.
notFound (404) playlistNotFound הפלייליסט שזוהה באמצעות הפרמטר id של הבקשה לא נמצא.
invalidValue (400) playlistOperationUnsupported ה-API לא תומך באפשרות להציג את הפלייליסט שצוין. לדוגמה, אי אפשר להציג את הפלייליסט "לצפייה בהמשך".

playlists.insert

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

playlists.update

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

מינויים

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

subscriptions.delete

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

subscriptions.insert

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

subscriptions.list

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

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

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

thumbnails.set

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

videoAbuseReportReasons

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

videoAbuseReportReasons.list

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

videoCategories

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

videoCategories.list

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

סרטונים

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

videos.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) defaultLanguageNotSet הבקשה מנסה להוסיף פרטי סרטון שמותאמים לשוק המקומי בלי לציין את שפת ברירת המחדל של פרטי הסרטון.
badRequest (400) invalidCategoryId המאפיין snippet.categoryId מציין מזהה קטגוריה לא חוקי. כדי לאחזר קטגוריות נתמכות, משתמשים ב-method‏ 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 הערוץ הגיע למגבלת העלאת הסרטונים היומית. זוהי הגבלה של פלטפורמת YouTube, והיא נפרדת לחלוטין ממכסת ה-API של הפרויקט שלכם ב-Google Cloud.
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 מציין מזהה קטגוריה לא חוקי. כדי לאחזר קטגוריות נתמכות, משתמשים ב-method‏ 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 מוגדר לערך לא חוקי.