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 کاربر احراز هویت شده نمی‌تواند از طرف حساب گوگل مشخص شده اقدام کند.
forbidden (403) authenticatedUserAccountClosed حساب یوتیوب کاربر احراز هویت شده بسته شده است. در صورتی که کاربر احراز هویت شده از طرف یک حساب گوگل دیگر عمل کند، این خطا به حساب گوگل دوم مربوط می‌شود.
forbidden (403) authenticatedUserAccountSuspended حساب یوتیوب کاربر احراز هویت شده به حالت تعلیق درآمده است. در صورتی که کاربر احراز هویت شده از طرف یک حساب گوگل دیگر فعالیت کند، این خطا به حساب گوگل دوم مربوط می‌شود.
forbidden (403) authenticatedUserNotChannel برای این درخواست، کاربر احراز هویت شده باید به یک کانال متصل شود، اما این اتفاق نمی‌افتد. اگر درخواست شما احراز هویت شده است و از پارامتر واگذاری onBehalfOfContentOwner استفاده می‌کند، باید پارامتر onBehalfOfContentOwnerChannel را نیز تنظیم کنید.
forbidden (403) channelClosed کانال مشخص شده در درخواست بسته شده است.
forbidden (403) channelNotFound کانال مشخص شده در درخواست یافت نشد.
forbidden (403) channelSuspended کانال مشخص شده در درخواست به حالت تعلیق درآمده است.
forbidden (403) cmsUserAccountNotFound کاربر CMS مجاز به اقدام از طرف مالک محتوای مشخص شده نیست.
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 در درخواست‌هایی که کاربر احراز هویت شده، یک همکار یوتیوب است، قابل استفاده نیست. شما باید یا پارامتر mine را حذف کنید، یا با حذف پارامتر 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 این خطا نشان می‌دهد که کاربر یک حساب گوگل بدون لینک دارد، به این معنی که کاربر یک حساب گوگل دارد اما کانال یوتیوب ندارد. چنین کاربرانی می‌توانند به بسیاری از ویژگی‌هایی که وابسته به مجوز کاربر هستند، مانند رتبه‌بندی ویدیوها یا اضافه کردن ویدیوها به لیست پخش watch_later دسترسی داشته باشند. با این حال، به عنوان مثال، کاربر برای آپلود ویدیو به یک کانال یوتیوب نیاز دارد. کاربری که یک حساب جیمیل یا یک دستگاه اندروید دارد، مطمئناً یک حساب گوگل دارد اما ممکن است قبلاً آن حساب گوگل را به یک کانال یوتیوب لینک نکرده باشد.

این خطا معمولاً در صورت تلاش برای استفاده از جریان حساب سرویس OAuth 2.0 مشاهده می‌شود. یوتیوب از حساب‌های سرویس پشتیبانی نمی‌کند و اگر سعی کنید با استفاده از یک حساب سرویس احراز هویت کنید، با این خطا مواجه خواهید شد.

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

activities

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

activities.list

نوع خطا جزئیات خطا توضیحات
forbidden (403) homeParameterDeprecated داده‌های فعالیت صفحه اصلی کاربر از طریق این API در دسترس نیست. اگر پارامتر home را در یک درخواست غیرمجاز روی true تنظیم کنید، ممکن است این خطا رخ دهد.
forbidden (403) forbidden درخواست به درستی تأیید نشده است.
notFound (404) channelNotFound شناسه کانال شناسایی شده توسط پارامتر channelId درخواست، یافت نمی‌شود.
notFound (404) homeChannelNotFound فید صفحه اصلی یوتیوب برای کاربر احراز هویت شده فعلی یافت نمی‌شود.
unauthorized (401) authorizationRequired درخواست از پارامتر home استفاده می‌کند اما به درستی مجاز نیست.

captions

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

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 آلبوم هنری کانال یوتیوب شما تصاویر زیادی دارد. لطفاً به http://photos.google.com بروید، به صفحه آلبوم‌ها بروید و برخی از تصاویر را از آن آلبوم حذف کنید.
badRequest (400) mediaBodyRequired درخواست شامل محتوای تصویر نمی‌شود.

channelSections

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

channelSections.delete

نوع خطا جزئیات خطا توضیحات
badRequest (400) notEditable این بخش از کانال قابل حذف نیست.
forbidden (403) channelSectionForbidden درخواست به درستی احراز هویت نشده یا برای این کانال پشتیبانی نمی‌شود.
invalidValue (400) idInvalid ویژگی id یک شناسه بخش کانال نامعتبر را مشخص می‌کند.
invalidValue (400) idRequired ویژگی id باید مقداری را مشخص کند که بخش کانالی که حذف می‌شود را مشخص کند.
notFound (404) channelNotFound کانال مورد نظر یافت نشد.
notFound (404) channelSectionNotFound بخش کانالی که می‌خواهید به‌روزرسانی کنید، پیدا نمی‌شود.

