LiveBroadcasts: transition

تغيّر هذه الطريقة حالة بث مباشر على YouTube وتبدأ أي عمليات مرتبطة بالحالة الجديدة. على سبيل المثال، عندما تنقل حالة بث إلى testing، يبدأ YouTube بنقل الفيديو إلى بث المراقبة الخاص بهذا البث. قبل استدعاء هذه الطريقة، يجب التأكّد من أنّ قيمة السمة status.streamStatus للتدفق المرتبط ببثك المباشر هي active.

حالات الاستخدام الشائعة

طلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition

التفويض

يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية. للمزيد من المعلومات حول المصادقة والتفويض، يُرجى الاطّلاع على مقالة تنفيذ مصادقة OAuth 2.0.

النطاق
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يعرض الجدول التالي المَعلمات التي يتيحها هذا الطلب. جميع المَعلمات المدرَجة هي مَعلمات طلب البحث.

المعلمات
المَعلمات المطلوبة
broadcastStatus string
تحدّد المَعلمة broadcastStatus الحالة التي يتغيّر إليها البث. يُرجى العِلم أنّه لنقل بث إلى الحالة testing أو live، يجب أن تكون قيمة status.streamStatus هي active للبث المرتبط به.

القيم المقبولة هي:
  • complete – انتهى البث. يتوقف YouTube عن بث الفيديو.
  • live: يمكن للجمهور مشاهدة البث. ينقل YouTube الفيديو إلى بث المراقبة والبث المباشر.
  • ‫testing: ابدأوا باختبار البث. ينقل YouTube الفيديو إلى بث المراقبة الخاص بالبث المباشر. يُرجى العِلم أنّه يمكنك نقل بث إلى الحالة testing فقط إذا تم ضبط السمة contentDetails.monitorStream.enableMonitorStream على true.
id string
تحدّد المَعلمة id المعرّف الفريد للبث الذي ينتقل إلى حالة أخرى.
part string
تحدّد المَعلمة part قائمة قيم مفصولة بفاصلة لسمة واحدة أو أكثر من سمات المورد liveBroadcast التي سيتضمّنها الردّ من واجهة برمجة التطبيقات. إنّ أسماء part التي يمكنك تضمينها في قيمة المَعلمة هي id وsnippet وcontentDetails وstatus.
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب مصرَّح به بشكل صحيح.

ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.

تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض الخاصة بالطلب تحدّد مستخدمًا لنظام إدارة محتوى YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى في YouTube الذين يملكون ويديرون العديد من قنوات على YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق عليه المستخدم بحساب مالك المحتوى المحدّد على YouTube.
onBehalfOfContentOwnerChannel string
لا يمكن استخدام هذه المَعلمة إلا في طلب مصرَّح به بشكل صحيح.

ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى في YouTube.

تحدّد المَعلمة onBehalfOfContentOwnerChannel معرّف القناة على YouTube التي تتم إضافة الفيديو إليها. هذه المَعلمة مطلوبة عندما يحدّد الطلب قيمة للمَعلمة onBehalfOfContentOwner، ولا يمكن استخدامها إلا مع هذه المَعلمة. بالإضافة إلى ذلك، يجب تفويض الطلب باستخدام حساب على نظام إدارة المحتوى (CMS) مرتبط بمالك المحتوى الذي تحدّده المَعلمة onBehalfOfContentOwner. أخيرًا، يجب أن تكون القناة التي تحدّدها قيمة المَعلمة onBehalfOfContentOwnerChannel مرتبطة بمالك المحتوى الذي تحدّده المَعلمة onBehalfOfContentOwner.

هذه المَعلمة مخصّصة لشركاء المحتوى في YouTube الذين يملكون ويديرون العديد من القنوات المختلفة على YouTube. يتيح هذا الخيار لمالكي المحتوى المصادقة مرة واحدة وتنفيذ إجراءات نيابةً عن القناة المحدّدة في قيمة المَعلمة، بدون الحاجة إلى تقديم بيانات اعتماد للمصادقة لكل قناة على حدة.

نص الطلب

لا تقدِّم نص الطلب عند استدعاء هذه الطريقة.

الردّ

في حال نجاح الطلب، تعرض هذه الطريقة مورد liveBroadcast في نص الاستجابة.

الأخطاء

يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب هذه الطريقة. لمزيد من التفاصيل، يُرجى الاطّلاع على YouTube Live Streaming API - الأخطاء.

نوع الخطأ تفاصيل الخطأ الوصف
backendError errorExecutingTransition حدث خطأ أثناء تغيير حالة البث.
forbidden (403) errorStreamInactive لا يُسمح بالانتقال المطلوب عندما يكون البث المرتبط بالبث المباشر غير نشط.
forbidden (403) invalidTransition لا يمكن نقل البث المباشر من حالته الحالية إلى الحالة المطلوبة.
forbidden (403) redundantTransition البث المباشر في الحالة المطلوبة أو قيد المعالجة للوصول إلى الحالة المطلوبة
insufficientPermissions insufficientLivePermissions لا يمكن للطلب نقل البث المباشر.
insufficientPermissions livePermissionBlocked لا يمكن للمستخدم الذي منح الإذن بإرسال الطلب بث فيديو مباشر على YouTube في الوقت الحالي. للاطّلاع على تفاصيل توضّح سبب عدم إمكانية بث فيديو مباشر، يُرجى الانتقال إلى إعدادات قناة المستخدم على أهلية استخدام الميزات.
insufficientPermissions liveStreamingNotEnabled المستخدم الذي سمح بالطلب غير مسموح له ببث فيديو مباشر على YouTube. لمزيد من المعلومات، اطّلِع على أهلية استخدام الميزات.
notFound (404) liveBroadcastNotFound البث المحدّد بواسطة المَعلمة id غير متوفّر.
rateLimitExceeded (403) userRequestsExceedRateLimit أرسل المستخدم عددًا كبيرًا جدًا من الطلبات في إطار زمني معيّن.
rateLimitExceeded (403) concurrentBroadcastsExceedLimit تضمّ القناة حاليًا الحدّ الأقصى المسموح به من أحداث البث المباشر المتزامنة. يجب إيقاف بث واحد أو أكثر من أحداث البث المباشر قبل بدء بث آخر على القناة.
rateLimitExceeded (403) sharedIngestionBroadcastsExceedLimit تضمّ القناة حاليًا الحدّ الأقصى لعدد أحداث البث المباشر التي تشارك مصدر نقل البيانات. يجب إيقاف بث واحد أو أكثر من عمليات البث هذه لبدء عملية البث المطلوبة.
required (400) idRequired يجب أن تحدّد المَعلمة id المطلوبة البث الذي تريد تغيير حالته.
required (400) statusRequired يجب أن يحدّد طلب البيانات من واجهة برمجة التطبيقات قيمة للمَعلمة status.

جرِّبها الآن.

استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة.