YouTube Data API - Errors

این سند انواع مختلف خطاهایی را که عملیات YouTube Data 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 را بردارید، با برداشتن پارامتر onBehalfOfContentOwner به‌عنوان کاربر YouTube اصالت‌سنجی کنید، یا با ارائه پارامتر 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» استفاده کنید. YouTube از «حساب‌های سرویس» پشتیبانی نمی‌کند و اگر تلاش کنید بااستفاده از «حساب سرویس» اصالت‌سنجی کنید، این خطا را دریافت خواهید کرد.

پست وبلاگ YouTube API که پشتیبانی از «حساب Google» را معرفی می‌کند، درباره خطای youtubeSignupRequired نیز با جزئیات بیشتری بحث می‌کند. اگرچه پست وبلاگ خطای مربوط به نسخه ۲.۱ میانای برنامه‌سازی کاربردی را توضیح می‌دهد، معنای خطا همچنان قابل‌اعمال است.

فعالیت‌ها

جدول‌های زیر پیام‌های خطایی را که 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 استفاده می‌کند اما به‌درستی مجاز نشده است.

زیرنویس

جدول‌های زیر پیام‌های خطایی را که «میانای برنامه‌سازی کاربردی» در پاسخ به تماس‌های مربوط به منابع 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 مشخص‌شده در درخواست خیلی طولانی است. حداکثر طول پشتیبانی‌شده ۱۵۰ نویسه است.

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

جدول‌های زیر پیام‌های خطایی را که «میانای برنامه‌سازی کاربردی» در پاسخ به تماس‌های مربوط به منابع channelBanners برمی‌گرداند مشخص می‌کنند. این روش‌ها همچنین می‌توانند خطاهای فهرست‌شده در بخش خطاهای رایج درخواست را برگردانند.

channelBanners.insert

نوع خطا جزئیات خطا شرح
badRequest (400) bannerAlbumFull آلبوم «تصویر انتخابی کانال YouTube» شما تصاویر زیادی دارد. لطفاً به http://photos.google.com بروید، به صفحه آلبوم‌ها پیمایش کنید، و چند تصویر را از آن آلبوم بردارید.
badRequest (400) mediaBodyRequired درخواست شامل محتوای تصویر نیست.

channelSections