channelSections.insert

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

channelSections.list

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

channelSections.update

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

channels

جداول زیر پیام‌های خطایی را که 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 اعتبارسنجی یکی از مقادیر موجود در شیء localizations با شکست مواجه شد. از متد channels.list برای بازیابی مقادیر معتبر استفاده کنید و مطمئن شوید که آنها را طبق دستورالعمل‌های موجود در مستندات منابع channels به‌روزرسانی می‌کنید.
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 متادیتای درخواست باید یک زمان‌بندی پیش‌فرض را مشخص کند تا یوتیوب بتواند زمان نمایش آیتم تبلیغ‌شده را تعیین کند. مقدار ویژگی invideoPromotion.defaultTiming.offsetMs را در منبعی که درخواست ارسال می‌کند، تنظیم کنید.
required (400) requiredTimingOffset متادیتای درخواست باید یک فاصله زمانی مشخص کند تا یوتیوب بتواند زمان نمایش آیتم تبلیغ‌شده را تعیین کند. مقدار ویژگی invideoPromotion.timing.offsetMs را در منبعی که درخواست ارسال می‌کند، تنظیم کنید.
required (400) requiredTimingType متادیتای درخواست باید یک روش زمان‌بندی را مشخص کند تا یوتیوب بتواند زمان نمایش آیتم تبلیغ‌شده را تعیین کند. مقدار ویژگی invideoPromotion.defaultTiming.type را در منبعی که درخواست ارسال می‌کند، تنظیم کنید.
required (400) requiredTimingType متادیتای درخواست باید یک روش زمان‌بندی را مشخص کند تا یوتیوب بتواند زمان نمایش آیتم تبلیغ‌شده را تعیین کند. مقدار ویژگی invideoPromotion.timing.type را در منبعی که درخواست ارسال می‌کند، تنظیم کنید.
required (400) requiredTiming متادیتای درخواست باید برای هر مورد در بخش invideoPromotion زمان‌بندی مشخص کند.
required (400) requiredVideoId فراداده درخواست باید یک شناسه ویدیویی را برای شناسایی آیتم تبلیغ‌شده مشخص کند.
required (400) requiredWebsiteUrl متادیتای درخواست باید در بخش invideoPromotion، یک URL وب‌سایت را مشخص کند. مقدار ویژگی 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 حساب یوتیوبی که برای تأیید درخواست API استفاده می‌شود، باید با حساب گوگل کاربر ادغام شود تا بتوان نظر یا رشته نظر را درج کرد.
notFound (404) channelNotFound کانال مشخص شده پیدا نشد. مقدار ویژگی snippet.channelId را بررسی کنید تا مطمئن شوید که صحیح است.
notFound (404) videoNotFound ویدیوی مشخص شده پیدا نشد. مقدار ویژگی snippet.videoId را بررسی کنید تا مطمئن شوید که صحیح است.

comments

جداول زیر پیام‌های خطایی را که 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 حساب یوتیوبی که برای تأیید درخواست API استفاده می‌شود، باید با حساب گوگل کاربر ادغام شود تا بتوان نظر یا رشته نظر را درج کرد.
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 حساب یوتیوبی که برای تأیید درخواست API استفاده می‌شود، باید با حساب گوگل کاربر ادغام شود تا یک نظر یا رشته نظر به‌روزرسانی شود.
notFound (404) commentNotFound نظر مشخص شده یافت نشد. مقدار ویژگی id را در بدنه درخواست بررسی کنید تا از صحت آن اطمینان حاصل کنید.

members

جداول زیر پیام‌های خطایی را که 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

