LiveStreams: delete

حذف فيديو مضمّن

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

الطلب

طلب HTTP

DELETE https://www.googleapis.com/youtube/v3/liveStreams

التفويض

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

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

المعلمات

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

المعلمات
المَعلمات المطلوبة
id string
تحدّد المَعلمة id معرّف البث المباشر على YouTube للمورد الذي سيتم حذفه.
المَعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلّا في طلب مفوَّض بشكل صحيح.
ملاحظة: هذه المعلمة مخصصة حصريًا لشركاء المحتوى في YouTube.

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

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

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

نص الطلب

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

الإجابة

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

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) liveStreamDeletionNotAllowed لا يمكن حذف البث المباشر المحدّد لأنّه مرتبط ببث لم يكتمل بعد.
insufficientPermissions insufficientLivePermissions لا يُسمح للطلب بحذف البث المباشر المحدَّد. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ مصادقة OAuth2.
insufficientPermissions liveStreamingNotEnabled لم يتم تفعيل المستخدم الذي فوّض الطلب لبث فيديو مباشر على YouTube. لمزيد من المعلومات، يُرجى الاطّلاع على الأهلية لاستخدام الميزات.
notFound (404) liveStreamNotFound البث المباشر المحدد غير موجود.

تجربة

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