جدول‌های زیر پیام‌های خطایی را که «میانای برنامه‌سازی کاربردی» در پاسخ به تماس‌های مربوط به منابع 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 ویژگی snippet.defaultLanguage منبع channelSection باید تنظیم شود تا شیء localizations برای آن منبع باموفقیت درج یا به‌روز شود.
badRequest (400) invalidLanguage یکی از کلیدهای زبان شیء localizations اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر استفاده کنید و آن‌ها را طبق دستورالعمل‌های موجود در اسناد منبع channelSections به‌روز کنید.
badRequest (400) notEditable این بخش کانال ایجاد نمی‌شود.
badRequest (400) styleRequired منبع channelSection باید مقداری برای فیلد snippet.style مشخص کند.
badRequest (400) targetInvalidCountry یکی از مقادیر موجود در فهرست targeting.countries اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر استفاده کنید و آن‌ها را طبق دستورالعمل‌های موجود در اسناد منبع channelSections به‌روز کنید.
badRequest (400) targetInvalidLanguage یکی از مقادیر فهرست targeting.languages اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر استفاده کنید و آن‌ها را طبق دستورالعمل‌های موجود در اسناد منبع channelSections به‌روز کنید.
badRequest (400) targetInvalidRegion یکی از مقادیر فهرست targeting.regions اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر و به‌روزرسانی آن‌ها طبق دستورالعمل‌های موجود در مستندات منبع channelSections استفاده کنید.
badRequest (400) typeRequired منبع channelSection باید مقداری را برای فیلد snippet.type مشخص کند.
forbidden (403) channelSectionForbidden درخواست به‌درستی اصالت‌سنجی نشده است یا برای این کانال پشتیبانی نمی‌شود.
invalidValue (400) channelNotActive حداقل یکی از کانال‌های مشخص‌شده فعال نیست.
invalidValue (400) channelsDuplicated درخواست ناموفق بود زیرا کانال‌های تکراری را مشخص کرده بود.
invalidValue (400) channelsNeeded اگر دارایی snippet.type دارای مقدار multipleChannels باشد، دارایی contentDetails.channels[] باید مشخص شود و باید حداقل یک کانال را مشخص کند.
invalidValue (400) channelsNotExpected منبع ارائه‌شده با درخواست، مقداری را برای ویژگی contentDetails.channels[] مشخص کرده است، اما کانال‌ها برای این نوع بخش کانال مورد انتظار نیستند.
invalidValue (400) contentDetailsNeeded منبعی که درج می‌کنید باید حاوی شیء contentDetails برای این نوع بخش کانال باشد.
invalidValue (400) inValidPosition ویژگی snippet.position حاوی مقدار نامعتبر است.
invalidValue (400) maxChannelSectionExceeded درخواست تکمیل نشد زیرا کانال ازقبل حداکثر تعداد بخش‌های کانال را دارد.
invalidValue (400) maxChannelsExceeded درخواست ناموفق بود زیرا تلاش کرد کانال‌های زیادی را در بخش کانال اضافه کند.
invalidValue (400) maxPlaylistExceeded درخواست ناموفق بود زیرا تلاش کرد تا فهرست‌های پخش زیادی را در بخش کانال اضافه کند.
invalidValue (400) onePlaylistNeeded اگر خصوصیت snippet.type دارای مقدار singlePlaylist باشد، خصوصیت contentDetails.playlists[] باید دقیقاً یک فهرست پخش را مشخص کند.
invalidValue (400) ownChannelInChannels نمی‌توانید کانال خودتان را در بخش کانالی که در آن کانال نشان داده می‌شود بگنجانید.
invalidValue (400) playlistIsPrivate یک یا چند فهرست پخش مشخص‌شده خصوصی هستند و بنابراین نمی‌توانند در بخش کانال قرار بگیرند.
invalidValue (400) playlistsDuplicated درخواست ناموفق بود زیرا فهرست‌های پخش تکراری را مشخص کرده است.
invalidValue (400) playlistsNeeded اگر مقدار دارایی snippet.type برابر با singlePlaylist یا multiplePlaylists باشد، دارایی contentDetails.playlists[] باید مشخص شود.
invalidValue (400) playlistsNotExpected منبع ارائه‌شده با درخواست، مقداری را برای ویژگی contentDetails.playlists[] مشخص کرده است، اما فهرست‌های پخش برای این نوع بخش کانال مورد انتظار نیستند.
invalidValue (400) snippetNeeded برای ایجاد بخش کانال باید snippet را مشخص کنید.
invalidValue (400) titleLengthExceeded مقدار خصوصیت snippet.title خیلی طولانی است.
invalidValue (400) titleRequired اگر ویژگی snippet.type دارای مقدار multiplePlaylists یا multipleChannels باشد، باید عنوان بخش را با مشخص کردن مقداری برای ویژگی snippet.title تنظیم کنید.
notFound (404) channelNotFound یک یا چند کانال مشخص‌شده پیدا نشد.
notFound (404) playlistNotFound یک یا چند فهرست پخش مشخص‌شده پیدا نشد.

channelSections.list

نوع خطا جزئیات خطا شرح
forbidden (403) channelSectionForbidden درخواست‌کننده مجاز به دسترسی به بخش‌های کانال درخواستی نیست.
invalidValue (400) idInvalid درخواست شناسه بخش کانال نامعتبری را مشخص می‌کند.
invalidValue (400) invalidCriteria درخواست تکمیل نشد زیرا معیارهای فیلتر نامعتبر است.
notFound (404) channelNotFound کانال مرتبط با درخواست پیدا نشد.
notFound (404) channelSectionNotFound بخش کانال مرتبط با درخواست پیدا نشد.

channelSections.update

