التنفيذ: عمليات البث والتدفقات

تعرض الأمثلة التالية كيفية استخدام YouTube Live Streaming API لإنشاء وإدارة عمليات البث المباشر.

إنشاء بث

استدعِ طريقة liveBroadcasts.insert لتحديد موعد لحدث مباشر جديد. يجب أن يحدّد نص الطلب عنوان البث المباشر ووقت البدء المجدوَل وحالة الخصوصية. يمكنك أيضًا تحديد فئة الفيديو بشكل اختياري باستخدام السمة snippet.categoryId. يمكنك استرداد قائمة بالفئات باستخدام طريقة videoCategories.list.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.insert?
        part=snippet,status

يحتوي نص الطلب على مورد liveBroadcast. في هذا المثال، يكون نص الطلب كما يلي:

{
  "snippet": {
    "title": "My Live Event",
    "scheduledStartTime": "2026-10-30T19:00:00Z",
    "categoryId": "17"
  },
  "status": {
    "privacyStatus": "unlisted"
  }
}

إنشاء مصدر بيانات

استخدِم طريقة liveStreams.insert لإنشاء بث يحدّد إعدادات الإرسال للفيديو. يجب تحديد عنوان البث وإعدادات شبكة توصيل المحتوى (CDN) (نوع نقل البيانات ودرجة الدقة وعدد اللقطات في الثانية).

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveStreams.insert?
        part=snippet,cdn

يحتوي نص الطلب على مورد liveStream. في هذا المثال، يكون نص الطلب كما يلي:

{
  "snippet": {
    "title": "My Live Stream"
  },
  "cdn": {
    "frameRate": "30fps",
    "ingestionType": "rtmp",
    "resolution": "720p"
  }
}

ربط البث المباشر بالبث

استدعاء الطريقة liveBroadcasts.bind لربط البث المباشر بالبث اضبط المَعلمة id على معرّف البث والمَعلمة streamId على معرّف مصدر البيانات.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.bind?
        id=BROADCAST_ID
        &streamId=STREAM_ID
        &part=id,snippet

حالة بث الانتقال

استدعِ الطريقة liveBroadcasts.transition لتغيير حالة البث. على سبيل المثال، لبدء الاختبار، غيِّر الحالة إلى testing. لبدء البث الفعلي، غيِّر الحالة إلى live.

ينقل هذا المثال البث إلى testing. اضبط المَعلمة id على معرّف البث والمَعلمة broadcastStatus على testing.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.transition?
        broadcastStatus=testing
        &id=BROADCAST_ID
        &part=id,status

استرداد عمليات البث

استدعاء طريقة liveBroadcasts.list لاسترداد أحداث البث يمكنك الفلترة حسب broadcastStatus (مثل active أو completed أو upcoming) أو استرداد أحداث البث الخاصة بك باستخدام المَعلمة mine.

يستردّ هذا المثال أحداث البث القادمة للمستخدم الذي تمت مصادقته.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.list?
        part=snippet,status
        &broadcastStatus=upcoming
        &mine=true