בבקשה צוינו שני פרמטרים או יותר שלא ניתן להשתמש בהם באותה בקשה.
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 אם הוא זמין לשיטה שנקראה.
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 Service Account. 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.list כדי לאחזר ערכים תקינים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של המשאב channelSections.
badRequest (400)
notEditable
אי אפשר ליצור את הקטע הזה בערוץ.
badRequest (400)
styleRequired
במשאב channelSection צריך לציין ערך בשדה snippet.style.
badRequest (400)
targetInvalidCountry
אחד מהערכים ברשימה targeting.countries לא עבר את האימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים תקינים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של המשאב channelSections.
badRequest (400)
targetInvalidLanguage
אחד מהערכים ברשימה targeting.languages לא עבר את האימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים תקינים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של המשאב channelSections.
badRequest (400)
targetInvalidRegion
אחד מהערכים ברשימה targeting.regions לא עבר את האימות. אפשר להשתמש בשיטה 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.list כדי לאחזר ערכים תקינים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של המשאב channelSections.
badRequest (400)
targetInvalidLanguage
אחד מהערכים ברשימה targeting.languages לא עבר את האימות. אפשר להשתמש בשיטה channelSections.list כדי לאחזר ערכים תקינים ולעדכן אותם בהתאם להנחיות במסמכי התיעוד של המשאב channelSections.
badRequest (400)
targetInvalidRegion
אחד מהערכים ברשימה targeting.regions לא עבר את האימות. אפשר להשתמש בשיטה 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 לא עבר את האימות. משתמשים בשיטה channels.list כדי לאחזר את ההגדרות הקיימות של הערוץ, ומעדכנים את ערכי המאפיינים בהתאם להנחיות במסמכי המידע של המשאב channels.
badRequest (400)
channelTitleUpdateForbidden
כשמעדכנים את brandingSettings part של ערוץ, צריך להגדיר את הערך של המאפיין brandingSettings.channel.title לשם הנוכחי של הערוץ או להשמיט את המאפיין. ה-API מחזיר שגיאה אם משנים את הערך של המאפיין.
badRequest (400)
defaultLanguageNotSetError
צריך להגדיר את defaultLanguage לעדכון localizations.
badRequest (400)
invalidBrandingOption
אחת מהגדרות המיתוג שציינתם לא קיימת. כדי לאחזר ערכים תקינים, צריך להשתמש בשיטה channels.list ולעדכן אותם בהתאם להנחיות במסמכי המשאב channels.
במטא-נתונים של הבקשה צוין משך זמן לא תקין בחלק invideoPromotion.
badRequest (400)
invalidDuration
במטא-נתונים של הבקשה צוין סוג מיקום לא תקין לקביעת המיקום של הפריט המקודם בנגן הווידאו. בודקים את הערך של המאפיין invideoPromotion.position.type במשאב שאליו נשלחה הבקשה.
המטא-נתונים של הבקשה מציינים היסט זמן לא תקין בחלק 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
לא ניתן למצוא את הערוץ ש<b>בקשת ה-API</b> מנסה לעדכן. בודקים את הערך של המאפיין id במשאב channel שהבקשה נשלחה אליו כדי לוודא שמזהה הערוץ נכון.
forbidden (403)
websiteLinkNotAllowed
כתובת האתר שצוינה לא מותרת.
notFound (404)
channelNotFound
לא ניתן למצוא את הערוץ שצוין בפרמטר id או שאין לו אפשרויות מיתוג.
במטא-נתונים של הבקשה צריך לציין סוג פריט בחלק 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
במטא-נתונים של הבקשה צריך לציין מזהה סרטון כדי לזהות את הפריט שמקודם.
בטבלאות הבאות מפורטות הודעות השגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבי commentThreads. יכול להיות שהשיטות האלה יחזירו גם שגיאות שמופיעות בקטע שגיאות נפוצות בבקשות.
commentThreads.list
סוג השגיאה
פרטי השגיאה
תיאור
badRequest (400)
operationNotSupported
בקשת ה-API לא תקינה או שנוצרה באופן שגוי, וכתוצאה מכך שרת ה-API לא הבין את הבקשה.
badRequest (400)
processingFailure
שרת ה-API לא הצליח לעבד את הבקשה. יכול להיות שמדובר בשגיאה זמנית, אבל בדרך כלל היא מציינת שהקלט של הבקשה לא תקין. בודקים את המבנה של משאב commentThread בגוף הבקשה כדי לוודא שהוא תקין.
forbidden (403)
commentsDisabled
האפשרות לפרסם תגובות לסרטון שמוגדר באמצעות הפרמטר videoId הושבתה.
forbidden (403)
forbidden
לא ניתן לאחזר אחד או יותר משרשורי התגובות שביקשת בגלל הרשאות לא מספיקות. יכול להיות שהבקשה לא אושרה כמו שצריך.
כל שרשור תגובות חייב להיות מקושר לערוץ או לסרטון. מוודאים שצוינו ערכים למאפיינים 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 לא תקין. השגיאה הזו מתרחשת אם פג התוקף של אסימון הדף שבו נעשה שימוש בבקשה.
בטבלאות הבאות מפורטות הודעות השגיאה שה-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.
ה-API לא תומך באפשרות לעדכן את הפלייליסט שצוין. לדוגמה, אי אפשר לעדכן את המאפיינים של פלייליסט של סרטונים שהעליתם.
notFound (404)
playlistNotFound
לא נמצא פלייליסט עם המזהה שצוין בפרמטר id של הבקשה.
required (400)
playlistTitleRequired
בבקשה צריך לציין שם לפלייליסט.
חיפוש
בטבלאות הבאות מפורטות הודעות השגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבי search. יכול להיות שהשיטות האלה יחזירו גם שגיאות שמופיעות בקטע שגיאות נפוצות בבקשות.
search.list
סוג השגיאה
פרטי השגיאה
תיאור
badRequest (400)
invalidChannelId
הפרמטר channelId ציין מזהה ערוץ לא תקין.
badRequest (400)
invalidLocation
הפורמט של ערך הפרמטר location או locationRadius שגוי.
badRequest (400)
invalidRelevanceLanguage
הפורמט של ערך הפרמטר relevanceLanguage שגוי.
badRequest (400)
invalidSearchFilter
הבקשה מכילה שילוב לא תקין של מסנני חיפוש או הגבלות. אם מגדירים ערך לפרמטרים eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated או videoType, צריך להגדיר את הפרמטר type לערך video.
מנויים
בטבלאות הבאות מפורטות הודעות השגיאה שה-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 מוגדר לערך לא תקין.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2026-03-15 (שעון UTC)."],[],["API errors include `forbidden (403)` for access or quota issues, and `notFound (404)` for missing resources. `badRequest (400)` signals invalid parameters or missing data. `unauthorized (401)` means proper authorization is missing. Actions like `insert`, `update`, `delete`, `list` and `rate` are subject to errors, such as invalid input, authorization failures, or resource unavailability. Operations involving channels, captions, playlists, comments, videos, and subscriptions have specific error conditions, like duplicate entries or channel/video not found. Error descriptions often indicate necessary parameter corrections or authorization requirements.\n"]]
תגובות
בטבלאות הבאות מפורטות הודעות השגיאה שה-API מחזיר בתגובה לקריאות שקשורות למשאבי
comments. יכול להיות שהשיטות האלה יחזירו גם שגיאות שמופיעות בקטע שגיאות נפוצות בבקשות.comments.listbadRequest (400)operationNotSupportedforbidden (403)forbiddennotFound (404)commentNotFoundidו-parentIdבבקשה כדי לוודא שהם נכונים.comments.setModerationStatusbadRequest (400)banWithoutRejectbanAuthorרק אם ערך הפרמטרmoderationStatusהואrejected.badRequest (400)operationNotSupportedbadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidבבקשה כדי לוודא שהם נכונים.comments.insertbadRequest (400)commentTextRequiredcommentשמוסיפים צריך לציין ערך למאפייןsnippet.textOriginal. הערות לא יכולות להיות ריקות.badRequest (400)commentTextTooLongcommentשמוסיפים מכיל יותר מדי תווים במאפייןsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedsnippet.parentId. במשאבcommentThread, המאפייןsnippet.canReplyמציין אם הצופה הנוכחי יכול להשיב לשרשור.badRequest (400)parentCommentIsPrivatebadRequest (400)parentIdMissingcommentבתוכן של בקשת ה-API לא צוין ערך למאפייןsnippet.parentId.badRequest (400)processingFailurecommentבגוף הבקשה כדי לוודא שהוא תקין.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)parentCommentNotFoundsnippet.parentIdבגוף הבקשה ומוודאים שהוא נכון.comments.deletebadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidבבקשה ולוודא שהוא נכון.comments.updatebadRequest (400)commentTextTooLongcommentשעובר עדכון מכיל יותר מדי תווים במאפייןsnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedbadRequest (400)processingFailurecommentבגוף הבקשה כדי לוודא שהוא תקין.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)commentNotFoundidבגוף הבקשה ומוודאים שהוא נכון.