Các ví dụ sau đây minh hoạ cách sử dụng YouTube Live Streaming API để tạo và quản lý các chương trình phát sóng và sự kiện phát trực tiếp.
Tạo chương trình phát sóng
Gọi phương thức liveBroadcasts.insert để lên lịch cho một sự kiện trực tiếp mới. Nội dung yêu cầu phải xác định tiêu đề, thời gian bắt đầu theo lịch và trạng thái riêng tư của chương trình phát sóng. Bạn cũng có thể chỉ định danh mục video bằng thuộc tính snippet.categoryId (không bắt buộc). Bạn có thể truy xuất danh sách danh mục bằng phương thức videoCategories.list.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.insert? part=snippet,status
Nội dung yêu cầu chứa tài nguyên liveBroadcast. Trong ví dụ này, nội dung yêu cầu là:
{
"snippet": {
"title": "My Live Event",
"scheduledStartTime": "2026-10-30T19:00:00Z",
"categoryId": "17"
},
"status": {
"privacyStatus": "unlisted"
}
}Tạo luồng
Gọi phương thức liveStreams.insert để tạo một luồng xác định chế độ cài đặt truyền cho video của bạn. Bạn phải chỉ định tiêu đề của sự kiện phát trực tiếp và chế độ cài đặt CDN (loại nhập, độ phân giải và tốc độ khung hình).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveStreams.insert? part=snippet,cdn
Nội dung yêu cầu chứa tài nguyên liveStream. Trong ví dụ này, phần nội dung yêu cầu là:
{
"snippet": {
"title": "My Live Stream"
},
"cdn": {
"frameRate": "30fps",
"ingestionType": "rtmp",
"resolution": "720p"
}
}Liên kết chương trình phát sóng với sự kiện phát trực tiếp
Gọi phương thức liveBroadcasts.bind để liên kết sự kiện phát sóng với sự kiện phát trực tiếp. Đặt tham số id thành mã sự kiện phát trực tiếp và tham số truy vấn streamId thành mã sự kiện phát trực tiếp.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.bind? id=BROADCAST_ID &streamId=STREAM_ID &part=id,snippet
Trạng thái truyền phát chuyển đổi
Gọi phương thức liveBroadcasts.transition để thay đổi trạng thái của sự kiện phát sóng. Ví dụ: để bắt đầu kiểm thử, hãy chuyển trạng thái thành testing. Để bắt đầu phát sóng thực tế, hãy chuyển trạng thái thành live.
Ví dụ này chuyển sự kiện phát sóng sang trạng thái testing. Đặt tham số id thành mã sự kiện phát sóng và tham số broadcastStatus thành testing.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.transition? broadcastStatus=testing &id=BROADCAST_ID &part=id,status
Truy xuất nội dung truyền phát
Gọi phương thức liveBroadcasts.list để truy xuất thông báo truyền tin. Bạn có thể lọc theo broadcastStatus (ví dụ: active, completed, upcoming) hoặc truy xuất các bản phát sóng của riêng bạn bằng cách sử dụng tham số mine.
Ví dụ này truy xuất các chương trình phát sóng sắp tới của người dùng đã xác thực.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.list? part=snippet,status &broadcastStatus=upcoming &mine=true