Contoh berikut menunjukkan cara menggunakan YouTube Live Streaming API untuk membuat dan mengelola siaran dan streaming live.
Membuat siaran
Panggil metode liveBroadcasts.insert untuk menjadwalkan acara live baru. Isi permintaan harus menentukan judul siaran, waktu mulai yang dijadwalkan, dan status privasi. Anda juga dapat menentukan kategori video secara opsional menggunakan properti snippet.categoryId. Anda dapat mengambil daftar kategori menggunakan metode videoCategories.list.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.insert? part=snippet,status
Isi permintaan berisi resource liveBroadcast. Dalam contoh ini, isi permintaannya adalah:
{
"snippet": {
"title": "My Live Event",
"scheduledStartTime": "2026-10-30T19:00:00Z",
"categoryId": "17"
},
"status": {
"privacyStatus": "unlisted"
}
}Membuat stream
Panggil metode liveStreams.insert untuk membuat streaming yang menentukan setelan transmisi untuk video Anda. Anda harus menentukan judul streaming dan setelan CDN-nya (jenis penyerapan, resolusi, dan kecepatan frame).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveStreams.insert? part=snippet,cdn
Isi permintaan berisi resource liveStream. Dalam contoh ini, isi permintaannya adalah:
{
"snippet": {
"title": "My Live Stream"
},
"cdn": {
"frameRate": "30fps",
"ingestionType": "rtmp",
"resolution": "720p"
}
}Mengikat siaran ke streaming
Panggil metode liveBroadcasts.bind untuk mengaitkan siaran dengan streaming Anda. Tetapkan parameter id ke ID siaran dan parameter kueri streamId ke ID streaming.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.bind? id=BROADCAST_ID &streamId=STREAM_ID &part=id,snippet
Status siaran transisi
Panggil metode liveBroadcasts.transition untuk mengubah status siaran Anda. Misalnya, untuk memulai pengujian, ubah status menjadi testing. Untuk memulai siaran yang sebenarnya, ubah statusnya menjadi live.
Contoh ini mentransisikan siaran ke testing. Tetapkan parameter id ke ID siaran dan parameter broadcastStatus ke testing.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.transition? broadcastStatus=testing &id=BROADCAST_ID &part=id,status
Mengambil siaran
Panggil metode liveBroadcasts.list untuk mengambil siaran. Anda dapat memfilter berdasarkan broadcastStatus (misalnya, active, completed, upcoming) atau mengambil siaran Anda sendiri menggunakan parameter mine.
Contoh ini mengambil siaran mendatang pengguna yang diautentikasi.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.list? part=snippet,status &broadcastStatus=upcoming &mine=true