نوع خطا جزئیات خطا شرح
badRequest (400) defaultLanguageNotSetError ویژگی snippet.defaultLanguage منبع channelSection باید تنظیم شود تا شیء localizations برای آن منبع باموفقیت درج یا به‌روز شود.
badRequest (400) invalidLanguage یکی از کلیدهای زبان شیء localizations اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر و به‌روزرسانی آن‌ها طبق دستورالعمل‌های موجود در مستندات منبع channelSections استفاده کنید.
badRequest (400) notEditable این بخش کانال قابل ویرایش نیست.
badRequest (400) styleRequired منبع channelSection باید مقداری برای فیلد snippet.style مشخص کند.
badRequest (400) targetInvalidCountry یکی از مقادیر موجود در فهرست targeting.countries اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر استفاده کنید و آن‌ها را طبق دستورالعمل‌های موجود در اسناد منبع channelSections به‌روز کنید.
badRequest (400) targetInvalidLanguage یکی از مقادیر در فهرست targeting.languages اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر و به‌روزرسانی آن‌ها طبق دستورالعمل‌های موجود در مستندات منبع channelSections استفاده کنید.
badRequest (400) targetInvalidRegion یکی از مقادیر در فهرست targeting.regions اعتبارسنجی نشد. از روش channelSections.list برای بازیابی مقادیر معتبر و به‌روزرسانی آن‌ها طبق دستورالعمل‌های موجود در مستندات منبع channelSections استفاده کنید.
badRequest (400) typeRequired منبع channelSection باید مقداری برای فیلد snippet.type مشخص کند.
forbidden (403) channelSectionForbidden درخواست به‌درستی اصالت‌سنجی نشده است یا برای این کانال پشتیبانی نمی‌شود.
invalidValue (400) channelNotActive حداقل یکی از کانال‌های مشخص‌شده فعال نیست.
invalidValue (400) channelsDuplicated درخواست ناموفق بود زیرا کانال‌های تکراری را مشخص کرده بود.
invalidValue (400) channelsNeeded اگر دارایی snippet.type دارای مقدار multipleChannels باشد، دارایی contentDetails.channels[] باید مشخص شود و باید حداقل یک کانال را مشخص کند.
invalidValue (400) channelsNotExpected منبع ارائه‌شده با درخواست، مقداری را برای دارایی contentDetails.channels[] مشخص کرده است، اما کانال‌ها برای این نوع بخش کانال موردانتظار نیستند.
invalidValue (400) contentDetailsNeeded منبعی که به‌روزرسانی می‌کنید باید حاوی شیء contentDetails برای این نوع بخش کانال باشد.
invalidValue (400) idInvalid ویژگی id شناسه بخش کانال نامعتبری را مشخص می‌کند.
invalidValue (400) idRequired ویژگی id باید مقداری را مشخص کند که بخش کانال درحال به‌روزرسانی را شناسایی کند.
invalidValue (400) inValidPosition ویژگی snippet.position حاوی مقدار نامعتبر است.
invalidValue (400) maxChannelsExceeded درخواست ناموفق بود زیرا تلاش کرد کانال‌های زیادی را در بخش کانال اضافه کند.
invalidValue (400) maxPlaylistExceeded درخواست ناموفق بود زیرا تلاش کرد تا فهرست‌های پخش زیادی را در بخش کانال اضافه کند.
invalidValue (400) onePlaylistNeeded اگر خصوصیت snippet.type دارای مقدار singlePlaylist باشد، خصوصیت contentDetails.playlists[] باید دقیقاً یک فهرست پخش را مشخص کند.
invalidValue (400) ownChannelInChannels نمی‌توانید کانال خودتان را در بخش کانالی که در آن کانال نشان داده می‌شود بگنجانید.
invalidValue (400) playlistIsPrivate یک یا چند فهرست پخش مشخص‌شده خصوصی هستند و بنابراین نمی‌توانند در بخش کانال قرار بگیرند.
invalidValue (400) playlistsDuplicated درخواست ناموفق بود زیرا فهرست‌های پخش تکراری را مشخص کرده است.
invalidValue (400) playlistsNeeded اگر مقدار دارایی snippet.type برابر با singlePlaylist یا multiplePlaylists باشد، دارایی contentDetails.playlists[] باید مشخص شود.
invalidValue (400) playlistsNotExpected منبع ارائه‌شده با درخواست، مقداری را برای ویژگی contentDetails.playlists[] مشخص کرده است، اما فهرست‌های پخش برای این نوع بخش کانال مورد انتظار نیستند.
invalidValue (400) snippetNeeded برای به‌روزرسانی بخش کانال باید snippet را مشخص کنید.
invalidValue (400) titleLengthExceeded مقدار دارایی snippet.title خیلی طولانی است.
invalidValue (400) titleRequired اگر ویژگی snippet.type دارای مقدار multiplePlaylists یا multipleChannels باشد، باید عنوان بخش را با مشخص کردن مقداری برای ویژگی snippet.title تنظیم کنید.
notFound (404) channelNotFound یک یا چند کانال مشخص‌شده پیدا نشد.
notFound (404) channelSectionNotFound بخش کانالی که می‌خواهید به‌روز کنید پیدا نشد.
notFound (404) playlistNotFound یک یا چند فهرست پخش مشخص‌شده پیدا نشد.

