مرجع واجهة برمجة تطبيقات

يشرح مرجع واجهة برمجة التطبيقات هذا كيفية جدولة عمليات البث المباشر وأحداث الفيديو على YouTube باستخدام واجهة برمجة التطبيقات لبث YouTube المباشر.

أنواع الموارد

LiveBroadcasts

يمثّل مورد liveBroadcast حدثًا سيتم بثه من خلال فيديو مباشر على YouTube.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
bind	POST /liveBroadcasts/bind	ربط بث على YouTube ببث أو إزالة ربط حالي بين بث وبث. لا يمكن ربط البث بأكثر من بث فيديو واحد، ولكن قد يتم ربط بث الفيديو بأكثر من بث واحد.
delete	DELETE /liveBroadcasts	يؤدي هذا الإجراء إلى حذف بث.
insert	POST /liveBroadcasts	لإنشاء بث.
list	GET /liveBroadcasts	عرض قائمة بعمليات بث YouTube التي تتطابق مع معلَمات طلب البيانات من واجهة برمجة التطبيقات.
transition	POST /liveBroadcasts/transition	تغيير حالة بث YouTube المباشر وبدء أي عمليات مرتبطة بالحالة الجديدة على سبيل المثال، عند تغيير حالة البث إلى testing، تبدأ منصة YouTube في نقل الفيديو إلى بث شاشة البث. قبل طلب هذه الطريقة، عليك التأكّد من أنّ قيمة السمة status.streamStatus للبث المرتبط بالبث هي active.
update	PUT /liveBroadcasts	لتعديل بث. على سبيل المثال، يمكنك تعديل إعدادات البث المحددة في عنصر contentDetails للمورد liveBroadcast.
cuepoint	POST /liveBroadcasts/cuepoint	لإدراج نقطة إشارة في بث مباشر. قد تؤدي نقطة الإشارة إلى عرض فاصل إعلاني.

LiveChatBans

يحدّد مورد liveChatBan مستخدمًا على YouTube ومحادثة مباشرة على YouTube تم حظر هذا المستخدم من المشاركة فيها.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /liveChat/bans	إزالة الحظر الذي يمنع مستخدمًا محددًا من المشاركة في محادثة مباشرة، ما يتيح للمستخدم إعادة الانضمام إلى المحادثة يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من مالك القناة أو المشرف على المحادثة المباشرة المرتبطة بالحظر.
insert	POST /liveChat/bans	حظر مستخدم معيّن من المشاركة في الدردشة المباشرة يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من مالك القناة أو المشرف على المحادثة المباشرة المرتبطة بالحظر.

LiveChatMessages

يمثّل المرجع liveChatMessage رسالة محادثة ضمن محادثة مباشرة على YouTube. يمكن أن يتضمّن المرجع تفاصيل حول أنواع متعدّدة من الرسائل، بما في ذلك رسالة نصية منشورة حديثًا أو حدث تمويل من المعجبين.

تكون ميزة المحادثة المباشرة مفعَّلة تلقائيًا لأحداث البث المباشر وتتوفّر عندما يكون الحدث المباشر نشطًا. (بعد انتهاء الحدث، لن تبقى المحادثة المباشرة متوفّرة لذلك الحدث).

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /liveChat/messages	حذف رسالة محادثة يجب أن يكون طلب البيانات من واجهة برمجة التطبيقات معتمَدًا من مالك القناة أو المشرف على المحادثة المباشرة المرتبطة بالحظر.
insert	POST /liveChat/messages	إضافة رسالة إلى محادثة مباشرة
list	GET /liveChat/messages	يعرض رسائل المحادثة المباشرة الخاصة بمحادثة محدّدة.

LiveChatModerators

يمثّل المرجع liveChatModerator مشرفًا على محادثة مباشرة على YouTube. يمكن لمشرف المحادثة حظر المستخدمين أو إلغاء حظرهم من المحادثة وإزالة الرسائل وتنفيذ إجراءات إدارية أخرى في المحادثة المباشرة.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /liveChat/moderators	إزالة مشرف على المحادثة ويجب أن يوافق مالك قناة البث المباشر على هذا الطلب.
insert	POST /liveChat/moderators	إضافة مشرف جديد للمحادثة ويجب أن يوافق مالك قناة البث المباشر على هذا الطلب.
list	GET /liveChat/moderators	يسرد المشرفين على محادثة مباشرة. ويجب أن يوافق مالك قناة البث المباشر على هذا الطلب.

