การติดตั้งใช้งาน: การออกอากาศและสตรีม

ตัวอย่างต่อไปนี้แสดงวิธีใช้ 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