Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.
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 במשאב שהבקשה שולחת. |
חברים
בטבלאות הבאות מפורטות הודעות השגיאה שה-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 בתגובה לקריאות שקשורות למשאבי 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. כדי לאחזר רשימה של ערכים חוקיים, משתמשים ב-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 מוגדר לערך לא חוקי. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-10-15 (שעון UTC).
[[["התוכן קל להבנה","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-10-15 (שעון UTC)."],[],[]]
תגובות
בטבלאות הבאות מפורטות הודעות השגיאה שמוחזרות על ידי ה-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בגוף הבקשה ולוודא שהוא נכון.