YouTube Data API - Errors

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

خطاهای عمومی

جداول زیر پیام های خطای API را مشخص می کند که مختص یک روش API خاص نیست.

Core API errors

نوع خطا جزئیات خطا توضیحات
forbidden (403) forbidden دسترسی ممنوع ممکن است درخواست به درستی مجاز نباشد.
quotaExceeded (403) quotaExceeded درخواست تکمیل نمی شود زیرا شما از سهمیه خود فراتر رفته اید.

Common request errors

نوع خطا جزئیات خطا توضیحات
badRequest (400) incompatibleParameters درخواست دو یا چند پارامتر را مشخص می‌کند که نمی‌توانند در یک درخواست استفاده شوند.
badRequest (400) invalidFilters درخواست یک پارامتر فیلتر نامعتبر را مشخص می کند.
badRequest (400) invalidPageToken درخواست یک نشانه صفحه نامعتبر را مشخص می کند.
badRequest (400) missingRequiredParameter درخواست یک پارامتر لازم را ندارد.
badRequest (400) unexpectedParameter درخواست یک پارامتر غیرمنتظره را مشخص می کند.
forbidden (403) accountDelegationForbidden کاربر تأیید شده نمی تواند از طرف حساب Google مشخص شده اقدام کند.
forbidden (403) authenticatedUserAccountClosed حساب YouTube کاربر احراز هویت شده بسته شده است. در صورتی که کاربر احراز هویت شده از طرف یک حساب Google دیگر اقدام کند، این خطا به حساب دومی مربوط می شود.
forbidden (403) authenticatedUserAccountSuspended حساب YouTube کاربر احراز هویت شده به حالت تعلیق درآمده است. در صورتی که کاربر احراز هویت شده از طرف یک حساب Google دیگر اقدام کند، این خطا به حساب دومی مربوط می شود.
forbidden (403) authenticatedUserNotChannel برای این درخواست، کاربر احراز هویت شده باید به یک کانال مراجعه کند، اما این کار را نمی کند. اگر درخواست شما احراز هویت شده است و از پارامتر واگذاری onBehalfOfContentOwner استفاده می کند، باید پارامتر onBehalfOfContentOwnerChannel را نیز تنظیم کنید.
forbidden (403) channelClosed کانال مشخص شده در درخواست بسته شده است.
forbidden (403) channelNotFound کانال مشخص شده در درخواست یافت نمی شود.
forbidden (403) channelSuspended کانال مشخص شده در درخواست به حالت تعلیق درآمده است.
forbidden (403) cmsUserAccountNotFound کاربر 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 را نمی توان در درخواست هایی که کاربر احراز هویت شده شریک YouTube است استفاده کرد. یا باید پارامتر mine را حذف کنید، به عنوان کاربر YouTube با حذف پارامتر onBehalfOfContentOwner احراز هویت کنید، یا در صورت موجود بودن برای روش فراخوانی شده، با ارائه پارامتر onBehalfOfContentOwnerChannel به عنوان یکی از کانال های شریک عمل کنید.
badRequest (400) invalidPart پارامتر part درخواست، قسمت هایی را مشخص می کند که نمی توانند همزمان نوشته شوند.
badRequest (400) invalidRegionCode پارامتر regionCode یک کد منطقه نامعتبر را مشخص می کند.
badRequest (400) unexpectedPart پارامتر part درخواست مقدار غیرمنتظره ای را مشخص می کند.
badRequest (400) unknownPart پارامتر part درخواست یک مقدار ناشناخته را مشخص می کند.
badRequest (400) unsupportedLanguageCode مقدار پارامتر hl یک کد زبان پشتیبانی شده را مشخص نمی کند.
badRequest (400) unsupportedRegionCode پارامتر regionCode یک کد منطقه پشتیبانی نشده را مشخص می کند.
unauthorized (401) authorizationRequired درخواست از پارامتر mine استفاده می کند اما به درستی مجاز نیست.
unauthorized (401) youtubeSignupRequired این خطا نشان می دهد که کاربر دارای یک حساب Google unlink نشده است، به این معنی که کاربر یک حساب Google دارد اما کانال YouTube ندارد. چنین کاربرانی می‌توانند به بسیاری از ویژگی‌های وابسته به مجوز کاربر دسترسی داشته باشند، مانند رتبه‌بندی ویدیوها یا افزودن ویدیوها به فهرست پخش watch_later . با این حال، به عنوان مثال، کاربر به یک کانال YouTube نیاز دارد تا بتواند یک ویدیو را آپلود کند. کاربری که یک حساب جیمیل یا یک دستگاه Android دارد مطمئناً یک حساب Google دارد اما ممکن است قبلاً آن حساب Google را به یک کانال YouTube مرتبط نکرده باشد.

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

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

