YouTube Live Streaming API - Errors
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا المستند الأنواع المختلفة من الأخطاء التي يمكن أن تعرضها عمليات YouTube Live Streaming API. يمكنك أيضًا العثور على قائمة بالأخطاء لأي طريقة فردية في المستندات المرجعية الخاصة بهذه الطريقة.
fanFundingEvents
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد fanFundingEvents
.
fanFundingEvents.list
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
forbidden (403) |
insufficientPermissions |
ليس لديك الأذونات اللازمة للاطّلاع على أحداث ميزة "التمويل من المعجبين" في القناة. |
invalidValue (400) |
fanFundingNotEnabledForChannelId |
لم يتم تفعيل ميزة "تمويل من المعجبين" في القناة. |
liveBroadcasts
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد liveBroadcasts
.
liveBroadcasts.bind
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
backendError |
internalError |
حدث خطأ داخلي أثناء الربط. |
forbidden (403) |
liveBroadcastBindingNotAllowed |
لا تسمح الحالة الحالية للبث المباشر بربطه ببث. |
insufficientPermissions |
insufficientLivePermissions |
لا يمكن استرداد البث المباشر المحدّد لأنّ الطلب غير مصرّح به. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ مصادقة OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على 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 |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features. |
notFound (404) |
liveBroadcastNotFound |
لم تحدّد السمة id المحدّدة في مصدر liveBroadcast بثًا مباشرًا. |
liveBroadcasts.insert
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
insufficientPermissions |
insufficientLivePermissions |
لا يمكن إنشاء البث المباشر باستخدام هذا الطلب. |
insufficientPermissions |
livePermissionBlocked |
لا يمكن للمستخدم الذي منح الإذن بإرسال الطلب بث فيديو مباشر على YouTube في الوقت الحالي. قد تتوفّر تفاصيل توضّح سبب عدم إمكانية بث الفيديو مباشرةً في إعدادات قناة المستخدم على https://www.youtube.com/features. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features. |
invalidValue (400) |
invalidAutoStart |
احتوى مرجع liveBroadcast على قيمة غير صالحة للخاصية contentDetails.enableAutoStart .
لا تتيح بعض عمليات البث هذا الإعداد. |
invalidValue (400) |
invalidAutoStop |
احتوى مرجع liveBroadcast على قيمة غير صالحة للخاصية contentDetails.enableAutoStop . لا يمكنك تعديل إعداد enableAutoStop لبث مستمر. |
invalidValue (400) |
invalidDescription |
لم يحدّد مرجع البث المباشر قيمة صالحة للسمة snippet.description . يمكن أن تحتوي قيمة السمة على ما يصل إلى 5000 حرف. |
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 |
لم يحدّد مرجع البث المباشر قيمة صالحة للسمة snippet.title . يجب أن يتراوح طول قيمة السمة بين حرف واحد و100 حرف. |
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 |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features. |
liveBroadcasts.transition
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
backendError |
errorExecutingTransition |
حدث خطأ أثناء تغيير حالة البث. |
forbidden (403) |
errorStreamInactive |
لا يُسمح بالانتقال المطلوب عندما يكون مصدر البيانات المرتبط بالبث غير نشط. |
forbidden (403) |
invalidTransition |
لا يمكن أن ينتقل البث المباشر من حالته الحالية إلى الحالة المطلوبة. |
forbidden (403) |
redundantTransition |
البث المباشر في الحالة المطلوبة أو قيد المعالجة للوصول إلى الحالة المطلوبة |
insufficientPermissions |
insufficientLivePermissions |
ليس لديك الإذن بنقل البث المباشر. |
insufficientPermissions |
livePermissionBlocked |
لا يمكن للمستخدم الذي منح الإذن بإرسال الطلب بث فيديو مباشر على YouTube في الوقت الحالي. قد تتوفّر تفاصيل توضّح سبب عدم إمكانية بث الفيديو مباشرةً في إعدادات قناة المستخدم على https://www.youtube.com/features. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features. |
notFound (404) |
liveBroadcastNotFound |
لا تتوفّر البث المباشر المحدّد بالمعلَمة id . |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
أرسل المستخدم عددًا كبيرًا جدًا من الطلبات خلال إطار زمني معيّن. |
required (400) |
idRequired |
يجب أن تحدّد المَعلمة id المطلوبة البث الذي تريد تغيير حالته. |
required (400) |
statusRequired |
يجب أن يحدّد طلب واجهة برمجة التطبيقات قيمة للمَعلمة 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 |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features. |
invalidValue (400) |
invalidAutoStart |
احتوى مرجع liveBroadcast على قيمة غير صالحة للخاصية contentDetails.enableAutoStart .
لا يمكنك تعديل إعداد enableAutoStart لبث مستمر. |
invalidValue (400) |
invalidAutoStop |
احتوى مرجع liveBroadcast على قيمة غير صالحة للخاصية contentDetails.enableAutoStop . لا يمكنك تعديل إعداد enableAutoStop لبث مستمر. |
invalidValue (400) |
invalidDescription |
لم يحدّد مرجع البث المباشر قيمة صالحة للسمة snippet.description . يمكن أن يحتوي snippet.description على ما يصل إلى 5000 حرف. |
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 . لا يمكن ضبط عرض البث المباشر الدائم على 360 درجة. |
invalidValue (400) |
invalidScheduledEndTime |
احتوى مورد liveBroadcast على قيمة غير صالحة للخاصية snippet.scheduledEndTime . يجب أن يكون وقت الانتهاء المُجدوَل بعد وقت البدء المُجدوَل. |
invalidValue (400) |
invalidScheduledStartTime |
احتوى مورد liveBroadcast على قيمة غير صالحة للخاصية snippet.scheduledStartTime . يجب أن يكون وقت البدء المُجدوَلة في المستقبل. |
invalidValue (400) |
invalidTitle |
لم يحدّد مرجع البث المباشر قيمة صالحة للسمة snippet.title . يجب أن يتراوح طول snippet.title بين حرف واحد و100 حرف. |
notFound (404) |
liveBroadcastNotFound |
لم تحدّد السمة id المحدّدة في مصدر liveBroadcast بثًا مباشرًا. |
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 |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم الاطّلاع على مزيد من المعلومات على الرابطَين
https://support.google.com/youtube/answer/2474026 و
https://www.youtube.com/features. |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
أرسل المستخدم عددًا كبيرًا جدًا من الطلبات خلال إطار زمني معيّن. |
required (400) |
idRequired |
يجب أن تحدّد المَعلمة id المطلوبة البث الذي تريد إدراج نقطة إشارة فيه. |
required (400) |
cueTypeRequired |
يجب تحديد الحقل cueType المطلوب في نص طلب واجهة برمجة التطبيقات. |
notFound (404) |
liveBroadcastNotFound |
لا تتوفّر البث المباشر المحدّد بالمعلَمة id . |
invalidValue (400) |
conflictingTimeFields |
يمكن تحديد قيمة واحدة فقط من insertionOffsetTimeMs وwalltimeMs . سيؤدي ضبط كلتا القيمتين إلى حدوث خطأ. إذا لم تضبط أيًا من القيمتين، سيستخدم YouTube الوقت التلقائي insertionOffsetTimeMs (0 )، ما يعني أنّه سيتم إدراج نقطة الإشارة في أقرب وقت ممكن. |
invalidValue (400) |
invalidInsertionOffsetTimeMs |
حدّد المرجع cuepoint قيمة غير صالحة للسمة insertionOffsetTimeMs . يجب أن تكون القيمة 0 أو عددًا صحيحًا موجبًا. |
invalidValue (400) |
invalidWalltimeMs |
حدّد المرجع cuepoint قيمة غير صالحة للسمة walltimeMs . يجب أن تكون القيمة عددًا صحيحًا يمثّل طابعًا زمنيًا
للحقبة. |
backendError (5xx) |
serviceUnavailable |
الخدمة غير متاحة. يُرجى إعادة المحاولة بعد بضع دقائق. |
liveChatBans
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد 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
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد 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 |
المحادثة المباشرة المحدّدة في طلب واجهة برمجة التطبيقات غير متوفّرة. يحدث هذا الخطأ إذا حذف المالك المحادثة. |
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 |
تم إرسال الطلب بسرعة كبيرة بعد الطلب السابق. يحدث هذا الخطأ عندما يتم إرسال طلبات إلى واجهة برمجة التطبيقات لاسترداد الرسائل بوتيرة أسرع من معدّلات إعادة التحميل في YouTube، ما يؤدي إلى استهلاك النطاق الترددي بدون داعٍ. |
liveCuepoints
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد liveCuepoints
.
liveCuepoints.insert
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
invalidValue (400) |
conflictingTimeFields |
يمكن تحديد إحدى القيمتين offsetTimeMs وwalltime فقط. |
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 |
تم إرسال الطلب بسرعة كبيرة بعد الطلب السابق. يحدث هذا الخطأ عندما يتم إرسال طلبات إلى واجهة برمجة التطبيقات لاسترداد الرسائل بوتيرة أسرع من معدّلات إعادة التحميل في YouTube، ما يؤدي إلى استهلاك النطاق الترددي بدون داعٍ. |
liveCuepoints
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد liveCuepoints
.
liveCuepoints.insert
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
invalidValue (400) |
conflictingTimeFields |
يمكن تحديد إحدى القيمتين offsetTimeMs وwalltime فقط. |
liveStreams
تحدّد الجداول التالية رسائل الخطأ التي تعرضها واجهة برمجة التطبيقات استجابةً لطلبات متعلقة بموارد liveStreams
.
liveStreams.delete
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
forbidden (403) |
liveStreamDeletionNotAllowed |
لا يمكن حذف البث المباشر المحدّد لأنّه مرتبط ببث لم يكتمل بعد. |
insufficientPermissions |
insufficientLivePermissions |
لا يُسمح للطلب بحذف حدث البث المباشر المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ مصادقة OAuth 2.0. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. لمزيد من المعلومات، يمكنك الاطّلاع على أهلية استخدام الميزات. |
notFound (404) |
liveStreamNotFound |
لا يتوفّر حدث البث المباشر المحدّد. |
liveStreams.insert
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
insufficientPermissions |
insufficientLivePermissions |
لا يُسمح للطلب بإنشاء البث المباشر المحدّد. |
insufficientPermissions |
livePermissionBlocked |
لا يمكن للمستخدم الذي منح الإذن بإرسال الطلب بث فيديو مباشر على YouTube في الوقت الحالي. قد تتوفّر تفاصيل توضّح سبب عدم إمكانية بث الفيديو مباشرةً في إعدادات قناة المستخدم على https://www.youtube.com/features. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على 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 بين حرف واحد و128 حرفًا. |
rateLimitExceeded |
userRequestsExceedRateLimit |
أرسل المستخدم عددًا كبيرًا جدًا من الطلبات خلال إطار زمني معيّن. |
required (400) |
cdnRequired |
يجب أن يحتوي المرجع liveStream على العنصر cdn . |
required (400) |
frameRateRequired |
تعرض واجهة برمجة التطبيقات هذا الخطأ إذا حدّدت قيمة للسمة cdn.resolution ولكن ليس للسمة cdn.frameRate . |
required (400) |
ingestionTypeRequired |
يجب أن يحدّد مرجع liveStream قيمة للسمة cdn.ingestionType . |
required (400) |
resolutionRequired |
تعرض واجهة برمجة التطبيقات هذا الخطأ إذا حدّدت قيمة للسمة cdn.frameRate ولكن ليس للسمة cdn.resolution . |
required (400) |
titleRequired |
يجب أن يحدّد المرجع liveStream قيمة للسمة snippet.title . |
liveStreams.list
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
insufficientPermissions |
insufficientLivePermissions |
لا يُسمح للطلب باسترداد البث المباشر المحدّد. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features. |
liveStreams.update
نوع الخطأ |
تفاصيل الخطأ |
الوصف |
forbidden (403) |
liveStreamModificationNotAllowed |
لا يمكن تعديل البث المباشر المحدّد في حالته الحالية. لمزيد من المعلومات، يُرجى الاطّلاع على مدة البث. |
forbidden (403) |
liveStreamModificationNotAllowed |
لا تسمح لك واجهة برمجة التطبيقات بتغيير قيمة الحقول cdn.format أو cdn.frameRate أو cdn.ingestionType أو cdn.resolution بعد إنشاء البث. |
forbidden (403) |
liveStreamModificationNotAllowed |
لا تسمح لك واجهة برمجة التطبيقات بتغيير مجموعة بث قابلة لإعادة الاستخدام إلى مجموعة غير قابلة لإعادة الاستخدام، أو العكس. لمزيد من المعلومات، اطّلِع على التعرّف على البث المباشر. |
insufficientPermissions |
insufficientLivePermissions |
لا يُسمح للطلب بتعديل البث المباشر المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ مصادقة OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
المستخدم الذي وافق على الطلب غير مؤهّل لبث فيديو مباشر على YouTube. يمكن للمستخدم العثور على مزيد من المعلومات على https://www.youtube.com/features. |
invalidValue (400) |
invalidDescription |
يمكن أن تتضمّن قيمة السمة snippet.description في مورد liveStream ما يصل إلى 10,000 حرف. |
invalidValue (400) |
invalidTitle |
يجب أن يتراوح طول قيمة السمة snippet.title في مرجع liveStream بين حرف واحد و128 حرفًا. |
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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe API returns \u003ccode\u003eforbidden (403)\u003c/code\u003e or \u003ccode\u003einsufficientPermissions\u003c/code\u003e errors when a user lacks the necessary authorization to perform an action, such as creating, deleting, or viewing resources.\u003c/p\u003e\n"],["\u003cp\u003eSeveral API calls related to live broadcasts, streams, and cuepoints may return a \u003ccode\u003eliveStreamingNotEnabled\u003c/code\u003e error, which means that the user has not enabled live streaming for their channel.\u003c/p\u003e\n"],["\u003cp\u003eMany errors across different API resources are caused by \u003ccode\u003einvalidValue (400)\u003c/code\u003e issues, including invalid descriptions, titles, privacy status, or time-related fields, which indicate that the provided data does not meet the required criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequests can fail with a \u003ccode\u003erateLimitExceeded\u003c/code\u003e error if a user surpasses the allowed request rate, which could happen in multiple \u003ccode\u003eliveBroadcasts\u003c/code\u003e, \u003ccode\u003eliveChatMessages\u003c/code\u003e, or \u003ccode\u003eliveStreams\u003c/code\u003e operations.\u003c/p\u003e\n"],["\u003cp\u003eMany errors indicate a \u003ccode\u003enotFound (404)\u003c/code\u003e issue, indicating that a broadcast, stream, chat, message, or ban cannot be located, which often signals an incorrect or deleted resource.\u003c/p\u003e\n"]]],["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"],null,[]]