جداول زیر پیام‌های خطایی را که 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 بیش از ۲۸۰ کاراکتر دارد.
invalidValue (400) invalidPlaylistItemPosition این درخواست تلاش می‌کند موقعیت آیتم لیست پخش را روی مقداری نامعتبر یا پشتیبانی نشده تنظیم کند. مقدار ویژگی position را در snippet کد منبع بررسی کنید.
invalidValue (400) invalidResourceType type مشخص شده برای شناسه منبع برای این عملیات پشتیبانی نمی‌شود. شناسه منبع، آیتمی را که به لیست پخش اضافه می‌شود شناسایی می‌کند - مانند youtube#video .
invalidValue (400) manualSortRequired درخواست سعی می‌کند موقعیت آیتم لیست پخش را تنظیم کند، اما لیست پخش از مرتب‌سازی دستی استفاده نمی‌کند. (برای مثال، آیتم‌های لیست پخش ممکن است بر اساس تاریخ یا محبوبیت مرتب شده باشند.) می‌توانید با حذف عنصر snippet.position از منبعی که درخواست در حال وارد کردن آن است، این خطا را برطرف کنید. اگر می‌خواهید آیتم لیست پخش موقعیت خاصی در لیست داشته باشد، ابتدا باید گزینه مرتب‌سازی لیست پخش را در تنظیمات لیست پخش به دستی به‌روزرسانی کنید. این تنظیمات را می‌توان در مدیریت ویدیوی یوتیوب تنظیم کرد.
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 The API does not support the ability to list videos in the specified playlist. For example, you can't list a video in your watch later playlist.

playlistItems.update

نوع خطا Error detail توضیحات
forbidden (403) playlistItemsNotAccessible The request is not properly authorized to update the specified playlist item.
invalidValue (400) invalidPlaylistItemPosition The request attempts to set the playlist item's position to an invalid or unsupported value. Check the value of the position property in the resource's snippet .
invalidValue (400) invalidResourceType The type specified for the resource ID is not supported for this operation. The resource ID identifies the item being added to the playlist – such as youtube#video .
invalidValue (400) invalidSnippet The request does not specify a valid snippet property.
invalidValue (400) manualSortRequired The request attempts to set the playlist item's position, but the playlist does not use manual sorting. (For example, playlist items might be sorted by date or popularity.) You can address the error by removing the snippet.position element from the resource that the request is inserting. If you want the playlist item to have a particular position in the list, you need to first update the playlist's Ordering option to Manual in the playlist's settings. This settings can be adjusted in the YouTube Video Manager .
invalidValue (400) playlistOperationUnsupported The API does not support the ability to update videos in the specified playlist. For example, you can't update a video in your uploaded videos playlist.
notFound (404) playlistItemNotFound The playlist item identified with the request's id property cannot be found.
notFound (404) playlistNotFound The playlist identified with the request's playlistId parameter cannot be found.
required (400) channelIdRequired The request does not specify a value for the required channelId property.
required (400) playlistIdRequired The request does not specify a value for the required playlistId property.
required (400) playlistItemIdRequired The playlist item resource specified in the request must use the id property to identify the playlist item that is being updated.

playlists

The following tables identify error messages that the API returns in response to calls related to playlists resources. These methods could also return errors listed in the Common request errors section.

playlists.delete

نوع خطا Error detail توضیحات
forbidden (403) playlistForbidden This operation is forbidden or the request is not properly authorized.
notFound (404) playlistNotFound The playlist identified with the request's id parameter cannot be found.
invalidValue (400) playlistOperationUnsupported The API does not support the ability to delete the specified playlist. For example, you can't delete your uploaded videos playlist.

playlists.list

نوع خطا Error detail توضیحات
forbidden (403) channelClosed The channel specified in the channelId parameter has been closed.
forbidden (403) channelSuspended The channel specified in the channelId parameter has been suspended.
forbidden (403) playlistForbidden The playlist identified with the request's id parameter does not support the request or the request is not properly authorized.
notFound (404) channelNotFound The channel specified in the channelId parameter cannot be found.
notFound (404) playlistNotFound The playlist identified with the request's id parameter cannot be found.
invalidValue (400) playlistOperationUnsupported The API does not support the ability to list the specified playlist. For example, you can't list your watch later playlist.

playlists.insert

نوع خطا Error detail توضیحات
badRequest (400) defaultLanguageNotSetError The defaultLanguage must be set to update localizations .
badRequest (400) localizationValidationError One of the values in the localizations object failed validation. Use the playlists.list method to retrieve valid values and make sure to update them following the guidelines in the playlists resource documentation.
badRequest (400) maxPlaylistExceeded The playlist cannot be created because the channel already has the maximum number of playlists allowed.
forbidden (403) playlistForbidden This operation is forbidden or the request is not properly authorized.
invalidValue (400) invalidPlaylistSnippet The request provides an invalid playlist snippet.
required (400) playlistTitleRequired The request must specify a playlist title.

playlists.update

نوع خطا Error detail توضیحات
badRequest (400) defaultLanguageNotSetError The defaultLanguage must be set to update localizations .
badRequest (400) localizationValidationError One of the values in the localizations object failed validation. Use the playlists.list method to retrieve valid values and make sure to update them following the guidelines in the playlists resource documentation.
forbidden (403) playlistForbidden This operation is forbidden or the request is not properly authorized.
invalidValue (400) invalidPlaylistSnippet The request provides an invalid playlist snippet.
invalidValue (400) playlistOperationUnsupported The API does not support the ability to update the specified playlist. For example, you can't update the properties of your uploaded videos playlist.
notFound (404) playlistNotFound The playlist identified with the request's id parameter cannot be found.
required (400) playlistTitleRequired The request must specify a playlist title.