activities

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

activities.list

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

captions

جداول زیر پیام های خطایی را مشخص می کند که API در پاسخ به تماس های مربوط به منابع captions باز می گرداند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common request errors را برگردانند.

captions.delete

نوع خطا جزئیات خطا توضیحات
forbidden (403) forbidden مجوزهای مرتبط با درخواست برای حذف تراک شرح کافی نیست. ممکن است درخواست به درستی مجاز نباشد.
notFound (404) captionNotFound تراک شرح یافت نشد. مقدار پارامتر id درخواست را بررسی کنید تا مطمئن شوید که درست است.

captions.download

نوع خطا جزئیات خطا توضیحات
forbidden (403) forbidden مجوزهای مرتبط با درخواست برای دانلود آهنگ شرح کافی نیست. ممکن است درخواست به درستی مجاز نباشد.
invalidValue (400) couldNotConvert داده‌های آهنگ شرح را نمی‌توان به زبان و/یا قالب درخواستی تبدیل کرد. اطمینان حاصل کنید که مقادیر tfmt و tlang درخواستی معتبر هستند و وضعیت snippet.status تراک عنوان درخواستی failed نیست.
notFound (404) captionNotFound تراک شرح یافت نشد. مقدار پارامتر id درخواست را بررسی کنید تا مطمئن شوید که درست است.

captions.insert

نوع خطا جزئیات خطا توضیحات
badRequest (400) contentRequired درخواست حاوی محتوای تراک شرح نیست.
conflict (409) captionExists ویدیوی مشخص شده از قبل دارای یک تراک شرح با snippet.language و snippet.name داده شده است. یک ویدیو می تواند چندین آهنگ برای یک زبان داشته باشد، اما هر آهنگ باید نام متفاوتی داشته باشد.

راه های متعددی برای رفع خطا وجود دارد. می توانید تراک موجود را حذف کنید و سپس آهنگ جدیدی را وارد کنید یا نام آهنگ جدید را قبل از درج آن تغییر دهید.
forbidden (403) forbidden مجوزهای مرتبط با درخواست برای آپلود تراک شرح کافی نیست. ممکن است درخواست به درستی مجاز نباشد.
invalidValue (400) invalidMetadata درخواست حاوی مقادیر فراداده نامعتبر است که از ایجاد مسیر جلوگیری می کند. تأیید کنید که درخواست مقادیر معتبری را برای ویژگی‌های snippet.language ، snippet.name و snippet.videoId مشخص می‌کند. ویژگی snippet.isDraft نیز می تواند گنجانده شود، اما لازم نیست.
notFound (404) videoNotFound ویدیوی شناسایی شده توسط پارامتر videoId یافت نشد.
invalidValue (400) nameTooLong snippet.name مشخص شده در درخواست خیلی طولانی است. حداکثر طول پشتیبانی شده 150 کاراکتر است.

captions.list

نوع خطا جزئیات خطا توضیحات
forbidden (403) forbidden یک یا چند تراک شرح بازیابی نشد زیرا مجوزهای مرتبط با درخواست برای بازیابی منابع درخواستی کافی نیست. ممکن است درخواست به درستی مجاز نباشد.
notFound (404) captionNotFound یک یا چند تراک شرح مشخص شده یافت نشد. اگر پارامتر videoId یک ویدیوی واقعی را شناسایی کند، این خطا رخ می‌دهد، اما پارامتر id یا شناسه‌های تراک شرح را که وجود ندارند یا شناسه‌های تراک مرتبط با ویدیوهای دیگر را شناسایی می‌کند. مقادیر پارامترهای id و videoId درخواست را بررسی کنید تا مطمئن شوید که درست هستند.
notFound (404) videoNotFound ویدیوی شناسایی شده توسط پارامتر videoId یافت نشد.

captions.update

نوع خطا جزئیات خطا توضیحات
badRequest (400) contentRequired این درخواست یک فایل شرح به‌روزرسانی آپلود نکرد. اگر پارامتر sync روی true تنظیم شود، محتوای آهنگ واقعی مورد نیاز است.
forbidden (403) forbidden مجوزهای مرتبط با درخواست برای به روز رسانی تراک شرح کافی نیست. ممکن است درخواست به درستی مجاز نباشد.
notFound (404) captionNotFound تراک شرح مشخص شده یافت نشد. مقدار پارامتر id درخواست را بررسی کنید تا مطمئن شوید که درست است.

channelBanners

جداول زیر پیام های خطایی را که API در پاسخ به تماس های مربوط به منابع channelBanners برمی گرداند، مشخص می کند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common request errors را برگردانند.

