Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Das Leben einer Übertragung

Einführung

In diesem Dokument wird der Lebenszyklus einer Liveübertragung auf YouTube beschrieben, die mit der YouTube Live Streaming API und der YouTube Content ID API erstellt und verwaltet wird.

Ressourcen und Ressourcentypen

Wie im Startleitfaden erläutert, ist eine Ressource eine einzelne Datenentität mit einer eindeutigen Kennung. Zum Erstellen und Verwalten von Live-Veranstaltungen auf YouTube verwendest du verschiedene Ressourcentypen, die entweder in der YouTube Data API oder in der YouTube Content ID API definiert sind. Die unter dem Header YouTube Live Streaming API aufgeführten Ressourcen sind technisch in den anderen APIs definiert, werden aber separat aufgeführt, da sie nur für Live-Übertragungen verwendet werden.

Ressourcen zur YouTube Live Streaming API

YouTube Data API-Ressourcen

video

Ressourcen für die YouTube Content ID API

Liveübertragung erstellen und verwalten

In den folgenden Schritten wird beschrieben, wie du eine Live-Veranstaltung auf YouTube erstellst und verwaltest. Die Schritte sind in die folgenden Phasen unterteilt:

Übertragung einrichten
Rechte an Inhalten geltend machen
Testen
Nachricht an alle
Übertragung beenden
Referenz erstellen

Phase 1: Übertragung einrichten

Schritt 1.1: Broadcast erstellen

Rufe die Methode liveBroadcasts.insert auf, um deine Übertragung dem YouTube-Zeitplan für Live-Veranstaltungen hinzuzufügen. Die Ressource liveBroadcast, die Sie einfügen, muss Werte für die unten aufgeführten Attribute definieren.

Beachten Sie beim Einrichten der Übertragung die folgenden Richtlinien:

Wenn du eine Testphase für deine Übertragung einrichten möchtest, in der du deine Videoübertragung ansehen kannst, ohne dass andere Zuschauer sie sehen können, musst du die Property contentDetails.monitorStream.enableMonitorStream auf true und die Property contentDetails.enableAutoStart auf false setzen. Dies sind die Standardwerte für beide Properties.
Wenn du aus deiner aufgezeichneten Übertragung eine Referenz erstellen möchtest, musst du die Property contentDetails.recordFromStart der Übertragung auf true setzen. Wenn du das aufgezeichnete Video sofort nach Ende der Übertragung zur Wiedergabe verfügbar machen möchtest, musst du außerdem die Property contentDetails.enableDvr auf true festlegen. Beide Properties haben den Standardwert true.
Wenn du die Regionen einschränken möchtest, in denen deine Übertragung angesehen werden kann, kannst du die Property contentDetails.availabilityConfig festlegen. Mit dieser Property können Sie entweder bestimmte Regionen blockieren oder die Verfügbarkeit auf eine definierte Liste von Regionen beschränken. Sie können auch Zeitfenster für die regionale Verfügbarkeit angeben.
Mit der Property snippet.categoryId kannst du optional die Videokategorie für den Stream angeben. Wenn nichts angegeben ist, wird standardmäßig die Kategorie Entertainment verwendet.
Du kannst alle contentDetails-Eigenschaften aktualisieren, solange der Status deiner Übertragung noch created oder ready ist.
Du kannst die geplante Start- und Endzeit einer Übertragung aktualisieren, solange der Status der Übertragung created, ready oder testing ist.
Titel, Beschreibung, Kategorie, Datenschutzstatus und andere Metadatenfelder der Übertragung, die Teil der video-Ressource der Übertragung sind, können jederzeit aktualisiert werden.

Hinweis: Wenn dein Video nur für bestimmte YouTube-Nutzer verfügbar sein soll, lege den Wert des Attributs status.privacyStatus je nach Bedarf auf unlisted oder private fest.

API-Antwort verarbeiten

Wenn Sie die Methode liveBroadcasts.insert aufrufen, enthält die API-Antwort die von Ihnen erstellte liveBroadcast-Ressource. Ihr Code sollte die id aus dieser Ressource extrahieren und speichern. Sie benötigen diesen Wert, um den Stream in zukünftigen API-Anfragen zu identifizieren. (Sie können die video-Ressource, die der liveBroadcast-Ressource entspricht, auch anhand derselben ID identifizieren.)

