YouTube Live Streaming API - Errors
    
    
      
    
    
      
      با مجموعهها، منظم بمانید
    
    
      
      ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
    این سند انواع مختلف خطاهایی را که عملیات YouTube Live Streaming API میتوانند برگردانند، مشخص میکند. همچنین میتوانید فهرستی از خطاها را برای هر روش جداگانه در مستندات مرجع آن روش پیدا کنید. 
liveBroadcasts
 جداول زیر پیامهای خطایی را که API در پاسخ به فراخوانیهای مربوط به منابع liveBroadcasts برمیگرداند، شناسایی میکنند. 
 liveBroadcasts.bind
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| backendError | internalError | یک خطای داخلی در طول اتصال رخ داده است. | 
| forbidden (403) | liveBroadcastBindingNotAllowed | وضعیت فعلی پخش زنده اجازه نمیدهد که به یک پخش جریانی محدود شود. | 
| insufficientPermissions | insufficientLivePermissions | این درخواست برای بازیابی پخش زنده مشخص شده مجاز نیست. برای اطلاعات بیشتر، به پیادهسازی احراز هویت OAuth2 مراجعه کنید. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
| notFound (404) | liveBroadcastNotFound | پخش مشخص شده توسط پارامتر idوجود ندارد. | 
| notFound (404) | liveStreamNotFound | جریانی که توسط پارامتر streamIdمشخص شده است، وجود ندارد. | 
| rateLimitExceeded | userRequestsExceedRateLimit | کاربر در یک بازه زمانی مشخص درخواستهای زیادی ارسال کرده است. | 
| required (400) | idRequired | پارامتر idمورد نیاز باید پخشی را که قرار است متصل شود، شناسایی کند. | 
 liveBroadcasts.delete
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | liveBroadcastDeletionNotAllowed | وضعیت فعلی پخش زنده اجازه حذف آن را نمیدهد. | 
| insufficientPermissions | insufficientLivePermissions | درخواست برای حذف پخش زنده مشخص شده مجاز نیست. برای اطلاعات بیشتر، به پیادهسازی احراز هویت OAuth2 مراجعه کنید. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
| notFound (404) | liveBroadcastNotFound | ویژگی idمشخص شده در منبع liveBroadcast، یک broadcast را شناسایی نکرد. | 
 liveBroadcasts.insert
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| insufficientPermissions | insufficientLivePermissions | درخواست برای ایجاد پخش زنده مجاز نیست. | 
| insufficientPermissions | livePermissionBlocked | کاربری که درخواست را تأیید کرده است، در حال حاضر قادر به پخش زنده ویدیو در یوتیوب نیست. جزئیات مربوط به اینکه چرا کاربر نمیتواند ویدیوی زنده پخش کند، ممکن است در تنظیمات کانال کاربر در https://www.youtube.com/features موجود باشد. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
| invalidValue (400) | invalidAutoStart | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.enableAutoStartاست. همه پخشها از این تنظیم پشتیبانی نمیکنند. | 
| invalidValue (400) | invalidAutoStop | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.enableAutoStopاست. شما نمیتوانید تنظیمenableAutoStopرا برای یک پخش مداوم تغییر دهید. | 
| invalidValue (400) | invalidDescription | منبع liveBroadcast مقدار معتبری برای ویژگی snippet.descriptionمشخص نکرده است. مقدار این ویژگی میتواند تا ۵۰۰۰ کاراکتر باشد. | 
| invalidValue (400) | invalidEmbedSetting | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.enable_embedاست. شما نمیتوانید این پخش را جاسازی کنید. | 
| invalidValue (400) | invalidLatencyPreferenceOptions | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.latencyPreferenceاست. همه تنظیمات با این اولویت تأخیر پشتیبانی نمیشوند. | 
| invalidValue (400) | invalidPrivacyStatus | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی status.privacy_statusبود. | 
| invalidValue (400) | invalidProjection | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.projectionاست. تصویر پیشفرض یک پخش نمیتواند روی360تنظیم شود. | 
| invalidValue (400) | invalidScheduledEndTime | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی snippet.scheduledEndTimeاست. زمان پایان برنامهریزیشده باید پس از زمان شروع برنامهریزیشده باشد. | 
| invalidValue (400) | invalidScheduledStartTime | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی snippet.scheduledStartTimeاست. زمان شروع برنامهریزیشده باید در آینده باشد و به اندازه کافی به تاریخ فعلی نزدیک باشد که بتوان پخش را به طور قابل اعتمادی در آن زمان برنامهریزی کرد. | 
| invalidValue (400) | invalidTitle | منبع liveBroadcast مقدار معتبری برای ویژگی snippet.titleمشخص نکرده است. مقدار این ویژگی باید بین ۱ تا ۱۰۰ کاراکتر باشد. | 
| limitExceeded | userBroadcastsExceedLimit | کاربر تعداد زیادی پخش زنده یا زمانبندیشده ایجاد کرده است و باید برخی از آنها را متوقف یا حذف کند. | 
| rateLimitExceeded | userRequestsExceedRateLimit | کاربر در یک بازه زمانی مشخص درخواستهای زیادی ارسال کرده است. | 
| required (400) | privacyStatusRequired | منبع liveBroadcast باید وضعیت حریم خصوصی را مشخص کند. مقادیر معتبر privacyStatusرا ببینید. | 
| required (400) | scheduledEndTimeRequired | منبع liveBroadcast باید ویژگی snippet.scheduledEndTimeرا مشخص کند. | 
| required (400) | scheduledStartTimeRequired | منبع liveBroadcast باید ویژگی snippet.scheduledStartTimeرا مشخص کند. | 
| required (400) | titleRequired | منبع liveBroadcast باید ویژگی snippet.titleرا مشخص کند. | 
 liveBroadcasts.list
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| insufficientPermissions | insufficientLivePermissions | درخواست برای بازیابی پخش زنده مجاز نیست. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
 liveBroadcasts.transition
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| backendError | errorExecutingTransition | هنگام تغییر وضعیت پخش، خطایی روی داد. | 
| forbidden (403) | errorStreamInactive | انتقال درخواستی زمانی که جریانی که به پخش متصل است غیرفعال باشد، مجاز نیست. | 
| forbidden (403) | invalidTransition | پخش زنده نمیتواند از وضعیت فعلی خود به وضعیت درخواستی منتقل شود. | 
| forbidden (403) | redundantTransition | پخش زنده از قبل در وضعیت درخواستی یا در حال پردازش برای رسیدن به وضعیت درخواستی است. | 
| insufficientPermissions | insufficientLivePermissions | این درخواست برای انتقال پخش زنده مجاز نیست. | 
| insufficientPermissions | livePermissionBlocked | کاربری که درخواست را تأیید کرده است، در حال حاضر قادر به پخش زنده ویدیو در یوتیوب نیست. جزئیات مربوط به اینکه چرا کاربر نمیتواند ویدیوی زنده پخش کند، ممکن است در تنظیمات کانال کاربر در https://www.youtube.com/features موجود باشد. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
| notFound (404) | liveBroadcastNotFound | پخش مشخص شده توسط پارامتر idوجود ندارد. | 
| rateLimitExceeded (403) | userRequestsExceedRateLimit | کاربر در یک بازه زمانی مشخص درخواستهای زیادی ارسال کرده است. | 
| required (400) | idRequired | پارامتر idمورد نیاز باید پخشی را که میخواهید وضعیت آن را تغییر دهید، شناسایی کند. | 
| required (400) | statusRequired | درخواست API باید مقداری را برای پارامتر statusمشخص کند. | 
 liveBroadcasts.update
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | closedCaptionsTypeModificationNotAllowed | مقدار contentDetails.closedCaptionsTypeفقط زمانی قابل تغییر است که پخش در وضعیتcreatedیاreadyباشد. | 
| forbidden (403) | enableAutoStartModificationNotAllowed | مقدار contentDetails.enableAutoStartفقط زمانی قابل تغییر است که استریم غیرفعال باشد و پخش در وضعیتcreatedیاreadyباشد. | 
| forbidden (403) | enableClosedCaptionsModificationNotAllowed | مقدار contentDetails.enableClosedCaptionsفقط زمانی قابل تغییر است که وضعیت پخشcreatedیاreadyباشد. | 
| forbidden (403) | enableDvrModificationNotAllowed | مقدار contentDetails. enableDvrفقط زمانی قابل تغییر است که وضعیت پخشcreatedیاreadyباشد. | 
| forbidden (403) | enableMonitorStreamModificationNotAllowed | مقدار contentDetails. monitorStream.enableMonitorStreamفقط زمانی قابل تغییر است که وضعیت پخشcreatedیاreadyباشد. | 
| forbidden (403) | recordFromStartModificationNotAllowed | مقدار contentDetails. recordFromStartفقط زمانی قابل تغییر است که وضعیت پخشcreatedیاreadyباشد. | 
| insufficientPermissions | insufficientLivePermissions | درخواست برای بهروزرسانی پخش زندهی مشخصشده مجاز نیست. برای اطلاعات بیشتر، به پیادهسازی احراز هویت OAuth2 مراجعه کنید. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
| invalidValue (400) | invalidAutoStart | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.enableAutoStartاست. شما نمیتوانید تنظیماتenableAutoStartرا برای یک پخش مداوم تغییر دهید. | 
| invalidValue (400) | invalidAutoStop | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.enableAutoStopاست. شما نمیتوانید تنظیمenableAutoStopرا برای یک پخش مداوم تغییر دهید. | 
| invalidValue (400) | invalidDescription | منبع liveBroadcast مقدار معتبری برای ویژگی snippet.descriptionمشخص نکرده است.snippet.descriptionمیتواند تا ۵۰۰۰ کاراکتر داشته باشد. | 
| invalidValue (400) | invalidEmbedSetting | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.enable_embedاست. شما نمیتوانید این پخش را جاسازی کنید. | 
| invalidValue (400) | invalidEnableClosedCaptions | در منبع liveBroadcast ، مقدار ویژگی contentDetails.enableClosedCaptionsبا مقدار تنظیمcontentDetails.closedCaptionTypeسازگار نیست. منبع را طوری تغییر دهید که فقط شامل یکی از دو ویژگی باشد و سپس درخواست را دوباره ارسال کنید. | 
| invalidValue (400) | invalidLatencyPreferenceOptions | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.latencyPreferenceاست. همه تنظیمات با این اولویت تأخیر پشتیبانی نمیشوند. | 
| invalidValue (400) | invalidPrivacyStatus | منبع liveBroadcast وضعیت حریم خصوصی معتبری را مشخص نکرده است. مقادیر معتبر privacyStatusرا ببینید. | 
| invalidValue (400) | invalidProjection | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی contentDetails.projectionاست. تصویر پخش مداوم را نمیتوان روی ۳۶۰ تنظیم کرد. | 
| invalidValue (400) | invalidScheduledEndTime | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی snippet.scheduledEndTimeاست. زمان پایان برنامهریزیشده باید پس از زمان شروع برنامهریزیشده باشد. | 
| invalidValue (400) | invalidScheduledStartTime | منبع liveBroadcast حاوی مقدار نامعتبری برای ویژگی snippet.scheduledStartTimeاست. زمان شروع برنامهریزیشده باید در آینده باشد. | 
| invalidValue (400) | invalidTitle | منبع liveBroadcast مقدار معتبری برای ویژگی snippet.titleمشخص نکرده است.snippet.titleباید بین ۱ تا ۱۰۰ کاراکتر باشد. | 
| notFound (404) | liveBroadcastNotFound | ویژگی idمشخص شده در منبع liveBroadcast، یک broadcast را شناسایی نکرد. | 
| required (400) | broadcastStreamDelayMsRequired | منبع liveBroadcast ویژگی contentDetails. monitorStream.broadcastStreamDelayMsرا مشخص نکرده است. | 
| required (400) | enableMonitorStreamRequired | منبع liveBroadcast ویژگی contentDetails. monitorStream.enableMonitorStreamرا مشخص نکرده است. | 
| required (400) | idRequired | منبع liveBroadcast باید شامل یک مقدار برای ویژگی idباشد و آن را مشخص کند. | 
| required (400) | privacyStatusRequired | منبع liveBroadcast وضعیت حریم خصوصی را مشخص نکرده است. برای مقادیر معتبر privacyStatusبه مراجعه کنید. | 
| required (400) | scheduledEndTimeRequired | منبع liveBroadcast ویژگی snippet.scheduledEndTimeرا مشخص نکرده است. | 
| required (400) | scheduledStartTimeRequired | منبع liveBroadcast ویژگی snippet.scheduledStartTimeرا مشخص نکرده است. | 
| required (400) | titleRequired | منبع liveBroadcast ویژگی snippet.titleرا مشخص نکرده است. | 
 liveBroadcasts.cuepoint
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| insufficientPermissions (403) | insufficientLivePermissions | درخواست مجاز به درج نقطه شروع در پخش زنده نیست. | 
| insufficientPermissions (403) | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://support.google.com/youtube/answer/2474026 و https://www.youtube.com/features پیدا کند. | 
| rateLimitExceeded (403) | userRequestsExceedRateLimit | کاربر در یک بازه زمانی مشخص درخواستهای زیادی ارسال کرده است. | 
| required (400) | idRequired | پارامتر idمورد نیاز باید پخشی را که میخواهید یک cuepoint در آن وارد کنید، مشخص کند. | 
| required (400) | cueTypeRequired | فیلد cueTypeمورد نیاز باید در بدنه درخواست API مشخص شود. | 
| notFound (404) | liveBroadcastNotFound | پخش مشخص شده توسط پارامتر idوجود ندارد. | 
| invalidValue (400) | conflictingTimeFields | فقط یکی از مقادیر insertionOffsetTimeMsوwalltimeMsقابل تعیین است. تنظیم هر دو مقدار باعث خطا میشود. اگر هیچکدام از مقادیر را تنظیم نکنید، یوتیوب از زمان پیشفرضinsertionOffsetTimeMs(0) استفاده خواهد کرد، به این معنی که cuepoint در اسرع وقت درج خواهد شد. | 
| invalidValue (400) | invalidInsertionOffsetTimeMs | منبع cuepointمقدار نامعتبری را برای ویژگیinsertionOffsetTimeMsمشخص کرده است. مقدار باید0یا یک عدد صحیح مثبت باشد. | 
| invalidValue (400) | invalidWalltimeMs | منبع cuepointمقدار نامعتبری را برای ویژگیwalltimeMsمشخص کرده است. این مقدار باید یک عدد صحیح باشد که نشان دهنده یک مهر زمانی epoch باشد. | 
| backendError (5xx) | serviceUnavailable | سرویس در دسترس نیست. درخواست خود را پس از چند دقیقه دوباره امتحان کنید. | 
liveChatBans
 جداول زیر پیامهای خطایی را که API در پاسخ به فراخوانیهای مربوط به منابع liveChatBans برمیگرداند، شناسایی میکنند.