channelBanners.insert

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

channelSections

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

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

channelSections.list

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

channelSections.update

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

channels

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

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 شناسه کانال اخیراً آپلود شده توسط مشخص شده یافت نشد.
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 فراداده درخواست باید URL وب سایت را در قسمت invideoPromotion مشخص کند. مقدار ویژگی invideoPromotion.items[].id.websiteUrl را در منبعی که درخواست ارسال می کند، تنظیم کنید.

commentThreads

جداول زیر پیام های خطایی را مشخص می کند که API در پاسخ به تماس های مربوط به منابع commentThreads باز می گرداند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common request errors را برگردانند.

commentThreads.list

نوع خطا جزئیات خطا توضیحات
badRequest (400) operationNotSupported درخواست API نامعتبر است یا به درستی تشکیل نشده است. در نتیجه، سرور API نمی تواند درخواست را درک کند.
badRequest (400) processingFailure سرور API نتوانست درخواست را با موفقیت پردازش کند. در حالی که این می تواند یک خطای گذرا باشد، معمولاً نشان می دهد که ورودی درخواست نامعتبر است. ساختار منبع commentThread را در بدنه درخواست بررسی کنید تا مطمئن شوید که معتبر است.
forbidden (403) commentsDisabled ویدیویی که با پارامتر videoId شناسایی شده است، نظرات را غیرفعال کرده است.
forbidden (403) forbidden یک یا چند تا از رشته‌های نظر درخواستی به دلیل مجوزهای ناکافی قابل بازیابی نیستند. ممکن است درخواست به درستی مجاز نباشد.
notFound (404) channelNotFound کانال شناسایی شده توسط پارامتر allThreadsRelatedToChannelId یافت نشد.
notFound (404) commentThreadNotFound یک یا چند تا از رشته های نظر مشخص شده یافت نمی شود. مقادیر پارامتر id درخواست را بررسی کنید تا مطمئن شوید که درست است.
notFound (404) videoNotFound ویدیوی شناسایی شده توسط پارامتر videoId یافت نشد.

commentThreads.insert

نوع خطا جزئیات خطا توضیحات
badRequest (400) channelOrVideoIdMissing هر رشته نظر باید به یک کانال یا ویدیو پیوند داده شود. مطمئن شوید که منبع مقادیری را برای هر دو ویژگی snippet.channelId و snippet.videoId مشخص کرده است. یک نظر در مورد یک ویدیو در صفحه تماشای ویدیو ظاهر می شود.
badRequest (400) commentTextRequired منبع comment که در حال درج است باید مقداری را برای ویژگی snippet.topLevelComment.snippet.textOriginal مشخص کند. نظرات نمی توانند خالی باشند.
badRequest (400) commentTextTooLong منبع comment که در حال درج است حاوی تعداد زیادی کاراکتر در ویژگی snippet.topLevelComment.snippet.textOriginal است.
badRequest (400) invalidCommentThreadMetadata فراداده درخواست نامعتبر است.
badRequest (400) processingFailure سرور API نتوانست درخواست را با موفقیت پردازش کند. در حالی که این می تواند یک خطای گذرا باشد، معمولاً نشان می دهد که ورودی درخواست نامعتبر است. ساختار منبع commentThread را در بدنه درخواست بررسی کنید تا مطمئن شوید که معتبر است.
forbidden (403) forbidden موضوع نظر می تواند به دلیل مجوزهای ناکافی ایجاد شود. ممکن است درخواست به درستی مجاز نباشد.
forbidden (403) ineligibleAccount حساب YouTube مورد استفاده برای تأیید درخواست API باید با حساب Google کاربر ادغام شود تا یک نظر یا موضوع نظر درج شود.
notFound (404) channelNotFound کانال مشخص شده یافت نشد. مقدار ویژگی snippet.channelId را بررسی کنید تا مطمئن شوید که درست است.
notFound (404) videoNotFound ویدیوی مشخص شده یافت نشد. مقدار ویژگی snippet.videoId را بررسی کنید تا مطمئن شوید که درست است.

comments

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

comments.list

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

comments.setModerationStatus

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

comments.insert