کانال‌ها

جدول‌های زیر پیام‌های خطایی را که API در پاسخ به تماس‌های مربوط به منابع channels برمی‌گرداند شناسایی می‌کنند. این روش‌ها همچنین می‌توانند خطاهای فهرست‌شده در بخش خطاهای رایج درخواست را برگردانند.

channels.list

نوع خطا جزئیات خطا شرح
badRequest (400) invalidCriteria حداکثر یکی از فیلترهای زیر را می‌توان مشخص کرد:id، mySubscribers، categoryId، mine، managedByMe، forUsername. درصورت اصالت‌سنجی مالک محتوا بااستفاده از پارامتر onBehalfOfContentOwner، فقط id یا managedByMe را می‌توانید مشخص کنید.
forbidden (403) channelForbidden کانال مشخص‌شده توسط پارامتر id از درخواست پشتیبانی نمی‌کند یا درخواست به‌درستی مجاز نشده است.
notFound (404) categoryNotFound دسته‌ای که با پارامتر categoryId شناسایی شده است پیدا نمی‌شود.
notFound (404) channelNotFound کانال مشخص‌شده در پارامتر id پیدا نشد.

channels.update

نوع خطا جزئیات خطا شرح
badRequest (400) brandingValidationError یکی از مقادیر موجود در شیء brandingSettings اعتبارسنجی نشد. از روش channels.list برای بازیابی تنظیمات موجود کانال استفاده کنید و مقادیر دارایی را طبق رهنمودهای مستندات منبع channels به‌روز کنید.
badRequest (400) channelTitleUpdateForbidden هنگام به‌روزرسانی brandingSettings part کانال، باید مقدار ویژگی brandingSettings.channel.title را روی عنوان فعلی کانال تنظیم کنید یا ویژگی را حذف کنید. اگر مقدار ویژگی را تغییر دهید، API خطایی را برمی‌گرداند.
badRequest (400) defaultLanguageNotSetError defaultLanguage باید برای به‌روزرسانی localizations تنظیم شود.
badRequest (400) invalidBrandingOption یکی از تنظیمات نمانام‌سازی که مشخص کرده‌اید وجود ندارد. از روش channels.list برای بازیابی مقادیر معتبر استفاده کنید و حتماً آن‌ها را طبق دستورالعمل‌های موجود در سند منبع channels به‌روز کنید.
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 سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند موقتی باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است. ساختار منبع 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 سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند موقتی باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است. ساختار منبع commentThread را در بدنه درخواست بررسی کنید تا مطمئن شوید معتبر است.
forbidden (403) forbidden رشته نظر به‌دلیل اجازه‌های ناکافی ایجاد شد. درخواست ممکن است به‌درستی مجاز نشده باشد.
forbidden (403) ineligibleAccount حساب YouTube استفاده‌شده برای مجاز کردن درخواست API باید با «حساب Google» کاربر ادغام شود تا بتواند نظر یا رشته نظر درج کند.
notFound (404) channelNotFound کانال مشخص‌شده پیدا نشد. مقدار دارایی snippet.channelId را بررسی کنید تا مطمئن شوید درست است.
notFound (404) videoNotFound ویدیو مشخص‌شده پیدا نشد. مقدار ویژگی snippet.videoId را بررسی کنید تا مطمئن شوید درست است.

نظرات

