این سند انواع مختلف خطاهایی را که عملیات 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 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 یافت نمی شود. از روش 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 | فراداده درخواست باید 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 را بررسی کنید تا مطمئن شوید که درست است. |
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 | درخواست باید عنوان لیست پخش را مشخص کند. |
search
جداول زیر پیام های خطا را که API در پاسخ به تماس های مربوط به منابع search باز می گرداند ، مشخص می کند. این روشها همچنین می توانند خطاهای ذکر شده در بخش خطاهای درخواست مشترک را برگردانند.
search.list
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
badRequest (400) | invalidChannelId | پارامتر channelId شناسه کانال نامعتبر را مشخص کرد. |
badRequest (400) | invalidLocation | مقدار پارامتر location و/یا locationRadius به اشتباه فرمت شد. |
badRequest (400) | invalidRelevanceLanguage | مقدار پارامتر relevanceLanguage نادرست قالب بندی شد. |
badRequest (400) | invalidSearchFilter | این درخواست حاوی ترکیبی نامعتبر از فیلترهای جستجو و/یا محدودیت است. اگر مقداری را برای eventType ، videoCaption ، videoCategoryId ، videoDefinition ، videoDimension ، videoDuration ، videoEmbeddable ، Videolense ، videoLicense ، videoSyndicated یا videoType تنظیم کنید ، باید پارامتر type روی video تنظیم کنید. |
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 روی یک مقدار نامعتبر تنظیم شده است. |
comments
comments.markAsSpamدیگر پشتیبانی نمی شود.جداول زیر پیام‌های خطایی را که API در پاسخ به تماس‌های مربوط به منابع
commentsباز می‌گرداند، مشخص می‌کند. این روش ها همچنین می توانند خطاهای فهرست شده در بخش Common request errors را برگردانند.comments.listbadRequest (400)operationNotSupportedforbidden (403)forbiddennotFound (404)commentNotFoundidوparentIdدرخواست را بررسی کنید تا مطمئن شوید که درست هستند.comments.setModerationStatusbadRequest (400)banWithoutRejectbanAuthorفقط در صورتی می توان استفاده کرد که مقدار پارامترmoderationStatusrejectedشود.badRequest (400)operationNotSupportedbadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidدرخواست را بررسی کنید تا مطمئن شوید که درست هستند.comments.insertbadRequest (400)commentTextRequiredcommentکه در حال درج است باید مقداری را برای ویژگیsnippet.textOriginalمشخص کند. نظرات نمی توانند خالی باشند.badRequest (400)commentTextTooLongcommentکه در حال درج است حاوی تعداد زیادی کاراکتر در ویژگیsnippet.textOriginalاست.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedsnippet.parentIdنیست. در یک منبعcommentThread، ویژگیsnippet.canReplyنشان می دهد که آیا بیننده فعلی می تواند به رشته پاسخ دهد یا خیر.badRequest (400)parentCommentIsPrivatebadRequest (400)parentIdMissingcommentدر بدنه درخواست API مقداری را برای ویژگیsnippet.parentIdمشخص نکرده است.badRequest (400)processingFailurecommentرا در بدنه درخواست بررسی کنید تا از معتبر بودن آن اطمینان حاصل کنید.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)parentCommentNotFoundsnippet.parentIdرا در بدنه درخواست بررسی کنید تا مطمئن شوید که درست است.comments.deletebadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidدرخواست را بررسی کنید تا مطمئن شوید که درست است.comments.updatebadRequest (400)commentTextTooLongcommentکه در حال به‌روزرسانی است حاوی نویسه‌های بسیار زیادی در ویژگیsnippet.textOriginalاست.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedbadRequest (400)processingFailurecommentرا در بدنه درخواست بررسی کنید تا از معتبر بودن آن اطمینان حاصل کنید.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)commentNotFoundidرا در بدنه درخواست بررسی کنید تا مطمئن شوید که درست است.