نوع خطا جزئیات خطا توضیحات
badRequest (400) commentTextRequired منبع comment که در حال درج است باید مقداری را برای ویژگی snippet.textOriginal مشخص کند. نظرات نمی توانند خالی باشند.
badRequest (400) commentTextTooLong منبع comment که در حال درج است حاوی تعداد زیادی کاراکتر در ویژگی snippet.textOriginal است.
badRequest (400) invalidCommentMetadata فراداده درخواست نامعتبر است.
badRequest (400) operationNotSupported کاربر API قادر به درج نظر در پاسخ به نظر سطح بالای مشخص شده توسط ویژگی snippet.parentId نیست. در یک منبع commentThread ، ویژگی snippet.canReply نشان می دهد که آیا بیننده فعلی می تواند به رشته پاسخ دهد یا خیر.
badRequest (400) parentCommentIsPrivate نظر والدین مشخص شده خصوصی است. API از پاسخ به نظرات خصوصی پشتیبانی نمی کند.
badRequest (400) parentIdMissing نظری که درج می شود باید به نظر والدین پیوند داده شود. با این حال، منبع comment در بدنه درخواست API مقداری را برای ویژگی snippet.parentId مشخص نکرده است.
badRequest (400) processingFailure سرور API نتوانست درخواست را با موفقیت پردازش کند. در حالی که این می تواند یک خطای گذرا باشد، معمولاً نشان می دهد که ورودی درخواست نامعتبر است. ساختار منبع comment را در بدنه درخواست بررسی کنید تا از معتبر بودن آن اطمینان حاصل کنید.
forbidden (403) forbidden نظر به دلیل مجوزهای ناکافی ایجاد نمی شود. ممکن است درخواست به درستی مجاز نباشد.
forbidden (403) ineligibleAccount حساب YouTube مورد استفاده برای تأیید درخواست API باید با حساب Google کاربر ادغام شود تا یک نظر یا موضوع نظر درج شود.
notFound (404) parentCommentNotFound نظر والدین مشخص شده یافت نشد. مقدار ویژگی snippet.parentId را در بدنه درخواست بررسی کنید تا مطمئن شوید که درست است.

comments.delete

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

comments.update

نوع خطا جزئیات خطا توضیحات
badRequest (400) commentTextTooLong منبع comment که در حال به‌روزرسانی است حاوی نویسه‌های بسیار زیادی در ویژگی snippet.textOriginal است.
badRequest (400) invalidCommentMetadata فراداده درخواست نامعتبر است.
badRequest (400) operationNotSupported درخواست API نامعتبر است یا به درستی تشکیل نشده است. در نتیجه، سرور API نمی تواند درخواست را درک کند.
badRequest (400) processingFailure سرور API نتوانست درخواست را با موفقیت پردازش کند. در حالی که این می تواند یک خطای گذرا باشد، معمولاً نشان می دهد که ورودی درخواست نامعتبر است. ساختار منبع comment را در بدنه درخواست بررسی کنید تا از معتبر بودن آن اطمینان حاصل کنید.
forbidden (403) forbidden به دلیل مجوزهای ناکافی، نظر به‌روزرسانی نشد. ممکن است درخواست به درستی مجاز نباشد.
forbidden (403) ineligibleAccount حساب YouTube مورد استفاده برای تأیید درخواست API باید با حساب Google کاربر ادغام شود تا یک نظر یا موضوع نظر به‌روزرسانی شود.
notFound (404) commentNotFound نظر مشخص شده یافت نشد. مقدار ویژگی id را در بدنه درخواست بررسی کنید تا مطمئن شوید که درست است.

members

جداول زیر پیام های خطایی را مشخص می کند که API در پاسخ به تماس های مربوط به منابع members برمی گرداند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common request errors را برگردانند.

members.list

نوع خطا جزئیات خطا توضیحات
badRequest (400) channelMembershipsNotEnabled کانال سازنده که درخواست را تأیید می کند، عضویت کانال را فعال نمی کند.
badRequest (400) invalidMode مقدار پارامتر mode نامعتبر است. اگر پارامتر pageToken نشانه ای را مشخص کند که با استفاده از حالتی متفاوت از حالت مشخص شده بازیابی شده است، این خطا ممکن است رخ دهد.
badRequest (400) invalidPageToken مقدار پارامتر pageToken نامعتبر است. این خطا در صورتی رخ می دهد که توکن صفحه استفاده شده در درخواست منقضی شده باشد.
badRequest (400) invalidHasAccessToLevel مقدار پارامتر hasAccessToLevel نامعتبر است. هیچ سطحی با id مشخص شده وجود ندارد.
badRequest (400) invalidFilterByMemberChannelId مقدار پارامتر filterByMemberChannelId نامعتبر است. اگر مقدار پارامتر filterByMemberChannelId بیش از 100 کانال را مشخص کند این خطا رخ می دهد.

membershipsLevels

جداول زیر پیام های خطایی را مشخص می کند که API در پاسخ به تماس های مربوط به منابع members برمی گرداند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common request errors را برگردانند.

membershipsLevels.list

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

