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

channelSections.list

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

channelSections.update

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

ערוצים

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

channels.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) invalidCriteria אפשר לציין לכל היותר אחד מהמסננים הבאים:id, ‏ mySubscribers, ‏ categoryId, ‏ mine, ‏ managedByMe, ‏ forUsername. במקרה של אימות בעלות על תוכן באמצעות הפרמטר onBehalfOfContentOwner, אפשר לציין רק את id או managedByMe.
forbidden (403) channelForbidden הערוץ שצוין בפרמטר id לא תומך בבקשה או שהבקשה לא אושרה כראוי.
notFound (404) categoryNotFound לא ניתן למצוא את הקטגוריה שמזוהה על ידי הפרמטר categoryId.
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.
badRequest (400) invalidCustomMessage במטא-נתונים של הבקשה צוינה הודעה מותאמת אישית לא חוקית. בודקים את הערך של המאפיין invideoPromotion.items[].customMessage במשאב שאליו נשלחה הבקשה.
badRequest (400) invalidDuration המטא-נתונים של הבקשה מציינים משך לא תקין בחלק invideoPromotion.
badRequest (400) invalidDuration במטא-נתונים של הבקשה צוין סוג מיקום לא תקין לקביעת המיקום של הפריט המקודם בנגן הווידאו. בודקים את הערך של המאפיין invideoPromotion.position.type במשאב שאליו נשלחה הבקשה.
badRequest (400) invalidRecentlyUploadedBy מזהה הערוץ שצוין במטא-נתונים של הבקשה לא תקין. בודקים את הערך של המאפיין invideoPromotion.items[].id.recentlyUploadedBy במשאב שאליו נשלחה הבקשה.
badRequest (400) invalidTimingOffset המטא-נתונים של הבקשה מציינים היסט לא תקין של תזמון בחלק invideoPromotion.
badRequest (400) invalidTimingOffset המטא-נתונים של הבקשה מציינים היסט זמן לא תקין לקביעת המועד שבו הפריט המקודם צריך להיות מוצג בנגן הווידאו. בודקים את הערך של המאפיין invideoPromotion.timing.offsetMs במשאב שאליו נשלחה הבקשה.
badRequest (400) invalidTimingType המטא-נתונים של הבקשה מציינים שיטת תזמון לא תקינה לקביעת מתי הפריט המקודם צריך להיות מוצג בנגן הווידאו. בודקים את הערך של המאפיין invideoPromotion.timing.type במשאב שאליו נשלחה הבקשה.
badRequest (400) localizationValidationError אחד מהערכים באובייקט הלוקליזציות לא עבר אימות. כדי לאחזר ערכים תקינים, צריך להשתמש בשיטה channels.list ולעדכן אותם בהתאם להנחיות שמפורטות במסמכי העזרה בנושא משאבי ערוצים.
badRequest (400) tooManyPromotedItems חרגת ממספר הפריטים המקודמים המותר בחלק invideoPromotion.
forbidden (403) channelForbidden הערוץ שצוין בפרמטר id לא תומך בבקשה או שהבקשה לא אושרה כראוי.
forbidden (403) promotedVideoNotAllowed לא ניתן למצוא את הערוץ שהבקשה ל-API מנסה לעדכן. בודקים את הערך של המאפיין id במשאב channel שהבקשה נשלחה אליו כדי לוודא שמזהה הערוץ נכון.
forbidden (403) websiteLinkNotAllowed כתובת האתר שצוינה לא מותרת.
notFound (404) channelNotFound לא ניתן למצוא את הערוץ שצוין בפרמטר id או שאין לו אפשרויות מיתוג.
notFound (404) channelNotFound לא נמצא הערוץ שצוין בפרמטר id.
notFound (404) unknownChannelId לא נמצא מזהה הערוץ שצוין.
notFound (404) unknownChannelId לא נמצא מזהה הערוץ שצוין ב-recentlyUploadedBy.
notFound (404) unknownVideoId לא ניתן למצוא את מזהה הסרטון שצוין כפריט מקודם.
required (400) requiredItemIdType במטא-נתונים של הבקשה צריך לציין סוג פריט בחלק invideoPromotion.
required (400) requiredItemId במטא-נתונים של הבקשה צריך לציין פריט בחלק invideoPromotion.
required (400) requiredTimingOffset במטא-נתונים של הבקשה צריך לציין היסט תזמון שמוגדר כברירת מחדל, כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.offsetMs במשאב שהבקשה שולחת.
required (400) requiredTimingOffset במטא-נתונים של הבקשה צריך לציין היסט תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.offsetMs במשאב שהבקשה שולחת.
required (400) requiredTimingType במטא-נתונים של הבקשה צריך לציין שיטת תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.defaultTiming.type במשאב שהבקשה שולחת.
required (400) requiredTimingType במטא-נתונים של הבקשה צריך לציין שיטת תזמון כדי שמערכת YouTube תוכל לקבוע מתי להציג את הפריט המקודם. מגדירים את הערך של המאפיין invideoPromotion.timing.type במשאב שהבקשה שולחת.
required (400) requiredTiming במטא-נתונים של הבקשה צריך לציין תזמון לכל פריט בחלק invideoPromotion.
required (400) requiredVideoId במטא-נתונים של הבקשה צריך לציין מזהה סרטון כדי לזהות את הפריט שמקודם.
required (400) requiredWebsiteUrl במטא-נתונים של הבקשה צריך לציין כתובת אתר בחלק invideoPromotion. מגדירים את הערך של המאפיין invideoPromotion.items[].id.websiteUrl במשאב שהבקשה שולחת.