LiveStreams

يحتوي مورد liveStream على معلومات عن الفيديو المضمّن الذي تنقله إلى YouTube. توفر مجموعة البث المحتوى الذي سيتم بثه إلى مستخدمي YouTube. بعد إنشاء مورد liveStream، يمكن ربط مورد liveBroadcast واحد أو أكثر.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
delete	DELETE /liveStreams	حذف فيديو مضمّن
insert	POST /liveStreams	تُنشئ مجموعة بث فيديو. تتيح لك مجموعة البث إرسال الفيديو إلى YouTube الذي يمكن من خلاله بث الفيديو إلى الجمهور بعد ذلك.
list	GET /liveStreams	عرض قائمة بالفيديوهات المضمّنة التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات.
update	PUT /liveStreams	لتعديل فيديو مضمَّن. إذا تعذّر تعديل السمات التي تريد تغييرها، عليك إنشاء مصدر بيانات جديد باستخدام الإعدادات المناسبة.

SuperChatEvents

يمثّل المرجع superChatEvent رسالة Super Chat اشتراها أحد المعجبين أثناء بث مباشر على YouTube. تتميّز رسائل Super Chat عن الرسائل الأخرى بطريقتَين:

• يتم تمييز رسائل Super Chat بلون.
• تبقى رسائل Super Chat مثبّتة على شريط الدردشة لفترة زمنية محدّدة.

يتم تحديد لون رسالة Super Chat والمدة التي تبقى فيها مثبّتة على شريط الدردشة والحد الأقصى لطول الرسالة بالاستناد إلى مبلغ الشراء. يمكنك زيارة مركز مساعدة YouTube للحصول على المزيد من المعلومات حول رسائل Super Chat.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /superChatEvents	أدرِج أحداث Super Chat من أحداث البث المباشر على قناة في آخر 30 يومًا.

أنواع الموارد التي تم إيقافها نهائيًا

FanFundingEvents

يمثّل المرجع fanFundingEvent حدث "التمويل من المعجبين" على قناة YouTube. من خلال ميزة "التمويل من المعجبين"، يمكن مساعدة صنّاع المحتوى في YouTube على توفير الدعم المالي. تحدث ميزة "التمويل من المعجبين" عندما يسدّد المستخدم دفعة طوعية لمرة واحدة إلى قناة معيّنة. يمكنك مراجعة مركز مساعدة YouTube للحصول على المزيد من المعلومات حول ميزة "التمويل من المعجبين".

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /fanFundingEvents	يسرد أحداث "التمويل من المعجبين" لقناة. يجب أن يصادق مالك القناة على طلب البيانات من واجهة برمجة التطبيقات.

LiveCuepoints

يبدأ مورد liveCuepoint فاصلاً إعلانيًا في البث المباشر للفيديو.

ملاحظة: يشكّل أمر واجهة برمجة التطبيقات للتحكم في نقاط الاتصال جزءًا من واجهة برمجة تطبيقات Content ID في YouTube ولديه متطلبات تفويض مختلفة عن تلك التي تتطلبها طلبات إدارة موارد liveBroadcast وliveStream.

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/
insert	POST /liveCuepoints	لإدراج نقطة إشارة في بث مباشر. في الوقت الحالي، يجب أن يسمح حساب مرتبط بحساب مالك محتوى في YouTube بالطلبات المرتبطة بهذه الطريقة.

الرعاة

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

لمزيد من المعلومات عن هذا المورد، اطّلِع على تمثيل الموارد وقائمة الخصائص.

الطريقة	طلب HTTP	الوصف
معرّفات الموارد المنتظمة (URI) المتعلقة بـ https://www.googleapis.com/youtube/v3
list	GET /sponsors	يسرد الجهات الراعية لقناة. يجب أن يصادق مالك القناة على طلب البيانات من واجهة برمجة التطبيقات.