subscriptions

The following tables identify error messages that the API returns in response to calls related to subscriptions resources. These methods could also return errors listed in the Common request errors section.

subscriptions.delete

نوع خطا Error detail توضیحات
forbidden (403) subscriptionForbidden The request is not properly authenticated or not supported for this channel.
notFound (404) subscriptionNotFound The subscription that you are trying to delete cannot be found. Check the value of the request's id parameter to ensure that it is correct.

subscriptions.insert

نوع خطا Error detail توضیحات
badRequest (400) subscriptionDuplicate The subscription that you are trying to create already exists.
badRequest (400) subscriptionForbidden You have reached your maximum number of subscriptions.
badRequest (400) subscriptionForbidden Too many recent subscriptions. Please try again in a few hours.
badRequest (400) subscriptionForbidden Subscribing to your own channel is not supported.
forbidden (403) subscriptionForbidden The request is not properly authenticated or not supported for this channel.
notFound (404) publisherNotFound The resource specified by the request's snippet.resourceId property cannot be found.
notFound (404) subscriberNotFound The subscriber identified with the request cannot be found.
required (400) publisherRequired The subscription resource specified in the request must use the snippet.resourceId property to identify the channel that is being subscribed to.

subscriptions.list

نوع خطا Error detail توضیحات
forbidden (403) accountClosed Subscriptions couldn't be retrieved because the subscriber's account is closed.
forbidden (403) accountSuspended Subscriptions couldn't be retrieved because the subscriber's account is suspended.
forbidden (403) subscriptionForbidden The requester isn't allowed to access the requested subscriptions.
notFound (404) subscriberNotFound The subscriber identified with the request cannot be found.

thumbnails

The following tables identify error messages that the API returns in response to calls related to thumbnails resources. These methods could also return errors listed in the Common request errors section.

thumbnails.set

نوع خطا Error detail توضیحات
badRequest (400) invalidImage The provided image content is invalid.
badRequest (400) mediaBodyRequired The request does not include the image content.
forbidden (403) forbidden The thumbnail can't be set for the specified video. The request might not be properly authorized.
forbidden (403) forbidden The authenticated user doesn't have permissions to upload and set custom video thumbnails.
notFound (404) videoNotFound The video that you are trying to insert a thumbnail image for cannot be found. Check the value of the request's videoId parameter to ensure that it is correct.
tooManyRequests (429) uploadRateLimitExceeded The channel has uploaded too many thumbnails recently. Please try the request again later.

videoAbuseReportReasons

The following tables identify error messages that the API returns in response to calls related to videoAbuseReportReasons resources. These methods could also return errors listed in the Common request errors section.

videoAbuseReportReasons.list

نوع خطا Error detail توضیحات
forbidden (403) forbidden Access forbidden. The request may not be properly authorized.

videoCategories

The following tables identify error messages that the API returns in response to calls related to videoCategories resources. These methods could also return errors listed in the Common request errors section.

videoCategories.list

نوع خطا Error detail توضیحات
notFound (404) videoCategoryNotFound The video category identified by the id parameter cannot be found. Use the videoCategories.list method to retrieve a list of valid values.

videos

The following tables identify error messages that the API returns in response to calls related to videos resources. These methods could also return errors listed in the Common request errors section.

videos.insert

نوع خطا Error detail توضیحات
badRequest (400) defaultLanguageNotSet The request is trying to add localized video details without specifying the default language of the video details.
badRequest (400) invalidCategoryId The snippet.categoryId property specifies an invalid category ID. Use the videoCategories.list method to retrieve supported categories.
badRequest (400) invalidDescription The request metadata specifies an invalid video description.
badRequest (400) invalidFilename The video filename specified in the Slug header is invalid.
badRequest (400) invalidPublishAt The request metadata specifies an invalid scheduled publishing time.
badRequest (400) invalidRecordingDetails The recordingDetails object in the request metadata specifies invalid recording details.
badRequest (400) invalidTags The request metadata specifies invalid video keywords.
badRequest (400) invalidTitle The request metadata specifies an invalid or empty video title.
badRequest (400) invalidVideoGameRating The request metadata specifies an invalid video game rating.
badRequest (400) invalidVideoMetadata The request metadata is invalid. This error occurs if the request updates the snippet part of a video resource but does not set a value for both the snippet.title and snippet.categoryId properties.
badRequest (400) mediaBodyRequired The request does not include the video content.
badRequest (400) uploadLimitExceeded The user has exceeded the number of videos they may upload.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting The request attempts to set an invalid license for the video.
forbidden (403) forbiddenPrivacySetting The request attempts to set an invalid privacy setting for the video.

