הטמעה: שידורים והאזנות

בדוגמאות הבאות אפשר לראות איך משתמשים ב-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"
  }
}

קישור השידור לסטרימינג

מפעילים את ה-method‏ 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

אחזור שידורים

מפעילים את ה-method‏ 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