playlistItems

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

playlistItems.delete

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

playlistItems.insert

نوع خطا جزئیات خطا توضیحات
duplicate videoAlreadyInPlaylist ویدیویی که می‌خواهید به لیست پخش اضافه کنید، قبلاً در لیست پخش است.
forbidden (403) playlistContainsMaximumNumberOfVideos لیست پخش از قبل دارای حداکثر تعداد مجاز موارد است.
forbidden (403) playlistItemsNotAccessible درخواست به درستی برای درج مورد لیست پخش مشخص شده مجاز نیست.
invalidValue (400) invalidContentDetails ویژگی contentDetails در درخواست معتبر نیست. یک دلیل احتمالی این است که فیلد contentDetails.note بیشتر از 280 کاراکتر است.
invalidValue (400) invalidPlaylistItemPosition این درخواست تلاش می‌کند موقعیت مورد لیست پخش را روی یک مقدار نامعتبر یا پشتیبانی‌نشده تنظیم کند. مقدار ویژگی position را در snippet منبع بررسی کنید.
invalidValue (400) invalidResourceType type مشخص شده برای شناسه منبع برای این عملیات پشتیبانی نمی شود. شناسه منبع، موردی را که به لیست پخش اضافه می‌شود، شناسایی می‌کند - مانند youtube#video .
invalidValue (400) manualSortRequired درخواست سعی می‌کند موقعیت آیتم فهرست پخش را تنظیم کند، اما فهرست پخش از مرتب‌سازی دستی استفاده نمی‌کند. (به عنوان مثال، موارد لیست پخش ممکن است بر اساس تاریخ یا محبوبیت مرتب شوند.) می توانید با حذف عنصر snippet.position از منبعی که درخواست درج می کند، خطا را برطرف کنید. اگر می‌خواهید مورد لیست پخش موقعیت خاصی در لیست داشته باشد، ابتدا باید در تنظیمات لیست پخش، گزینه Ordering لیست پخش را به Manual به‌روزرسانی کنید. این تنظیمات را می توان در مدیر ویدیوی YouTube تنظیم کرد.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist ویدیویی که می‌خواهید به لیست پخش اضافه کنید در حال حاضر در لیست پخش مجموعه دیگری است.
invalidValue (400) playlistOperationUnsupported API از قابلیت درج ویدیوها در لیست پخش مشخص شده پشتیبانی نمی کند. برای مثال، نمی‌توانید ویدیویی را در لیست پخش ویدیوهای آپلود شده خود وارد کنید.
notFound (404) playlistNotFound لیست پخش شناسایی شده با پارامتر playlistId درخواست یافت نمی شود.
notFound (404) videoNotFound ویدیویی که می‌خواهید به لیست پخش اضافه کنید پیدا نمی‌شود. مقدار ویژگی videoId را بررسی کنید تا مطمئن شوید که درست است.
required (400) channelIdRequired درخواست مقداری برای ویژگی channelId مورد نیاز مشخص نمی کند.
required (400) playlistIdRequired درخواست مقدار خاص برای ویژگی playlistId مورد نیاز را مشخص نمی کند.
required (400) resourceIdRequired درخواست باید حاوی منبعی باشد که در آن شیء snippet یک resourceId مشخص کند.

playlistItems.list

نوع خطا جزئیات خطا توضیحات
forbidden (403) playlistItemsNotAccessible این درخواست به درستی مجاز به بازیابی لیست پخش مشخص شده نیست.
notFound (404) playlistNotFound لیست پخش مشخص شده با پارامتر playlistId درخواست یافت نمی شود.
notFound (404) videoNotFound ویدئویی که با پارامتر videoId درخواست مشخص شده است یافت نمی شود.
required (400) playlistIdRequired درخواست اشتراک ، مقداری برای ویژگی playlistId مورد نیاز مشخص نمی کند.
invalidValue (400) playlistOperationUnsupported API از توانایی لیست فیلم ها در لیست پخش مشخص شده پشتیبانی نمی کند. به عنوان مثال ، شما نمی توانید ویدئویی را در لیست پخش بعدی خود لیست کنید.

playlistItems.update

