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 المختلفة. ويسمح هذا الإجراء لمالكي المحتوى بالمصادقة مرة واحدة وتنفيذ الإجراءات نيابةً عن القناة المحدّدة في قيمة المَعلمة، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة منفصلة.

نص الطلب

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

الردّ

في حال نجاح هذه الطريقة، تُرجِع مورد بث مباشر في نص الاستجابة.

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
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 أرسل المستخدم عددًا كبيرًا جدًا من الطلبات في إطار زمني معيّن.
required (400) idRequired يجب أن تحدِّد المَعلمة المطلوبة id البث الذي تريد تغيير حالته.
required (400) statusRequired يجب أن يحدّد طلب واجهة برمجة التطبيقات قيمة للمَعلمة status.

جرّب الآن

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