In den folgenden Beispielen wird gezeigt, wie du mit der YouTube Live Streaming API Live-Übertragungen und -Streams erstellen und verwalten kannst.
Übertragung erstellen
Rufe die Methode liveBroadcasts.insert auf, um eine neue Live-Veranstaltung zu planen. Im Anfragetext müssen der Titel der Übertragung, die geplante Startzeit und der Datenschutzstatus definiert werden. Optional kannst du mit der Property snippet.categoryId auch die Videokategorie angeben. Eine Liste der Kategorien kannst du mit der Methode videoCategories.list abrufen.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.insert? part=snippet,status
Der Anfragetext enthält eine liveBroadcast-Ressource. In diesem Beispiel sieht der Anfragetext so aus:
{
"snippet": {
"title": "My Live Event",
"scheduledStartTime": "2026-10-30T19:00:00Z",
"categoryId": "17"
},
"status": {
"privacyStatus": "unlisted"
}
}Stream erstellen
Rufe die Methode liveStreams.insert auf, um einen Stream zu erstellen, in dem die Übertragungseinstellungen für dein Video definiert werden. Du musst den Titel des Streams und die CDN-Einstellungen (Aufnahmetyp, Auflösung und Bildrate) angeben.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveStreams.insert? part=snippet,cdn
Der Anfragetext enthält eine liveStream-Ressource. In diesem Beispiel sieht der Anfragetext so aus:
{
"snippet": {
"title": "My Live Stream"
},
"cdn": {
"frameRate": "30fps",
"ingestionType": "rtmp",
"resolution": "720p"
}
}Übertragung mit Stream verknüpfen
Rufe die Methode liveBroadcasts.bind auf, um deine Übertragung mit deinem Stream zu verknüpfen. Setze den Parameter id auf die Übertragungs-ID und den Suchparameter streamId auf die Stream-ID.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.bind? id=BROADCAST_ID &streamId=STREAM_ID &part=id,snippet
Übertragungsstatus ändern
Rufe die Methode liveBroadcasts.transition auf, um den Status deiner Übertragung zu ändern. Wenn du beispielsweise mit dem Testen beginnen möchtest, ändere den Status zu testing. Um die eigentliche Übertragung zu starten, ändere den Status zu live.
In diesem Beispiel wird die Übertragung zu testing geändert. Setze den Parameter id auf die Übertragungs-ID und den Parameter broadcastStatus auf testing.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.transition? broadcastStatus=testing &id=BROADCAST_ID &part=id,status
Übertragungen abrufen
Rufe die Methode liveBroadcasts.list auf, um Übertragungen abzurufen. Du kannst nach broadcastStatus filtern (z.B. active, completed, upcoming) oder deine eigenen Übertragungen mit dem Parameter mine abrufen.
In diesem Beispiel werden die anstehenden Übertragungen des authentifizierten Nutzers abgerufen.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.liveBroadcasts.list? part=snippet,status &broadcastStatus=upcoming &mine=true