نوع خطا جزئیات خطا توضیحات
forbidden (403) playlistItemsNotAccessible این درخواست به درستی مجاز به به روزرسانی مورد لیست پخش شده نیست.
invalidValue (400) invalidPlaylistItemPosition این درخواست سعی دارد موقعیت مورد لیست پخش را به یک مقدار نامعتبر یا پشتیبانی نشده تنظیم کند. مقدار خاصیت position را در snippet منبع بررسی کنید.
invalidValue (400) invalidResourceType type مشخص شده برای شناسه منبع برای این عملیات پشتیبانی نمی شود. شناسه منبع موردی را که به لیست پخش اضافه می شود - مانند youtube#video - مشخص می کند.
invalidValue (400) invalidSnippet درخواست یک ویژگی خاص snippet را مشخص نمی کند.
invalidValue (400) manualSortRequired این درخواست سعی در تنظیم موقعیت مورد لیست پخش دارد ، اما لیست پخش از مرتب سازی دستی استفاده نمی کند. (به عنوان مثال ، موارد لیست پخش ممکن است براساس تاریخ یا محبوبیت طبقه بندی شود.) شما می توانید با حذف عنصر snippet.position از منبعی که درخواست درج شده است ، خطا را برطرف کنید. اگر می خواهید مورد لیست پخش موقعیت خاصی در لیست داشته باشد ، باید ابتدا گزینه سفارش لیست پخش را برای دستی در تنظیمات لیست پخش به روز کنید. این تنظیمات را می توان در مدیر ویدیوی YouTube تنظیم کرد.
invalidValue (400) playlistOperationUnsupported API از توانایی به روزرسانی فیلم ها در لیست پخش مشخص شده پشتیبانی نمی کند. به عنوان مثال ، شما نمی توانید یک فیلم را در لیست پخش فیلم های بارگذاری شده خود به روز کنید.
notFound (404) playlistItemNotFound مورد لیست پخش مشخص شده با ویژگی id درخواست یافت نمی شود.
notFound (404) playlistNotFound لیست پخش مشخص شده با پارامتر playlistId درخواست یافت نمی شود.
required (400) channelIdRequired درخواست مقداری برای ویژگی مورد نیاز channelId را مشخص نمی کند.
required (400) playlistIdRequired درخواست مقدار خاص برای ویژگی playlistId مورد نیاز را مشخص نمی کند.
required (400) playlistItemIdRequired منبع لیست لیست پخش شده در درخواست باید از ویژگی id برای شناسایی مورد لیست پخش که به روز می شود ، استفاده کند.

playlists

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

playlists.delete

نوع خطا جزئیات خطا توضیحات
forbidden (403) playlistForbidden این عملیات ممنوع است یا درخواست به درستی مجاز نیست.
notFound (404) playlistNotFound لیست پخش مشخص شده با پارامتر id درخواست یافت نمی شود.
invalidValue (400) playlistOperationUnsupported API از توانایی حذف لیست پخش مشخص شده پشتیبانی نمی کند. به عنوان مثال ، شما نمی توانید لیست پخش فیلم های بارگذاری شده خود را حذف کنید.

playlists.list

نوع خطا جزئیات خطا توضیحات
forbidden (403) channelClosed کانال مشخص شده در پارامتر channelId بسته شده است.
forbidden (403) channelSuspended کانال مشخص شده در پارامتر channelId به حالت تعلیق در آمده است.
forbidden (403) playlistForbidden لیست پخش مشخص شده با پارامتر id درخواست از درخواست پشتیبانی نمی کند یا درخواست به درستی مجاز نیست.
notFound (404) channelNotFound کانال مشخص شده در پارامتر channelId یافت نمی شود.
notFound (404) playlistNotFound لیست پخش مشخص شده با پارامتر id درخواست یافت نمی شود.
invalidValue (400) playlistOperationUnsupported API از توانایی لیست لیست پخش مشخص شده پشتیبانی نمی کند. به عنوان مثال ، شما نمی توانید لیست پخش بعدی ساعت خود را لیست کنید.

playlists.insert

نوع خطا جزئیات خطا توضیحات
badRequest (400) defaultLanguageNotSetError defaultLanguage باید برای به روزرسانی localizations تنظیم شود.
badRequest (400) localizationValidationError یکی از مقادیر موجود در شیء محلی ، اعتبارسنجی ناموفق بود. برای بازیابی مقادیر معتبر از روش Playlists.List استفاده کنید و حتماً آنها را به دنبال دستورالعمل های موجود در اسناد منابع لیست پخش کنید.
badRequest (400) maxPlaylistExceeded لیست پخش نمی تواند ایجاد شود زیرا کانال از قبل حداکثر تعداد لیست های پخش مجاز را دارد.
forbidden (403) playlistForbidden این عملیات ممنوع است یا درخواست به درستی مجاز نیست.
invalidValue (400) invalidPlaylistSnippet این درخواست یک قطعه لیست پخش نامعتبر را ارائه می دهد.
required (400) playlistTitleRequired درخواست باید عنوان لیست پخش را مشخص کند.

playlists.update

