این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

یوتیوب ویژگی بولتن کانال را منسوخ کرده است. روش activities.insert دیگر پشتیبانی نمی شود.

جداول زیر پیام های خطایی را که API در پاسخ به تماس های مربوط به منابع activities برمی گرداند، مشخص می کند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common 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 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` یافت نشد.

`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 errors را برگردانند.

`channelBanners.insert`

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

channelSections

جداول زیر پیام های خطایی را مشخص می کند که API در پاسخ به تماس های مربوط به منابع channelSections برمی گرداند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common 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 errors را برگردانند.

`channels.list`

نوع خطا	جزئیات خطا	شرح
`badRequest (400)`	`invalidCriteria`	حداکثر یکی از فیلترهای زیر ممکن است مشخص شود: `id` , `mySubscribers` , `categoryId` , `mine` , `managedByMe` , `forUsername` . در صورت احراز هویت مالک محتوا از طریق پارامتر `onBehalfOfContentOwner` ، فقط `id` یا `managedByMe` ممکن است مشخص شود.
`forbidden (403)`	`channelForbidden`	کانال مشخص شده توسط پارامتر `id` از درخواست پشتیبانی نمی کند یا درخواست به درستی مجاز نیست.
`notFound (404)`	`categoryNotFound`	دسته شناسایی شده توسط پارامتر `categoryId` یافت نمی شود. از روش guideCategories.list برای بازیابی لیستی از مقادیر معتبر استفاده کنید.
`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`	فراداده درخواست باید آدرس وب سایت را در قسمت invideoPromotion مشخص کند. مقدار ویژگی `invideoPromotion.items[].id.websiteUrl` را در منبعی که درخواست ارسال می کند، تنظیم کنید.

commentThreads

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

`commentThreads.list`

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

`commentThreads.insert`

نوع خطا	جزئیات خطا	شرح
`badRequest (400)`	`channelOrVideoIdMissing`	هر رشته نظر باید به یک کانال یا ویدیو پیوند داده شود. اگر نظر برای یک کانال اعمال می شود، مطمئن شوید که منبع مشخص شده در بدنه درخواست مقداری برای ویژگی `snippet.channelId` ارائه می دهد. نظری که برای یک کانال اعمال می شود در برگه بحث کانال ظاهر می شود. اگر نظر برای یک ویدیو اعمال می‌شود، مطمئن شوید که منبع مقادیری را برای ویژگی‌های `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

روش comments.markAsSpam دیگر پشتیبانی نمی شود.

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

`comments.list`

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

`comments.setModerationStatus`

نوع خطا	جزئیات خطا	شرح
`badRequest (400)`	`banWithoutReject`	پارامتر `banAuthor` را فقط در صورتی می توان استفاده کرد که مقدار پارامتر `moderationStatus` `rejected` .
`badRequest (400)`	`operationNotSupported`	نظراتی که بر اساس Google+‎ نیستند، فقط عملکرد محدودی برای تعدیل ارائه می‌دهند.
`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`	فقط نظرات مبتنی بر +Google را می توان به روز کرد.
`badRequest (400)`	`processingFailure`	سرور API نتوانست درخواست را با موفقیت پردازش کند. در حالی که این می تواند یک خطای گذرا باشد، معمولاً نشان می دهد که ورودی درخواست نامعتبر است. ساختار منبع `comment` را در بدنه درخواست بررسی کنید تا از معتبر بودن آن اطمینان حاصل کنید.
`forbidden (403)`	`forbidden`	نظر به دلیل مجوزهای ناکافی به‌روزرسانی نشد. ممکن است درخواست به درستی مجاز نباشد.
`forbidden (403)`	`ineligibleAccount`	حساب YouTube مورد استفاده برای تأیید درخواست API باید با حساب Google کاربر ادغام شود تا یک نظر یا موضوع نظر به‌روزرسانی شود.
`notFound (404)`	`commentNotFound`	نظر مشخص شده یافت نشد. مقدار ویژگی `id` را در بدنه درخواست بررسی کنید تا مطمئن شوید که درست است.

members

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

`membershipsLevels.list`

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

playlistItems

جداول زیر پیام های خطایی را که API در پاسخ به تماس های مربوط به منابع playlistItems برمی گرداند، مشخص می کند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common 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`	The playlist identified with the request's `playlistId` parameter cannot be found.
`notFound (404)`	`videoNotFound`	The video that you are trying to add to the playlist cannot be found. Check the value of the `videoId` property to ensure that it is correct.
`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)`	`resourceIdRequired`	The request must contain a resource in which the `snippet` object specifies a `resourceId` .

`playlistItems.list`

Error type	Error detail	شرح
`forbidden (403)`	`playlistItemsNotAccessible`	The request is not properly authorized to retrieve the specified playlist.
`notFound (404)`	`playlistNotFound`	The playlist identified with the request's `playlistId` parameter cannot be found.
`notFound (404)`	`videoNotFound`	The video identified with the request's `videoId` parameter cannot be found.
`required (400)`	`playlistIdRequired`	The subscribe request does not specify a value for the required `playlistId` property.
`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 type	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 – eg `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 errors section.

`playlists.delete`

Error type	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 type	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 type	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 type	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.

search

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

`search.list`

Error type	Error detail	شرح
`badRequest (400)`	`invalidChannelId`	The `channelId` parameter specified an invalid channel ID.
`badRequest (400)`	`invalidLocation`	The `location` and/or `locationRadius` parameter value was formatted incorrectly.
`badRequest (400)`	`invalidRelevanceLanguage`	The `relevanceLanguage` parameter value was formatted incorrectly.
`badRequest (400)`	`invalidSearchFilter`	The request contains an invalid combination of search filters and/or restrictions. Note that you must set the `type` parameter to `video` if you set a value for the `eventType` , `videoCaption` , `videoCategoryId` , `videoDefinition` , `videoDimension` , `videoDuration` , `videoEmbeddable` , `videoLicense` , `videoSyndicated` , or `videoType` parameters.

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 errors section.

`subscriptions.delete`

Error type	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 type	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 type	Error detail	شرح
`forbidden (403)`	`accountClosed`	Subscriptions could not be retrieved because the subscriber's account is closed.
`forbidden (403)`	`accountSuspended`	Subscriptions could not be retrieved because the subscriber's account is suspended.
`forbidden (403)`	`subscriptionForbidden`	The requester is not 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 errors section.

`thumbnails.set`

Error type	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 errors section.

`videoAbuseReportReasons.list`

Error type	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 errors section.

`videoCategories.list`

Error type	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 errors section.

`videos.insert`

Error type	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 type	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. Note that 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 type	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 type	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. Note that some channels may 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 type	Error detail	شرح
`badRequest (400)`	`emailNotVerified`	The user must verify their e-mail 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 type	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 errors section.

`watermarks.set`

Error type	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 type	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.