جدول‌های زیر پیام‌های خطایی را که «میانای برنامه‌سازی کاربردی» در پاسخ به تماس‌های مربوط به منابع comments برمی‌گرداند مشخص می‌کنند. این روش‌ها همچنین می‌توانند خطاهای فهرست‌شده در بخش خطاهای رایج درخواست را برگردانند.

comments.list

نوع خطا جزئیات خطا شرح
badRequest (400) operationNotSupported درخواست 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 سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند موقتی باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است.
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 نظر اصلی مشخص‌شده خصوصی است. میانای برنامه‌سازی کاربردی از پاسخ به نظرات خصوصی پشتیبانی نمی‌کند.
badRequest (400) parentIdMissing نظری که درج می‌شود باید به نظر اصلی پیوند داده شود. بااین‌حال، منبع comment در بدنه درخواست میانای برنامه‌سازی کاربردی مقداری برای ویژگی snippet.parentId مشخص نکرده است.
badRequest (400) processingFailure سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند گذرا باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است. ساختار منبع comment را در بدنه درخواست بررسی کنید تا مطمئن شوید معتبر است.
forbidden (403) forbidden به‌دلیل نداشتن اجازه‌های کافی، نظر ایجاد نشد. درخواست ممکن است به‌درستی مجاز نشده باشد.
forbidden (403) ineligibleAccount حساب YouTube استفاده‌شده برای مجاز کردن درخواست API باید با «حساب Google» کاربر ادغام شود تا بتواند نظر یا رشته نظر درج کند.
notFound (404) parentCommentNotFound نظر والد مشخص‌شده پیدا نشد. مقدار ویژگی snippet.parentId را در بدنه درخواست بررسی کنید تا مطمئن شوید درست است.

comments.delete

نوع خطا جزئیات خطا شرح
badRequest (400) processingFailure سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند گذرا باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است.
forbidden (403) forbidden نظر به‌دلیل نداشتن اجازه‌های کافی حذف نشد. ممکن است درخواست به‌درستی مجاز نشده باشد.
notFound (404) commentNotFound نظر مشخص‌شده پیدا نشد. مقدار پارامتر id درخواست را بررسی کنید تا مطمئن شوید درست است.

comments.update

نوع خطا جزئیات خطا شرح
badRequest (400) commentTextTooLong منبع comment که درحال به‌روزرسانی است، نویسه‌های بسیار زیادی در ویژگی snippet.textOriginal دارد.
badRequest (400) invalidCommentMetadata فراداده درخواست نامعتبر است.
badRequest (400) operationNotSupported درخواست API نامعتبر است یا قالب آن درست نیست. درنتیجه، سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را درک کند.
badRequest (400) processingFailure سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را با موفقیت پردازش کند. اگرچه این خطا می‌تواند گذرا باشد، اما معمولاً نشان می‌دهد که ورودی درخواست نامعتبر است. ساختار منبع 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 بیش‌از ۱۰۰ کانال را مشخص کند.

membershipsLevels

جدول‌های زیر پیام‌های خطایی را که «میانای برنامه‌سازی کاربردی» در پاسخ به تماس‌های مربوط به منابع members برمی‌گرداند مشخص می‌کنند. این روش‌ها همچنین می‌توانند خطاهای فهرست‌شده در بخش خطاهای رایج درخواست را برگردانند.

membershipsLevels.list

نوع خطا جزئیات خطا شرح
badRequest (400) channelMembershipsNotEnabled کانال محتواسازی که درخواست را مجاز می‌کند عضویت کانال را فعال نکرده است.

playlistItems

جدول‌های زیر پیام‌های خطایی را که API در پاسخ به تماس‌های مربوط به منابع playlistItems برمی‌گرداند شناسایی می‌کنند. این روش‌ها همچنین می‌توانند خطاهای فهرست‌شده در بخش خطاهای رایج درخواست را برگردانند.

playlistItems.delete

