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

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

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

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. في بث المحادثة المباشرة على 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 تعرض هذه السمة الرعاة للقناة. يجب أن يوافق مالك القناة على طلب البيانات من واجهة برمجة التطبيقات.