liveChatBans.delete
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | forbidden | ممنوعیت مشخص شده قابل حذف نیست. این خطا زمانی رخ میدهد که درخواست توسط یک ناظر که در تلاش برای حذف ممنوعیت یک ناظر دیگر است، تأیید شده باشد. | 
| forbidden (403) | insufficientPermissions | شما مجوزهای لازم برای حذف ممنوعیت مشخص شده را ندارید. | 
| invalidValue (400) | invalidLiveChatBanId | پارامتر idیک مقدار نامعتبر را مشخص میکند. | 
| notFound (404) | liveChatBanNotFound | ممنوعیت مشخص شده یافت نشد. | 
 liveChatBans.insert
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | insufficientPermissions | شما مجوزهای لازم برای مسدود کردن یک کاربر از چت زنده مشخص شده را ندارید. | 
| forbidden (403) | liveChatBanInsertionNotAllowed | ایجاد ممنوعیت مشخص شده امکانپذیر نیست. این خطا زمانی رخ میدهد که درخواست سعی در ممنوعیت مالک چت یا مدیر دیگری داشته باشد. | 
| invalidValue (400) | invalidChannelId | شناسه کانال مشخص شده یافت نشد. | 
| invalidValue (400) | invalidLiveChatId | مقدار snippet.liveChatIdمشخص شده در درخواست نامعتبر است. منبعliveBroadcastمرتبط را بررسی کنید تا مطمئن شوید که مقدار صحیح را دارید. | 
| notFound (404) | liveChatNotFound | چت زنده مشخص شده یافت نشد. منبع مرتبط liveBroadcastرا بررسی کنید تا مطمئن شوید که ویژگیsnippet.liveChatIdرا روی مقدار صحیح تنظیم کردهاید. | 
| notFound (404) | liveChatUserNotFound | کاربر چت زندهای که میخواهید مسدود کنید، پیدا نشد. | 
| required (400) | bannedUserChannelIdRequired | منبع liveChatBanکه در بدنه درخواست ارسال میشود، باید مقداری را برای ویژگیsnippet.bannedUserDetails.channelIdمشخص کند. | 
| required (400) | liveChatIdRequired | منبع liveChatBanکه در بدنه درخواست ارسال میشود، باید مقداری را برای ویژگیsnippet.liveChatIdمشخص کند. | 
liveChatMessages
 جداول زیر پیامهای خطایی را که API در پاسخ به فراخوانیهای مربوط به منابع liveChatMessages برمیگرداند، شناسایی میکنند. 
 liveChatMessages.delete
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | forbidden | شما مجوزهای لازم برای حذف پیام مشخص شده را ندارید. | 
| forbidden (403) | modificationNotAllowed | منبع مشخصشدهی liveChatMessageقابل حذف نیست. پارامترidممکن است پیامی را شناسایی کند که توسط یک مدیر یا کاربر دیگری ایجاد شده است که پیامهایش قابل حذف نیستند. | 
| notFound (404) | liveChatMessageNotFound | پیامی که میخواهید حذف کنید پیدا نشد. مقدار پارامتر idرا بررسی کنید تا مطمئن شوید که صحیح است. | 
 liveChatMessages.insert
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | forbidden | شما مجوزهای لازم برای ایجاد پیام مشخص شده را ندارید. | 
| forbidden (403) | liveChatDisabled | چت زنده مشخص شده توسط مالک غیرفعال شده است، به این معنی که پیامها نمیتوانند به چت اضافه شوند. | 
| forbidden (403) | liveChatEnded | گفتگوی زنده مشخص شده دیگر فعال نیست. | 
| invalidValue (400) | messageTextInvalid | متن پیام ( snippet.textMessageDetails.messageText) معتبر نیست. | 
| notFound (404) | liveChatNotFound | چت زنده شناسایی شده در درخواست API وجود ندارد. این خطا زمانی رخ میدهد که چت توسط مالک حذف شده باشد. | 
| rateLimitExceeded | rateLimitExceeded | کاربر در یک بازه زمانی مشخص، پیامهای چت زیادی ارسال کرده است. | 
| required (400) | liveChatIdRequired | منبع liveChatMessage باید شامل و مشخص کننده مقداری برای ویژگی snippet.liveChatIdباشد. | 
| required (400) | messageTextRequired | منبع liveChatMessage باید شامل و مشخص کننده مقداری برای ویژگی snippet.textMessageDetails.messageTextباشد. | 
| required (400) | typeRequired | منبع liveChatMessage باید شامل و مشخص کننده مقداری برای ویژگی snippet.typeباشد. مقدار پارامتر را رویtextتنظیم کنید. | 
 liveChatMessages.list
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | forbidden | شما مجوزهای لازم برای بازیابی پیامهای مربوط به گفتگوی زنده مشخص شده را ندارید. | 
| forbidden (403) | liveChatDisabled | چت زنده برای پخش مشخص شده فعال نیست. | 
| forbidden (403) | liveChatEnded | گفتگوی زنده مشخص شده دیگر فعال نیست. | 
| notFound (404) | liveChatNotFound | چت زندهای که میخواهید بازیابی کنید، یافت نشد. مقدار پارامتر liveChatIdدرخواست را بررسی کنید تا از صحت آن اطمینان حاصل کنید. | 
| rateLimitExceeded | rateLimitExceeded | درخواست خیلی سریع پس از درخواست قبلی ارسال شد. این خطا زمانی رخ میدهد که درخواستهای API برای بازیابی پیامها با سرعت بیشتری نسبت به نرخ بهروزرسانی یوتیوب ارسال میشوند که باعث اتلاف غیرضروری پهنای باند میشود. | 
 liveChatMessages.streamlist
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| INVALID_ARGUMENT (3) | LIVE_CHAT_ENDED | شما نمیتوانید پیامهای چت زندهی پایانیافته را بازیابی کنید. | 
| PERMISSION_DENIED (7) | forbidden | شما مجوزهای لازم برای بازیابی پیامهای مربوط به گفتگوی زنده مشخص شده را ندارید. | 
| PERMISSION_DENIED (7) | liveChatDisabled | چت زنده برای پخش مشخص شده فعال نیست. | 
| PERMISSION_DENIED (7) | liveChatEnded | گفتگوی زنده مشخص شده دیگر فعال نیست. | 
| NOT_FOUND (5) | liveChatNotFound | چت زندهای که میخواهید بازیابی کنید، یافت نشد. مقدار پارامتر liveChatIdدرخواست را بررسی کنید تا از صحت آن اطمینان حاصل کنید. | 
| RESOURCE_EXHAUSTED (8) | rateLimitExceeded | درخواست خیلی سریع پس از درخواست قبلی ارسال شد. این خطا زمانی رخ میدهد که درخواستهای API برای بازیابی پیامها با سرعت بیشتری نسبت به نرخ بهروزرسانی یوتیوب ارسال میشوند که باعث اتلاف غیرضروری پهنای باند میشود. | 
liveStreams
 جداول زیر پیامهای خطایی را که API در پاسخ به فراخوانیهای مربوط به منابع liveStreams برمیگرداند، شناسایی میکنند.
 liveStreams.delete
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | liveStreamDeletionNotAllowed | پخش زنده مشخص شده قابل حذف نیست زیرا به پخشی متصل است که هنوز کامل نشده است. | 
| insufficientPermissions | insufficientLivePermissions | درخواست برای حذف پخش زنده مشخص شده مجاز نیست. برای اطلاعات بیشتر، به پیادهسازی احراز هویت OAuth 2.0 مراجعه کنید. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. برای اطلاعات بیشتر، به شرایط واجد شرایط بودن برای ویژگی مراجعه کنید. | 
| notFound (404) | liveStreamNotFound | پخش زنده مورد نظر وجود ندارد. | 
 liveStreams.insert
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| insufficientPermissions | insufficientLivePermissions | درخواست برای ایجاد پخش زنده مشخص شده مجاز نیست. | 
| insufficientPermissions | livePermissionBlocked | کاربری که درخواست را تأیید کرده است، در حال حاضر قادر به پخش زنده ویدیو در یوتیوب نیست. جزئیات مربوط به اینکه چرا کاربر نمیتواند ویدیوی زنده پخش کند، ممکن است در تنظیمات کانال کاربر در https://www.youtube.com/features موجود باشد. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
| invalidValue (400) | invalidDescription | مقدار ویژگی snippet.descriptionدر منبعliveStreamمیتواند تا 10000 کاراکتر داشته باشد. | 
| invalidValue (400) | invalidFormat | مقدار ویژگی cdn.formatدر منبعliveStreamنامعتبر است. | 
| invalidValue (400) | invalidFrameRate | مقدار ویژگی cdn.frameRateدر منبعliveStreamنامعتبر است. | 
| invalidValue (400) | invalidIngestionType | مقدار ویژگی cdn.ingestionTypeدر منبعliveStreamنامعتبر است. | 
| invalidValue (400) | invalidResolution | مقدار ویژگی cdn.resolutionدر منبعliveStreamنامعتبر است. | 
| invalidValue (400) | invalidTitle | مقدار ویژگی snippet.titleدر منبعliveStreamباید بین ۱ تا ۱۲۸ کاراکتر باشد. | 
| rateLimitExceeded | userRequestsExceedRateLimit | کاربر در یک بازه زمانی مشخص درخواستهای زیادی ارسال کرده است. | 
| required (400) | cdnRequired | منبع liveStreamباید حاوی شیءcdnباشد. | 
| required (400) | frameRateRequired | اگر مقداری برای ویژگی cdn.resolutionتعیین کنید اما برای ویژگیcdn.frameRateمقداری تعیین نکنید، API این خطا را برمیگرداند. | 
| required (400) | ingestionTypeRequired | منبع liveStreamباید مقداری را برای ویژگیcdn.ingestionType> مشخص کند. | 
| required (400) | resolutionRequired | اگر مقداری برای ویژگی cdn.frameRateتعیین کنید اما برای ویژگیcdn.resolutionمقداری تعیین نکنید، API این خطا را برمیگرداند. | 
| required (400) | titleRequired | منبع liveStreamباید مقداری را برای ویژگیsnippet.titleمشخص کند. | 
 liveStreams.list
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| insufficientPermissions | insufficientLivePermissions | درخواست برای بازیابی پخش زنده مشخص شده مجاز نیست. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
 liveStreams.update
