Poniższe przykłady pokazują, jak używać interfejsu YouTube Live Streaming API do tworzenia transmisji na żywo i strumieni oraz zarządzania nimi.
Tworzenie transmisji
Aby zaplanować nowe wydarzenie na żywo, wywołaj metodę liveBroadcasts.insert. Treść żądania musi określać tytuł transmisji, zaplanowaną godzinę rozpoczęcia i stan prywatności. Opcjonalnie możesz też określić kategorię filmu za pomocą właściwości snippet.categoryId. Listę kategorii możesz pobrać za pomocą metody videoCategories.list.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.insert? part=snippet,status
Treść żądania zawiera zasób liveBroadcast. W tym przykładzie treść żądania wygląda tak:
{
"snippet": {
"title": "My Live Event",
"scheduledStartTime": "2026-10-30T19:00:00Z",
"categoryId": "17"
},
"status": {
"privacyStatus": "unlisted"
}
}Tworzenie strumienia
Aby utworzyć strumień, który określa ustawienia transmisji filmu, wywołaj metodę liveStreams.insert. Musisz określić tytuł strumienia i jego ustawienia CDN (typ pozyskiwania, rozdzielczość i liczba klatek na sekundę).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveStreams.insert? part=snippet,cdn
Treść żądania zawiera zasób liveStream. W tym przykładzie treść żądania wygląda tak:
{
"snippet": {
"title": "My Live Stream"
},
"cdn": {
"frameRate": "30fps",
"ingestionType": "rtmp",
"resolution": "720p"
}
}Powiązanie transmisji ze strumieniem
Aby powiązać transmisję ze strumieniem, wywołaj metodę liveBroadcasts.bind. Ustaw parametr id na identyfikator transmisji, a parametr zapytania streamId na identyfikator strumienia.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.bind? id=BROADCAST_ID &streamId=STREAM_ID &part=id,snippet
Zmiana stanu transmisji
Aby zmienić stan transmisji, wywołaj metodę liveBroadcasts.transition. Aby na przykład rozpocząć testowanie, zmień stan na testing. Aby rozpocząć transmisję, zmień stan na live.
Ten przykład zmienia stan transmisji na testing. Ustaw parametr id na identyfikator transmisji, a parametr broadcastStatus na testing.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.transition? broadcastStatus=testing &id=BROADCAST_ID &part=id,status
Pobieranie transmisji
Aby pobrać transmisje, wywołaj metodę liveBroadcasts.list. Możesz filtrować według parametru broadcastStatus (np. active, completed, upcoming) lub pobrać własne transmisje za pomocą parametru mine.
Ten przykład pobiera nadchodzące transmisje uwierzytelnionego użytkownika.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.list? part=snippet,status &broadcastStatus=upcoming &mine=true