نوع خطا جزئیات خطا توضیحات
badRequest (400) defaultLanguageNotSetError defaultLanguage باید برای به روزرسانی localizations تنظیم شود.
badRequest (400) localizationValidationError یکی از مقادیر موجود در شیء محلی ، اعتبارسنجی ناموفق بود. برای بازیابی مقادیر معتبر از روش Playlists.List استفاده کنید و حتماً آنها را به دنبال دستورالعمل های موجود در اسناد منابع لیست پخش کنید.
forbidden (403) playlistForbidden این عملیات ممنوع است یا درخواست به درستی مجاز نیست.
invalidValue (400) invalidPlaylistSnippet این درخواست یک قطعه لیست پخش نامعتبر را ارائه می دهد.
invalidValue (400) playlistOperationUnsupported API از توانایی به روزرسانی لیست پخش مشخص شده پشتیبانی نمی کند. به عنوان مثال ، شما نمی توانید ویژگی های لیست پخش فیلم های بارگذاری شده خود را به روز کنید.
notFound (404) playlistNotFound لیست پخش مشخص شده با پارامتر id درخواست یافت نمی شود.
required (400) playlistTitleRequired درخواست باید عنوان لیست پخش را مشخص کند.

subscriptions

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

thumbnails

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

videos

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

videos.insert

نوع خطا جزئیات خطا توضیحات
badRequest (400) defaultLanguageNotSet این درخواست در تلاش است تا بدون مشخص کردن زبان پیش فرض جزئیات فیلم ، جزئیات ویدیوی بومی سازی شده را اضافه کند.
badRequest (400) invalidCategoryId ویژگی snippet.categoryId یک شناسه دسته نامعتبر را مشخص می کند. برای بازیابی دسته های پشتیبانی شده از روش videoCategories.list استفاده کنید.
badRequest (400) invalidDescription ابرداده درخواست توضیحات ویدئویی نامعتبر را مشخص می کند.
badRequest (400) invalidFilename نام پرونده ویدیویی که در عنوان Slug مشخص شده است نامعتبر است.
badRequest (400) invalidPublishAt ابرداده درخواست زمان انتشار برنامه ریزی شده نامعتبر را مشخص می کند.
badRequest (400) invalidRecordingDetails شیء recordingDetails در ابرداده درخواست جزئیات ضبط نامعتبر را مشخص می کند.
badRequest (400) invalidTags ابرداده درخواست کلمات کلیدی ویدیویی نامعتبر را مشخص می کند.
badRequest (400) invalidTitle ابرداده درخواست یک عنوان ویدیوی نامعتبر یا خالی را مشخص می کند.
badRequest (400) invalidVideoGameRating فوق داده درخواست ، رتبه بندی بازی های ویدیویی نامعتبر را مشخص می کند.
badRequest (400) invalidVideoMetadata ابرداده درخواست نامعتبر است. این خطا در صورت بروزرسانی قسمت snippet از یک منبع video رخ می دهد اما مقداری را برای هر دو ویژگی snippet.title و snippet.categoryId تعیین نمی کند.
badRequest (400) mediaBodyRequired درخواست شامل محتوای ویدیویی نیست.
badRequest (400) uploadLimitExceeded کاربر از تعداد فیلم هایی که ممکن است بارگذاری کنند فراتر رفته است.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting این درخواست سعی در تعیین مجوز نامعتبر برای این ویدئو دارد.
forbidden (403) forbiddenPrivacySetting این درخواست سعی در تنظیم یک تنظیم حریم خصوصی نامعتبر برای این فیلم دارد.

videos.list

نوع خطا جزئیات خطا توضیحات
badRequest (400) videoChartNotFound نمودار ویدیویی درخواست شده پشتیبانی نمی شود یا در دسترس نیست.
forbidden (403) forbidden این درخواست به درستی مجاز به دسترسی به پرونده ویدیویی یا پردازش اطلاعات نیست. قطعات fileDetails ، processingDetails و suggestions فقط در اختیار صاحب آن فیلم است.
forbidden (403) forbidden درخواست نمی تواند به اطلاعات رتبه بندی کاربر دسترسی پیدا کند. این خطا ممکن است رخ دهد زیرا درخواست به درستی مجاز به استفاده از پارامتر myRating نیست.
notFound (404) videoNotFound ویدئویی که می خواهید بازیابی کنید یافت نمی شود. مقدار پارامتر id درخواست را بررسی کنید تا از صحیح بودن آن اطمینان حاصل شود.

videos.delete