| نوع خطا | جزئیات خطا | توضیحات | 
|---|
| forbidden (403) | liveStreamModificationNotAllowed | پخش زنده مشخص شده در وضعیت فعلیاش قابل تغییر نیست. برای اطلاعات بیشتر، به «زندگی یک پخش» مراجعه کنید. | 
| forbidden (403) | liveStreamModificationNotAllowed | این API به شما اجازه نمیدهد که مقدار فیلدهای cdn.format،cdn.frameRate،cdn.ingestionTypeیاcdn.resolutionرا پس از ایجاد استریم تغییر دهید. | 
| forbidden (403) | liveStreamModificationNotAllowed | این API به شما اجازه نمیدهد که یک جریان قابل استفاده مجدد را به غیرقابل استفاده مجدد یا برعکس تغییر دهید. برای اطلاعات بیشتر، به بخش «درک پخشها و جریانها» مراجعه کنید. | 
| insufficientPermissions | insufficientLivePermissions | درخواست برای بهروزرسانی پخش زنده مشخصشده مجاز نیست. برای اطلاعات بیشتر، به پیادهسازی احراز هویت OAuth2 مراجعه کنید. | 
| insufficientPermissions | liveStreamingNotEnabled | کاربری که درخواست را تأیید کرده است، اجازه پخش زنده ویدیو در یوتیوب را ندارد. کاربر میتواند اطلاعات بیشتر را در https://www.youtube.com/features پیدا کند. | 
| invalidValue (400) | invalidDescription | مقدار ویژگی snippet.descriptionدر منبع liveStream میتواند تا 10000 کاراکتر داشته باشد. | 
| invalidValue (400) | invalidTitle | مقدار ویژگی snippet.titleدر منبع liveStream باید بین ۱ تا ۱۲۸ کاراکتر باشد. | 
| notFound (404) | liveStreamNotFound | پخش زنده مورد نظر وجود ندارد. | 
| required (400) | idRequired | منبع liveStream باید مقداری را برای ویژگی idمشخص کند. | 
| required (400) | ingestionTypeRequired | منبع liveStream باید مقداری را برای ویژگی cdn.ingestionTypeمشخص کند. | 
| required (400) | titleRequired | منبع liveStream باید مقداری را برای ویژگی snippet.titleمشخص کند. | 
 
  
    
    
      
       
    
    
  
  
  جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
  تاریخ آخرین بهروزرسانی 2025-10-27 بهوقت ساعت هماهنگ جهانی.
  
  
  
    
      [null,null,["تاریخ آخرین بهروزرسانی 2025-10-27 بهوقت ساعت هماهنگ جهانی."],[],["The document details error scenarios within the YouTube Live API, categorized by function. `fanFundingEvents.list` can fail due to insufficient permissions or disabled Fan Funding. Live broadcast actions (`bind`, `delete`, `insert`, `list`, `transition`, `update`) often fail from user permission issues, missing parameters, invalid values, or exceeding limits. Live chat interactions (`bans`, `messages`) face issues with permissions, invalid IDs, missing data, and rate limits. `liveCuepoints` and `liveStreams` can encounter similar errors, including issues with missing data, incorrect configuration, or forbidden actions. `sponsors.list` can be blocked due to permissions or disabled sponsorship.\n"]]