Schritt 1.2: Stream erstellen

Mit einer liveStream-Ressource kannst du dein Video an YouTube übertragen und den Inhalt beschreiben, den du überträgst. Jede Übertragung muss genau einem Stream zugeordnet sein.

Rufen Sie die liveStreams.insert-Methode auf, um den Videostream für Ihr Event zu erstellen. Beim Erstellen des Streams müssen Sie Werte für die unten aufgeführten Attribute festlegen:

Mit Ausnahme des Streamtitels können diese Werte nach dem Erstellen des Streams nicht mehr aktualisiert werden. Wenn Sie sie ändern müssen, müssen Sie einen anderen Stream erstellen, indem Sie diesen Schritt wiederholen. Dieser Vorgang wird später in diesem Dokument in Schritt 3.5 ausführlicher erläutert.

Sie haben auch die Möglichkeit, Werte für die folgenden Attribute festzulegen:

snippet.description: Wie der Streamtitel kann auch die Stream-Beschreibung nach dem Erstellen des Streams aktualisiert werden. Weder der Titel noch die Beschreibung sind für YouTube-Nutzer sichtbar.
[contentDetails.isReusable](

/youtube/data/live/reference/rest/v3/liveStreams#contentDetails.isReusable)

Gibt an, ob der Stream wiederverwendbar ist, d. h. ob er an mehrere Übertragungen gebunden werden kann. Der Wert dieses Attributs bestimmt, ob ein Kanal eine n:1- oder eine 1:1-Beziehung zwischen liveBroadcast- und liveStream-Ressourcen hat:
- Wenn Sie den Standardwert true der Eigenschaft verwenden, können Sie dieselbe liveStream-Ressource für alle Übertragungen eines Kanals verwenden. Sie müssen diesen Schritt (1.2) also nicht für jede Übertragung wiederholen. Stattdessen kannst du die Stream-ID für nachfolgende Übertragungen einfach wiederverwenden.
- Wenn du den Attributwert auf false festlegst, musst du für jeden Stream einen neuen Stream erstellen.

Nachdem Sie die API-Anfrage für den Stream gesendet haben, enthält die API-Antwort die von Ihnen erstellte liveStream-Ressource. Ihr Code sollte die id aus dieser Ressource extrahieren und speichern. Sie benötigen diesen Wert, um den Stream in zukünftigen API-Anfragen zu identifizieren.

Schritt 1.3: Sendung mit dem Stream verknüpfen

Nachdem Sie die Ressourcen liveBroadcast und liveStream erstellt haben, müssen Sie sie mit der Methode liveBroadcasts.bind verknüpfen. Dadurch werden die Videobits, die du an YouTube überträgst, mit der Ereignisübertragung für dieses Video verknüpft.

Lege beim Aufrufen der Methode liveBroadcasts.bind den Parameter id auf die in Schritt 1.1 abgerufene Broadcast-ID und den Parameter streamId auf die in Schritt 1.2 abgerufene Stream-ID fest.

Phase 2: Inhalte beanspruchen

Wenn du während der Übertragung Anzeigen einblenden möchtest, musst du vor Beginn des Events Rechte am Video der Übertragung geltend machen. So richten Sie die Übertragung, das Video und die Anzeigen ein: Der Kanal des Inhabers der Übertragung muss für die Auslieferung von Anzeigen geeignet sein.

Alle in dieser Phase beschriebenen API-Aufrufe sind in der YouTube Content ID API definiert.

Schritt 2.1: Asset erstellen

Eine asset-Ressource stellt geistiges Eigentum dar. In diesem Fall ist das Asset deine Übertragung. Rufen Sie die Methode assets.insert auf, um Ihr Asset zu erstellen.

Die API-Antwort enthält die von Ihnen erstellte asset-Ressource. Ihr Code sollte die id aus dieser Ressource extrahieren und speichern, da Sie diesen Wert benötigen, um das Asset in zukünftigen API-Anfragen zu identifizieren.

Schritt 2.2: Eigentumsrechte am Asset definieren

Die Daten zu Eigentumsrechten eines Assets geben die Rechteinhaber eines Assets sowie die Gebiete an, in denen sie das Asset besitzen. YouTube verwendet diese Daten, um festzulegen, wo ein Inhaber die Richtlinie für ein Video mit Anspruch festlegen kann.

Wenn du beispielsweise die Rechte hast, ein Event in den USA zu übertragen, und ein anderer Sender dieselben Rechte für Kanada hat, könnt ihr jeweils unterschiedliche Richtlinien für das übertragene Video und für von Nutzern hochgeladene Videos festlegen, die mit dem übertragenen Video übereinstimmen. Deine Abgleichsrichtlinie wird auf übereinstimmende, von Nutzern hochgeladene Videos in den USA angewendet, während die Richtlinie des anderen Rechteinhabers für übereinstimmende Videos in Kanada gilt.

Rufen Sie die Methode ownership.update auf, um die Gebiete zu definieren, in denen Sie Eigentumsrechte für das Asset haben. Legen Sie in dieser Anfrage den Parameter assetId auf den id fest, den Sie in Schritt 2.1 gespeichert haben.

Schritt 2.3: Abgleichsrichtlinie des Assets festlegen

In der Abgleichsrichtlinie eines Assets wird festgelegt, was YouTube tun soll, wenn ein Nutzer ein Video hochlädt, das mit einer Referenz übereinstimmt, die mit dem Asset verknüpft ist. In diesem Fall gibt die Abgleichsrichtlinie an, wie YouTube mit einem hochgeladenen Video umgehen soll, das mit deiner Liveübertragung übereinstimmt.

Hinweis:Du solltest eine Abgleichsrichtlinie festlegen, wenn du eine Referenz aus deinem übertragenen Video erstellen und diese Referenz verwenden möchtest, um von Nutzern hochgeladene Videos zu identifizieren, die mit deiner Übertragung übereinstimmen. Ansonsten können Sie diesen Schritt überspringen.

Wenn du die Abgleichsrichtlinie festlegen möchtest, musst du zuerst die Richtlinie ermitteln, die du anwenden möchtest. Sie können eine Liste der vorhandenen Richtlinien abrufen, indem Sie die Methode policies.list aufrufen. Alternativ können Sie eine neue Richtlinie definieren, indem Sie die Methode policies.insert aufrufen. In beiden Fällen müssen Sie die id der Richtlinie erfassen, die Sie anwenden möchten.

Rufen Sie die Methode assetMatchPolicy.update auf, sobald Sie die Richtlinie ermittelt haben. Legen Sie in dieser Anfrage den Parameter assetId auf den id fest, den Sie in Schritt 2.1 gespeichert haben.

Schritt 2.4: Anspruch auf Video erheben

In diesem Schritt erstellst du einen Anspruch, der das Video, das du streamen wirst, mit dem Asset verknüpft, das du in Schritt 2.1 erstellt hast. Mit dem Anspruch wird eine Richtlinie festgelegt, die nur für dein übertragenes Video gilt. Von Nutzern hochgeladene Videos, die mit deinem Broadcast-Video übereinstimmen, unterliegen der im vorherigen Schritt festgelegten Richtlinie für Übereinstimmungen.

Rufen Sie die Methode claims.insert auf, um einen Anspruch zu erstellen. In der claim-Ressource, die Sie einfügen, müssen Sie Werte für die folgenden Attribute festlegen:

assetId: Diesen Wert haben Sie in Schritt 2.1 erhalten.
videoId – Das ist die Broadcast-ID, die Sie in Schritt 1.1 abgerufen haben.
policy – Dies ist eine policy-Ressource. Sie können eine vorhandene Richtlinie anwenden, indem Sie die id-Eigenschaft der Ressource auf die ID der vorhandenen Richtlinie festlegen. Im vorherigen Schritt wird beschrieben, wie Sie die ID einer vorhandenen Richtlinie abrufen.
contentType: Legen Sie diesen Wert auf audiovisual fest.

API-Antwort verarbeiten

Wenn Sie den Anspruch einfügen, enthält die API-Antwort die von Ihnen erstellte claim-Ressource. Ihr Code sollte die id aus dieser Ressource extrahieren und speichern. Sie verwenden diesen Wert später, um eine Referenz aus Ihrem verarbeiteten Video zu erstellen.

Schritt 2.5: Anzeigeneinstellungen für die Übertragung aktualisieren

Du musst die Werbeoptionen für dein Video festlegen, wenn du eine Pre-Roll-Anzeige schalten möchtest, wenn Zuschauer deine Übertragung starten, oder wenn du Anzeigen in Pausen deiner Übertragung schalten möchtest.

Wenn du Preroll-Anzeigen für deinen Stream aktivierst, sehen alle Zuschauer eine Anzeige, wenn sie sich deinen Stream ansehen, auch wenn sie ihn erst in der Mitte des Streams starten.
Wenn du Mid-Roll-Anzeigen für deine Übertragung aktivierst, kannst du während der Übertragung Anzeigen-Cue-Points einfügen.

Rufen Sie die Methode videoAdvertisingOptions.update auf, um Anzeigen zu aktivieren. Legen Sie in Ihrer Anfrage den Parameter videoId auf die Broadcast-id fest, die Sie in Schritt 1.1 erhalten haben. Verwenden Sie die Eigenschaft adFormats[] der Ressource videoAdvertisingOption, um die Anzeigenformate (preroll, midroll oder postroll) zu identifizieren, die Sie aktivieren möchten.

Phase 3: Testen

In dieser Phase bettest du einen Player ein, der den Monitorstream für deine Übertragung zeigt, damit du die Wiedergabe testen kannst. Der Monitorstream ist ein privater Stream, mit dem du dir eine Vorschau des übertragenen Videos ansehen kannst, wie es für YouTube-Zuschauer angezeigt wird.

Beachten Sie, dass Sie Ihre Videoübertragung nur testen können, wenn der Monitorstream aktiviert ist. Standardmäßig sind die Monitor-Streams von Übertragungen aktiviert. Du kannst den Monitorstream eines Broadcasts deaktivieren, indem du beim Erstellen oder Aktualisieren des Broadcasts das Attribut contentDetails.monitorStream.enableMonitorStream auf false setzt.

Schritt 3.1: Monitorstream-Player einbetten

Rufe deinen Stream mit der Methode liveBroadcasts.list ab und extrahiere den Wert der Property contentDetails.streamDetails.monitorStreamEmbedHtml. Dieser Wert enthält den HTML-Code, den Sie zum Einbetten eines YouTube-Players benötigen, in dem Ihr Monitorstream angezeigt wird.

Schritt 3.2: Video starten

Starte die Videoübertragung in deinem Videostream.

Schritt 3.3: Prüfen, ob der Videostream aktiv ist

Rufen Sie die Methode liveStreams.list auf, um die mit Ihrer Übertragung verknüpfte liveStream-Ressource abzurufen. Prüfe, ob der Wert des Attributs status.streamStatus active ist. Das bedeutet, dass die YouTube-Server Daten von deinem Encoder korrekt empfangen.

Schritt 3.4: Status des Streams auf „Testen“ setzen

Rufen Sie die Methode liveBroadcasts.transition auf, um den Status der Übertragung zu aktualisieren. Setze den Parameterwert id auf die in Schritt 1.1 abgerufene Broadcast-ID und den Parameterwert broadcastStatus auf testing.

Nachdem Sie die Methode liveBroadcasts.transition aufgerufen haben, kann es einige Sekunden oder sogar bis zu einer Minute dauern, bis die Umstellung abgeschlossen ist. Während dieser Zeit sollten Sie die API abfragen, um den Status der Übertragung zu prüfen. Bis die Umstellung abgeschlossen ist, lautet der Status der Übertragung testStarting. Der Status lautet testing, sobald die Umstellung abgeschlossen ist.

Schritt 3.5: Tests abschließen

Wenn der Test reibungslos verlaufen ist, können Sie mit Phase 4 fortfahren. In einigen Fällen sind jedoch möglicherweise weitere Tests erforderlich. Wenn bei den Tests beispielsweise festgestellt wird, dass der Videostream nicht richtig konfiguriert ist, musst du das Problem beheben, bevor du mit der Übertragung fortfahren kannst.

Wenn der Videostream nicht richtig konfiguriert ist, müssen Sie die Bindung des vorhandenen Streams aufheben, ihn löschen und einen neuen Stream erstellen. Ein Stream ist beispielsweise möglicherweise nicht richtig konfiguriert, wenn das falsche Videoformat angegeben ist.

Wenn Sie die Bindung des Videostreams aufheben möchten, rufen Sie die Methode liveBroadcasts.bind aus Schritt 1.3 auf. Legen Sie in der API-Anfrage den Parameter id auf den in Schritt 1.1 erhaltenen id fest. Fügen Sie den Parameter streamId nicht in die Anfrage ein.
Rufen Sie die Methode liveStreams.delete auf, um den Videostream zu löschen. Legen Sie in der Anfrage den Parameter id auf den in Schritt 1.2 abgerufenen id fest.
Wiederholen Sie Schritt 1.2, um eine neue, richtig konfigurierte liveStream-Ressource zu erstellen. Wiederhole dann Schritt 1.3, um den neuen Stream mit deiner Übertragung zu verknüpfen, und die Schritte 3.1 bis 3.3, um den neuen Stream zu testen.

Schritt 3.6: Properties `autoStart` und `autoStop` aktivieren

Nachdem du die Testphase erfolgreich abgeschlossen hast, kannst du die Eigenschaften contentDetails.enableAutoStart und contentDetails.enableAutoStop der Übertragung auf true setzen, bevor die eigentliche Übertragung beginnt. Diese Eigenschaften können vor der Testphase nicht auf true gesetzt werden, da der Test tatsächlich den Start der Übertragung auslösen würde.

Phase 4: Übertragung

In dieser Phase ist das Video für deine Zuschauer sichtbar.

Schritt 4.1: Video starten

Beginnen Sie mit der Übertragung von Video in Ihrem Videostream.

Schritt 4.2: Prüfen, ob der Videostream aktiv ist

Rufen Sie die Methode liveStreams.list auf, um die liveStream-Ressource abzurufen, die mit Ihrer Übertragung verknüpft ist. Prüfe, ob der Wert des Attributs status.streamStatus active ist. Das bedeutet, dass die YouTube-Server Daten von deinem Encoder korrekt empfangen.

Schritt 4.3: Status der Übertragung auf „Live“ umstellen

Wichtig:Durch diesen Schritt wird dein Video für dein Publikum sichtbar.

Wenn Sie die Property contentDetails.enableAutoStart der Ressource liveBroadcast auf true festlegen, müssen Sie die Methode liveBroadcasts.transition nicht aufrufen.

Nachdem du diesen API-Aufruf ausgeführt hast (oder wenn du die Property contentDetails.enableAutoStart auf true gesetzt hast, nachdem du mit dem Streaming begonnen hast), musst du in der Regel 5 bis 10 Sekunden warten, bis der Übergang abgeschlossen ist. Die Umstellung kann bis zu einer Minute dauern. Während dieser Zeit solltest du die API abfragen, um den Status des Livestreams zu prüfen. Bis die Umstellung abgeschlossen ist, wird der Status der Übertragung als liveStarting angezeigt. Der Status ist live, sobald die Umstellung abgeschlossen ist und Zuschauer deine Übertragung ab diesem Punkt im Monitorstream ansehen können.

Beachten Sie die folgenden Auswirkungen dieses Befehls:

Wenn du den Monitor-Stream für deine Übertragung aktiviert hast (siehe Schritt 3.1), kannst du ihn in einem eingebetteten Player sehen.
Wenn Sie einen Wert für die contentDetails.streamDetails.broadcastStreamDelayMs-Eigenschaft der Übertragung festgelegt haben, wird der für andere Zuschauer sichtbare Übertragungsstream um diesen Zeitraum verzögert.

Schritt 4.4: Werbeunterbrechungen in deinen Livestream einfügen

Rufen Sie die Methode liveBroadcasts.cuepoint auf, um einen Cuepoint einzufügen. Der Cuepoint löst möglicherweise eine Werbeunterbrechung aus. Legen Sie in der Ressource cuepoint, die im Anfragetext angegeben ist, das Attribut durationSecs auf die gewünschte Länge der Werbeunterbrechung (in Sekunden) fest, die Sie einblenden möchten. Der Standardwert ist 30.

Zu diesem Zeitpunkt versucht YouTube, im Videoplayer eine Anzeige für alle Zuschauer abzuspielen, die sich die Übertragung angesehen haben, als der Cuepoint für die Anzeige eingefügt wurde. Ob eine Anzeige abgespielt wird, hängt von verschiedenen Faktoren ab, z. B. von der Verfügbarkeit von Anzeigen und dem Anzeigenwiedergabeverlauf des Zuschauers. Zuschauer, die eine Werbeunterbrechung sehen, kehren nach der Werbeunterbrechung zu deinem Stream zurück. Zuschauer, denen keine Anzeige eingeblendet wird, sehen den Stream während der Unterbrechung weiter.

Im Startleitfaden findest du weitere Informationen zur Wiedergabe während einer Werbeunterbrechung in einer Liveübertragung.

Schritt 5: Übertragung beenden

Schritt 5.1: Streaming beenden

Damit ist der Test des YouTube-Liveübertragungssystems abgeschlossen.

Schritt 5.2: Status der Übertragung auf „Abgeschlossen“ setzen

Wenn du die Übertragung beenden möchtest, rufe die API-Methode liveBroadcasts.transition auf, um den Status der Übertragung zu aktualisieren. Setze den Parameterwert id auf die in Schritt 1.1 abgerufene Broadcast-ID und den Parameterwert broadcastStatus auf complete.

Wenn du die Properties contentDetails.recordFromStart und contentDetails.enableDvr der Übertragung auf true gesetzt hast, können deine Zuschauer die Wiedergabe der Live-Veranstaltung sofort nach deren Ende ansehen.

Schritt 6: Referenz erstellen

Nach Abschluss der Live-Aufzeichnung kannst du aus dem aufgezeichneten Video eine Referenz erstellen. Dadurch wird YouTube angewiesen, nach von Nutzern hochgeladenen Videos zu suchen, die mit der Übertragung übereinstimmen, und sie gemäß der in Schritt 2.3 festgelegten Abgleichsrichtlinie zu behandeln.

Wichtig: Damit du die Referenz erstellen kannst, muss die Property contentDetails.recordFromStart des Broadcasts auf true festgelegt sein.

Schritt 6.1: Status des Videos über die Data API abfragen

YouTube muss die Verarbeitung einer Übertragung oder eines hochgeladenen Videos abgeschlossen haben, bevor du daraus eine Referenz erstellen kannst. Um festzustellen, ob die Verarbeitung des Videos abgeschlossen ist, rufe die Methode videos.list der YouTube Data API auf. Setze dabei den Parameter part auf status und den Parameter id auf die Broadcast-ID, die du in Schritt 1.1 gespeichert hast.

Die API-Antwort auf Ihre Abfrageanfrage enthält eine video-Ressource. Wenn der Wert des Attributs status.uploadStatus dieser Ressource processed ist, fahren Sie mit Schritt 6.2 fort.

Schritt 6.2: Referenz aus dem verarbeiteten Video erstellen

Rufe zum Erstellen der Referenz die Methode references.insert der Content ID API auf und setze den Parameter claimId auf die Anspruchs-ID, die du in Schritt 2.4 gespeichert hast.

Content ID-Übermittlung bei Livestreams

Einige YouTube-Partner können eine Referenz erstellen, bevor ihre Übertragung in den Status testing wechselt. Diese Funktion ist jedoch nicht für alle Partner verfügbar. In diesem Ablauf generiert und aktualisiert YouTube die Referenz aus dem Broadcast-Stream deiner Live-Veranstaltung, während die Übertragung läuft. Außerdem sucht YouTube während der Übertragung nach übereinstimmenden Videos, die von Nutzern hochgeladen wurden. Wenn du eine Referenz vor Beginn einer Übertragung erstellst, wird die Aufzeichnung für die Übertragung automatisch aktiviert. Nach dem Erstellen der Referenz kann die Aufzeichnung nicht mehr deaktiviert werden.

Wenn du deine Übertragung für die Content ID-Live-Übermittlung aktivieren möchtest, führe die in Schritt 6.2 beschriebenen Aktionen aus, nachdem du in Schritt 2.4 Anspruch auf dein Video erhoben hast. Wenn dein Partnerkonto vor der Liveübertragung nicht für das Erstellen einer Referenz für diese Übertragung genehmigt wurde, gibt die API den Fehler fingerprintingNotAllowed zurück. In diesem Fall müssen Sie warten, bis die Übertragung abgeschlossen ist (siehe Schritte 6.1 und 6.2 oben), bevor Sie die Referenz erstellen.