نوع خطا جزئیات خطا توضیحات
forbidden (403) forbidden ویدئویی که می خواهید حذف کنید حذف نمی شود. درخواست ممکن است به درستی مجاز نباشد.
notFound (404) videoNotFound ویدئویی که می خواهید حذف کنید یافت نمی شود. مقدار پارامتر id درخواست را بررسی کنید تا از صحیح بودن آن اطمینان حاصل شود.

videos.update

نوع خطا جزئیات خطا توضیحات
badRequest (400) defaultLanguageNotSet درخواست API در تلاش است بدون مشخص کردن زبان پیش فرض جزئیات فیلم ، جزئیات ویدیوی بومی سازی شده را اضافه کند.
badRequest (400) invalidCategoryId ویژگی snippet.categoryId یک شناسه دسته نامعتبر را مشخص می کند. برای بازیابی دسته های پشتیبانی شده از روش videoCategories.list استفاده کنید.
badRequest (400) invalidDefaultBroadcastPrivacySetting این درخواست سعی در تنظیم یک تنظیم حریم خصوصی نامعتبر برای پخش پیش فرض دارد.
badRequest (400) invalidDescription ابرداده درخواست توضیحات ویدئویی نامعتبر را مشخص می کند.
badRequest (400) invalidPublishAt ابرداده درخواست زمان انتشار برنامه ریزی شده نامعتبر را مشخص می کند.
badRequest (400) invalidRecordingDetails شیء recordingDetails در ابرداده درخواست جزئیات ضبط نامعتبر را مشخص می کند.
badRequest (400) invalidTags ابرداده درخواست کلمات کلیدی ویدیویی نامعتبر را مشخص می کند.
badRequest (400) invalidTitle ابرداده درخواست یک عنوان ویدیوی نامعتبر یا خالی را مشخص می کند.
badRequest (400) invalidVideoMetadata ابرداده درخواست نامعتبر است. این خطا در صورت بروزرسانی قسمت snippet از یک منبع video رخ می دهد اما مقداری را برای هر دو ویژگی snippet.title و snippet.categoryId تعیین نمی کند.
forbidden (403) forbidden دسترسی ممنوع درخواست ممکن است به درستی مجاز نباشد.
forbidden (403) forbiddenEmbedSetting این درخواست سعی در تنظیم تنظیمات تعبیه شده نامعتبر برای این فیلم دارد. برخی از کانال ها ممکن است اجازه ارائه بازیکنان تعبیه شده برای جریان های زنده نداشته باشند. برای اطلاعات بیشتر به مرکز راهنمای YouTube مراجعه کنید.
forbidden (403) forbiddenLicenseSetting این درخواست سعی در تعیین مجوز نامعتبر برای این ویدئو دارد.
forbidden (403) forbiddenPrivacySetting این درخواست سعی در تنظیم یک تنظیم حریم خصوصی نامعتبر برای این فیلم دارد.
notFound (404) videoNotFound ویدئویی که می خواهید به روز کنید یافت نمی شود. مقدار قسمت id را در بدنه درخواست بررسی کنید تا از صحیح بودن آن اطمینان حاصل کنید.

videos.rate

نوع خطا جزئیات خطا توضیحات
badRequest (400) emailNotVerified کاربر باید قبل از رتبه بندی آدرس ایمیل خود را تأیید کند.
badRequest (400) invalidRating درخواست حاوی یک مقدار غیر منتظره برای پارامتر rating بود.
badRequest (400) videoPurchaseRequired فیلم های اجاره ای فقط توسط کاربرانی که آنها را اجاره کرده اند می توانند رتبه بندی شوند.
forbidden (403) forbidden ویدئویی که می خواهید آن را ارزیابی کنید ، نمی توان رتبه بندی کرد. درخواست ممکن است به درستی مجاز نباشد.
forbidden (403) videoRatingDisabled صاحب ویدئویی که می خواهید آن را ارزیابی کنید ، رتبه بندی های غیرفعال را برای آن فیلم غیرفعال کرده است.
notFound (404) videoNotFound ویدئویی که می خواهید آن را ارزیابی کنید ، یافت نمی شود. مقدار پارامتر id درخواست را بررسی کنید تا از صحیح بودن آن اطمینان حاصل شود.

videos.reportAbuse

نوع خطا جزئیات خطا توضیحات
badRequest (400) invalidAbuseReason این درخواست حاوی یک مقدار غیر منتظره برای قسمت reason_id یا ترکیبی از زمینه های reason_id و secondary_reason_id بود.
badRequest (400) rateLimitExceeded کاربر درخواست های زیادی را در یک بازه زمانی معین ارسال کرده است.
forbidden (403) forbidden
notFound (404) videoNotFound ویدئویی که می خواهید از آن استفاده کنید سوءاستفاده را پیدا نمی کنید.

watermarks

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