LiveBroadcasts: transition

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

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

الطلب

طلب HTTP

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

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات عن المصادقة والترخيص).

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

نص الطلب

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

الإجابة

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
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.

تجربة

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