مرجع حول API

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

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

LiveBroadcasts

يمثّل مرجع liveBroadcast حدثًا سيتم بثه مباشرةً على YouTube.

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

الطريقة طلب HTTP الوصف
معرّفات الموارد المنتظمة (URI) ذات الصلة بـ https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind يربط هذا النوع بثًا على YouTube ببث مباشر أو يزيل ربطًا حاليًا بين بث مباشر وبث على 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 تعرض هذه الطريقة رسائل المحادثة المباشرة لمحادثة معيّنة.
streamList تتيح هذه السمة إنشاء اتصال لبث المحتوى من الخادم بهدف تلقّي رسائل المحادثة المباشرة في محادثة معيّنة بوقت استجابة بطيء.

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 يومًا.