commentThreads

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

commentThreads.list

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) operationNotSupported בקשת ה-API לא תקינה או שנוצרה באופן שגוי, וכתוצאה מכך שרת ה-API לא הבין את הבקשה.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. יכול להיות שמדובר בשגיאה זמנית, אבל בדרך כלל היא מציינת שהקלט של הבקשה לא תקין. בודקים את המבנה של משאב commentThread בגוף הבקשה כדי לוודא שהוא תקין.
forbidden (403) commentsDisabled האפשרות לפרסם תגובות לסרטון שמוגדר באמצעות הפרמטר videoId הושבתה.
forbidden (403) forbidden לא ניתן לאחזר אחד או יותר משרשורי התגובות שביקשת בגלל הרשאות לא מספיקות. יכול להיות שהבקשה לא אושרה כראוי.
notFound (404) channelNotFound לא מצאנו את הערוץ שצוין בפרמטר allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound לא הצלחנו למצוא אחד או יותר משרשורי התגובות שצוינו. צריך לבדוק את הערכים של הפרמטר id בבקשה ולוודא שהם נכונים.
notFound (404) videoNotFound לא נמצא סרטון עם המזהה שצוין בפרמטר videoId.

commentThreads.insert

סוג השגיאה פרטי השגיאה תיאור
badRequest (400) channelOrVideoIdMissing כל שרשור תגובות חייב להיות מקושר לערוץ או לסרטון. מוודאים שצוינו ערכים למאפיינים snippet.channelId ו-snippet.videoId של המשאב. תגובה לסרטון מופיעה בדף הצפייה של הסרטון.
badRequest (400) commentTextRequired במשאב comment שמוסיפים צריך לציין ערך למאפיין snippet.topLevelComment.snippet.textOriginal. הערות לא יכולות להיות ריקות.
badRequest (400) commentTextTooLong המשאב comment שמוסיפים מכיל יותר מדי תווים במאפיין snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata המטא-נתונים של הבקשה לא תקינים.
badRequest (400) processingFailure שרת ה-API לא הצליח לעבד את הבקשה. יכול להיות שמדובר בשגיאה זמנית, אבל בדרך כלל היא מציינת שהקלט של הבקשה לא תקין. בודקים את המבנה של משאב commentThread בגוף הבקשה כדי לוודא שהוא תקין.
forbidden (403) forbidden יצירת שרשור התגובות נכשלה כי ההרשאות לא מספיקות. יכול להיות שהבקשה לא אושרה כראוי.
forbidden (403) ineligibleAccount כדי להוסיף תגובה או שרשור תגובות, צריך למזג את חשבון YouTube שמשמש לאישור בקשת ה-API עם חשבון Google של המשתמש.
notFound (404) channelNotFound לא נמצא הערוץ שצוין. בודקים את הערך של מאפיין snippet.channelId ומוודאים שהוא נכון.
notFound (404) videoNotFound לא נמצא הסרטון שצוין. בודקים את הערך של מאפיין snippet.videoId ומוודאים שהוא נכון.

תגובות

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

comments.list

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

comments.setModerationStatus

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

comments.insert

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

comments.delete

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

comments.update

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

חברים

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

members.list

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

membershipsLevels

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

membershipsLevels.list

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

playlistItems

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

playlistItems.delete

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

playlistItems.insert

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

playlistItems.list

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

playlistItems.update

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

פלייליסטים

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

playlists.delete

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

playlists.list

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

playlists.insert

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

playlists.update

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

מנויים

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

subscriptions.delete

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

subscriptions.insert

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

subscriptions.list

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

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

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

thumbnails.set

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

videoAbuseReportReasons

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

videoAbuseReportReasons.list

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

videoCategories

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

videoCategories.list

סוג השגיאה פרטי השגיאה תיאור
notFound (404) videoCategoryNotFound לא ניתן למצוא את קטגוריית הסרטון שצוינה בפרמטר id. אפשר להשתמש בשיטה 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 מוגדר לערך לא תקין.