videos.list

نوع خطا Error detail توضیحات
badRequest (400) videoChartNotFound The requested video chart is not supported or is not available.
forbidden (403) forbidden The request is not properly authorized to access video file or processing information. The fileDetails , processingDetails , and suggestions parts are only available to that video's owner.
forbidden (403) forbidden The request cannot access user rating information. This error may occur because the request is not properly authorized to use the myRating parameter.
notFound (404) videoNotFound The video that you are trying to retrieve cannot be found. Check the value of the request's id parameter to ensure that it is correct.

videos.delete

نوع خطا Error detail توضیحات
forbidden (403) forbidden The video that you are trying to delete cannot be deleted. The request might not be properly authorized.
notFound (404) videoNotFound The video that you are trying to delete cannot be found. Check the value of the request's id parameter to ensure that it is correct.

videos.update

نوع خطا Error detail توضیحات
badRequest (400) defaultLanguageNotSet The API request is trying to add localized video details without specifying the default language of the video details.
badRequest (400) invalidCategoryId The snippet.categoryId property specifies an invalid category ID. Use the videoCategories.list method to retrieve supported categories.
badRequest (400) invalidDefaultBroadcastPrivacySetting The request attempts to set an invalid privacy setting for the default broadcast.
badRequest (400) invalidDescription The request metadata specifies an invalid video description.
badRequest (400) invalidPublishAt The request metadata specifies an invalid scheduled publishing time.
badRequest (400) invalidRecordingDetails The recordingDetails object in the request metadata specifies invalid recording details.
badRequest (400) invalidTags The request metadata specifies invalid video keywords.
badRequest (400) invalidTitle The request metadata specifies an invalid or empty video title.
badRequest (400) invalidVideoMetadata The request metadata is invalid. This error occurs if the request updates the snippet part of a video resource but does not set a value for both the snippet.title and snippet.categoryId properties.
forbidden (403) forbidden Access forbidden. The request may not be properly authorized.
forbidden (403) forbiddenEmbedSetting The request attempts to set an invalid embed setting for the video. Some channels might not have permission to offer embedded players for live streams. See the YouTube Help Center for more information.
forbidden (403) forbiddenLicenseSetting The request attempts to set an invalid license for the video.
forbidden (403) forbiddenPrivacySetting The request attempts to set an invalid privacy setting for the video.
notFound (404) videoNotFound The video that you are trying to update cannot be found. Check the value of the id field in the request body to ensure that it is correct.

videos.rate

نوع خطا Error detail توضیحات
badRequest (400) emailNotVerified The user must verify their email address prior to rating.
badRequest (400) invalidRating The request contained an unexpected value for the rating parameter.
badRequest (400) videoPurchaseRequired Rental videos can only be rated by users who rented them.
forbidden (403) forbidden The video that you are trying to rate cannot be rated. The request might not be properly authorized.
forbidden (403) videoRatingDisabled The owner of the video that you are trying to rate has disabled ratings for that video.
notFound (404) videoNotFound The video that you are trying to rate cannot be found. Check the value of the request's id parameter to ensure that it is correct.

videos.reportAbuse

نوع خطا Error detail توضیحات
badRequest (400) invalidAbuseReason The request contained an unexpected value for the reason_id field, or a combination of the reason_id and secondary_reason_id fields.
badRequest (400) rateLimitExceeded The user has sent too many requests in a given timeframe.
forbidden (403) forbidden
notFound (404) videoNotFound The video that you are trying to report abuse for cannot be found.

watermarks

The following tables identify error messages that the API returns in response to calls related to watermarks resources. These methods could also return errors listed in the Common request errors section.

watermarks.set

نوع خطا Error detail توضیحات
badRequest (400) imageFormatUnsupported The image you provided is in an unsupported format.
badRequest (400) imageTooTall The image you provided is too tall.
badRequest (400) imageTooWide The image you provided is too wide.
badRequest (400) mediaBodyRequired The request does not include the image content.
forbidden (403) forbidden The watermark can't be set for the specified channel. The request may not be properly authorized, or the channelId parameter is set to an invalid value.

watermarks.unset

نوع خطا Error detail توضیحات
forbidden (403) forbidden The watermark can't be unset for the specified channel. The request may not be properly authorized, or the channelId parameter is set to an invalid value.