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

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