نوع خطا جزئیات خطا شرح
forbidden (403) playlistItemsNotAccessible درخواست برای حذف مورد فهرست پخش مشخص‌شده به‌درستی مجاز نیست.
notFound (404) playlistItemNotFound مورد فهرست پخش شناسایی‌شده با پارامتر id درخواست پیدا نشد.
invalidValue (400) playlistOperationUnsupported «میانای برنامه‌سازی کاربردی» از قابلیت حذف ویدیوها از فهرست پخش مشخص‌شده پشتیبانی نمی‌کند. برای مثال، نمی‌توانید ویدیویی را از فهرست پخش ویدیوهای بارگذاری‌شده خود حذف کنید.

playlistItems.insert

نوع خطا جزئیات خطا شرح
duplicate videoAlreadyInPlaylist ویدیویی که می‌خواهید به فهرست پخش اضافه کنید، قبلاً در فهرست پخش وجود دارد.
forbidden (403) playlistContainsMaximumNumberOfVideos فهرست پخش ازقبل حاوی حداکثر تعداد مجاز موارد است.
forbidden (403) playlistItemsNotAccessible درخواست برای درج عنصر فهرست پخش مشخص‌شده به‌درستی مجاز نشده است.
invalidValue (400) invalidContentDetails خصوصیت contentDetails در درخواست معتبر نیست. یک دلیل احتمالی این است که فیلد contentDetails.note طولانی‌تر از ۲۸۰ نویسه است.
invalidValue (400) invalidPlaylistItemPosition درخواست تلاش می‌کند موقعیت عنصر فهرست پخش را روی مقدار نامعتبر یا پشتیبانی‌نشده تنظیم کند. مقدار ویژگی position را در snippet منبع بررسی کنید.
invalidValue (400) invalidResourceType ‫type مشخص‌شده برای شناسه منبع برای این عملیات پشتیبانی نمی‌شود. شناسه منبع، موردی را که به فهرست پخش اضافه می‌شود شناسایی می‌کند – مانند youtube#video.
invalidValue (400) manualSortRequired درخواست تلاش می‌کند موقعیت عنصر فهرست پخش را تنظیم کند، اما فهرست پخش از مرتب‌سازی دستی استفاده نمی‌کند. (برای مثال، موارد فهرست پخش ممکن است براساس تاریخ یا محبوبیت مرتب شوند.) می‌توانید با برداشتن عنصر snippet.position از منبعی که درخواست درج می‌کند، خطا را برطرف کنید. اگر می‌خواهید عنصر فهرست پخش در موقعیت خاصی در فهرست قرار بگیرد، ابتدا باید گزینه ترتیب فهرست پخش را در تنظیمات فهرست پخش به دستی به‌روزرسانی کنید. این تنظیمات را می‌توان در مدیر ویدیو YouTube تغییر داد.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist ویدیویی که تلاش می‌کنید به فهرست پخش اضافه کنید، قبلاً در یکی دیگر از فهرست‌های پخش مجموعه‌ها وجود دارد.
invalidValue (400) playlistOperationUnsupported میانای برنامه‌سازی کاربردی از قابلیت درج ویدیو در فهرست پخش مشخص‌شده پشتیبانی نمی‌کند. برای مثال، نمی‌توانید ویدیویی را در فهرست پخش ویدیوهای بارگذاری‌شده‌تان درج کنید.
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 میانای برنامه‌سازی کاربردی از قابلیت فهرست کردن ویدیوها در فهرست پخش مشخص‌شده پشتیبانی نمی‌کند. برای مثال، نمی‌توانید ویدیویی را در فهرست پخش «تماشا در فرصتی دیگر» خود فهرست کنید.

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 میانای برنامه‌سازی کاربردی از قابلیت حذف فهرست پخش مشخص‌شده پشتیبانی نمی‌کند. برای مثال، نمی‌توانید فهرست پخش ویدیوهای بارگذاری‌شده خود را حذف کنید.

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 میانای برنامه‌سازی کاربردی از قابلیت به‌روزرسانی فهرست پخش مشخص‌شده پشتیبانی نمی‌کند. برای مثال، نمی‌توانید ویژگی‌های فهرست پخش ویدیوهای بارگذاری‌شده خود را به‌روز کنید.
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 حد بارگذاری روزانه ویدیو کانال به‌پایان رسیده است. این یک محدودیت پلاتفرم 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 شناسه دسته نامعتبری را مشخص می‌کند. از روش 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 روی مقدار نامعتبر تنظیم شده باشد.