YouTube Live Streaming API – Überarbeitungsverlauf

Auf dieser Seite finden Sie Änderungen an der YouTube Live Streaming API und Aktualisierungen der Dokumentation. Diesen Changelog abonnieren Abonnieren

14. Juli 2025

Die Beschreibung der Methode liveChatMessages.streamList wurde aktualisiert, um Anleitungen zur Verwendung der StreamList API zu geben.

9. Oktober 2023

In dieser CSV-Datei findest du eine Referenz dazu, welche Sticker-IDs zu welchen Super Stickern gehören. Die Definitionen des Attributs snippet.superStickerDetails.superStickerMetadata.stickerId der Ressource liveChatMessage und des Attributs snippet.superStickerMetadata.stickerId der Ressource superChatEvent wurden entsprechend aktualisiert.

15. September 2023

Die API unterstützt jetzt eine neue Methode zum Einfügen von Anzeigen in Liveübertragungen. Zusätzlich zu liveCuepoints, mit dem du Werbeunterbrechungen manuell in einen Livestream einfügen kannst, unterstützt YouTube jetzt eine Funktion, mit der Mid-Roll-Werbeunterbrechungen automatisch in festen Intervallen in einen Livestream eingefügt werden.

Wenn der Inhaber des Streams automatisierte Anzeigen aktiviert, kann er sich die folgenden Aspekte des Anzeigenverhaltens ansehen:

  • die Länge des Intervalls zwischen Mid-Roll-Werbeunterbrechungen.
  • die Planungsstrategie für Cuepoints. Cuepoints können gleichzeitig für alle Zuschauer eingefügt werden oder das Timing der Cuepoints kann sich von Zuschauer zu Zuschauer unterscheiden. Bei dieser Strategie kann YouTube Cuepoints häufiger planen, sodass Zuschauer Cuepoints erhalten, wenn sie dafür infrage kommen.
  • Ein Zeitraum, in dem keine Mid-Roll-Anzeigen eingeblendet werden. Der Inhaber der Übertragung gibt an, dass die Mid-Roll-Anzeigenbereitstellung bis zu einem bestimmten Zeitpunkt pausiert wird.

Die Dokumentation enthält die folgenden API-Änderungen zur Unterstützung dieser Funktion:

  • Die liveBroadcast-Ressource enthält jetzt ein monetizationDetails-Objekt. Die Felder des Objekts geben an, ob die automatische Anzeigenplatzierung für die Übertragung aktiviert ist, und enthalten zusätzliche Informationen zum Planen von Cuepoints.
  • Der Parameter part der Methode liveBroadcast.list unterstützt den Wert monetizationDetails.
  • Mit der Methode update kann das Einfügen von Mid-Roll-Anzeigen für einen bestimmten Zeitraum für eine Liveübertragung pausiert werden. In der Dokumentation werden jetzt auch mehrere Fehler aufgeführt, die beim Aktualisieren der Monetarisierungsdetails für eine Liveübertragung auftreten können.

1. August 2023

Dieses Update enthält die folgenden Änderungen:

  • Bei der liveBroadcasts.update-Methode müssen keine Werte mehr für diese Felder angegeben werden:

    • snippet.title
    • status.privacyStatus

    Wenn Sie diese Felder in der Anfrage weglassen, bleiben sie unverändert.

1. November 2022

  • Mit der neuen Methode liveBroadcasts.cuepoint können Kanalinhaber, die einen Livestream auf YouTube übertragen, Cuepoints in diesen Stream einfügen, die Werbeunterbrechungen auslösen können. Diese Methode ersetzt die Methode liveCuepoints.insert, mit der nur YouTube-Content-Partner Cuepoints in Livestreams einfügen konnten.

    Mehrere Leitfäden wurden aktualisiert, um die Verfügbarkeit dieser neuen Methode zu berücksichtigen.

  • Hinweis:Dies ist eine Ankündigung zur Einstellung.

    Die Methode liveCuepoints.insert ist jetzt veraltet. Die Unterstützung für die Methode liveCuepoints.insert wird am oder nach dem 1. Mai 2023 eingestellt. API-Nutzer sollten ihre Anwendungen aktualisieren, um stattdessen die Methode liveBroadcasts.cuepoint aufzurufen.

  • Die Dokumentation für die Methode liveBroadcasts.control wurde entfernt. Im September 2020 wurde ein Hinweis zur Einstellung dieser Methode veröffentlicht.

1. Oktober 2022

Dieses Update enthält die folgenden Änderungen:

  • Bei der liveBroadcasts.update-Methode müssen keine Werte mehr für diese Felder angegeben werden:

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

    Wenn Sie diese Felder in der Anfrage weglassen, bleiben sie unverändert.

  • Dokumentation für veraltete liveBroadcast-Felder entfernt:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1. April 2022

Dieses Update enthält die folgenden Änderungen:

  • Die Property snippet.type unterstützt jetzt zwei neue Werte:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • Die neue snippet.membershipGiftingDetails-Eigenschaft der liveChatMessage-Ressource und ihre untergeordneten Elemente enthalten Informationen zum Ereignis „Mitgliedschaft verschenken“. Ebenso enthält die neue Property snippet.giftMembershipReceivedDetails und ihre untergeordneten Elemente Informationen zum Ereignis „Geschenkte Mitgliedschaft erhalten“.

15. September 2021

Dieses Update enthält die folgenden Änderungen:

  • Die Property snippet.type unterstützt jetzt zwei neue Werte:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • Die neue snippet.memberMilestoneChatDetails-Eigenschaft der liveChatMessage-Ressource und ihre untergeordneten Elemente enthalten Informationen zum Ereignis „Chatnachricht für treue Mitglieder“. Entsprechend enthalten die neue Eigenschaft snippet.newSponsorDetails und ihre untergeordneten Elemente Informationen zum Ereignis „Neuer Sponsor“.

1. Dezember 2020

Die Methode liveBroadcasts.transition der API unterstützt den neuen Fehler 403 (Forbidden), der angibt, dass der Nutzer innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet hat. Der Fehlergrund ist userRequestsExceedRateLimit.

21. September 2020

  • Die Definition des Attributs status.madeForKids der Ressource liveBroadcast wurde aktualisiert, um zu verdeutlichen, dass das Attribut schreibgeschützt ist. Dies spiegelt keine Änderung der API-Funktionalität wider.

    Wenn du eine Liveübertragung als speziell für Kinder kennzeichnen möchtest, setze beim Aufrufen der Methode liveBroadcasts.insert zum Erstellen der Übertragung das Attribut status.selfDeclaredMadeForKids auf true.

  • Hinweis:Diese Änderung umfasst eine Einstellungsankündigung und eine Aktualisierung einer früheren Einstellungsankündigung.

    Die Methode liveBroadcasts.control wird am oder nach dem 1. Oktober 2020 eingestellt. Nach diesem Datum wird bei allen Aufrufen dieser Methode ein Fehler vom Typ „Verboten“ (403) zurückgegeben. Die Methode wird später vollständig entfernt. Clients können weiterhin eigene Slates implementieren, indem sie dem Video, das an die Aufnahmeserver von YouTube gesendet wird, ein Overlay hinzufügen.

    Das Einstellungsdatum für die am 16. April 2020 angekündigte Einstellung, die ursprünglich für den 1. September 2020 geplant war, wurde verschoben und erfolgt nun am oder nach dem 1. Oktober 2020. Die in dieser Einstellung angekündigten Funktionen und die liveBroadcasts.control-Methode werden also gleichzeitig eingestellt.

17. Juli 2020

Hinweis:Dies ist eine Aktualisierung einer früheren Einstellung.

Das Feld cdn.format der Ressource liveStream, das im April 2016 eingestellt wurde, wird ab dem 17. August 2020 nicht mehr unterstützt. Anfragen, in denen dieses Feld noch verwendet wird, schlagen ab diesem Datum fehl.

Wenn in Ihrem Code noch das Feld cdn.format verwendet wird, muss es aktualisiert werden, damit die Bildrate und die Auflösung separat angegeben werden. Verwenden Sie dazu die Eigenschaften cdn.frameRate und cdn.resolution.

6. Juli 2020

Der Leitfaden Live-YouTube-Inhalte über HLS bereitstellen wurde aktualisiert:

  • Die empfohlene Dauer für ein Media-Segment wurde auf ein bis vier Sekunden aktualisiert.
  • In einem neuen Abschnitt wird beschrieben, wie Sie eine HLS-Aufnahme-URL aus YouTube Creator Studio abrufen.
  • Die Anleitung zum Formatieren des Parameterwerts file wurde in den neuen Abschnitt HLS-Aufnahme-URL fertigstellen verschoben. Diese Anleitung gilt unabhängig davon, ob die HLS-Aufnahme-URL über die YouTube API oder YouTube Creator Studio abgerufen wird.

Außerdem werden im neuen Vergleich der Aufnahmeprotokolle die von YouTube unterstützten Aufnahmeprotokolle, die für jedes Protokoll unterstützten Codecs und zusätzliche Informationen zu den geeigneten Anwendungsfällen für jedes Protokoll aufgeführt.

16. April 2020

Dieses Update enthält eine neue Property und eine Einstellungsankündigung:

  • Die liveBroadcast-Ressource unterstützt jetzt die contentDetails.enableAutoStop-Property. Die Eigenschaft gibt an, ob eine Übertragung etwa eine Minute nach dem Beenden des Videostreams durch den Kanalinhaber automatisch beendet werden soll.

    Das Dokument Lebenszyklus einer Übertragung wurde aktualisiert. Es wird nun beschrieben, wie sich der schrittweise Prozess zum Erstellen und Verwalten eines YouTube-Live-Events ändert, wenn Sie die Eigenschaften contentDetails.enableAutoStart oder contentDetails.enableAutoStop auf true festlegen.

  • Hinweis:Dies ist eine Ankündigung zur Einstellung. Diese Änderungen treten am oder nach dem 1. September 2020 in Kraft. Das tatsächliche Datum, an dem die Änderungen in Kraft treten, wird unten als „Einstellungsdatum“ bezeichnet.

    In diesem Update wird eine potenziell funktionsgefährdende Änderung erläutert. Das betrifft API-Clientanwendungen, die die Standardressourcen liveStream und liveBroadcast von Kanälen verwenden, um Liveinhalte auf YouTube zu streamen. Konkret können die Broadcast-ID und Stream-ID, die mit dem persistenten Broadcast und Stream verknüpft sind, nicht mehr zum Starten neuer Broadcasts verwendet werden.

    Ihre Anwendung ist betroffen, wenn eine der folgenden Bedingungen zutrifft:

    • Sie prüft den Wert des Attributs isDefaultBroadcast der Ressource liveBroadcast. Diese Eigenschaft wird nach dem Einstellungsdatum nicht mehr zurückgegeben.
    • Sie prüft den Wert des Attributs isDefaultStream der Ressource liveStream. Diese Eigenschaft wird nach dem Einstellungsdatum nicht mehr zurückgegeben.
    • Sie ruft die Methode liveBroadcasts.list auf und legt den Parameterwert broadcastType auf persistent oder all fest. Dieser Parameter wird im Rahmen dieser Änderungen eingestellt. Ab dem Einstellungsdatum:
      • Wenn der Parameterwert broadcastType gleich persistent ist, gibt die Methode liveBroadcasts.list keine Ergebnisse zurück.
      • Wenn der Parameterwert broadcastType gleich all ist, gibt die Methode liveBroadcasts.list keine persistenten Broadcasts zurück, die vor diesem Zeitpunkt vorhanden waren.

    In den letzten Jahren hat YouTube automatisch einen Standardstream und eine Standardsendung für einen Kanal erstellt, wenn dieser für das Livestreaming aktiviert wurde. Der Standardstream war unbegrenzt vorhanden, hatte keine Start- oder Endzeit und konnte nicht gelöscht werden. Ebenso wurde die Standardübertragung als persistent eingestuft. Sie hat immer existiert und war nicht an ein bestimmtes Ereignis gebunden.

    Ab dem Einstellungsdatum gilt Folgendes:

    • YouTube erstellt keine Standardstreams und ‑übertragungen mehr. Anstatt auf die Standardressourcen zu setzen, müssen API-Clients liveBroadcast- und liveStream-Ressourcen erstellen und verwalten und diese Ressourcen miteinander verknüpfen können.
    • Wenn der Standard-Broadcast und der Standard-Stream eines Kanals aktiv sind, d. h. der Kanal sie für eine Liveübertragung verwendet, wenn die Einstellung eingestellt wird, ist die laufende Übertragung davon nicht betroffen. Nach Ende der Übertragung kann der Kanal jedoch nicht mehr die Standardübertragung und den Standardstream verwenden.
    • Wenn der Standard-Broadcast und der Standard-Stream eines Kanals nicht aktiv sind, ignoriert YouTube nach dem Inkrafttreten der Einstellung Versuche, diese Ressourcen zum Übertragen von Videos zu verwenden.

    Wenn Ihre Anwendung betroffen ist, finden Sie in den folgenden Dokumenten Informationen dazu, wie Sie Ihre Anwendung aktualisieren können, damit sie nach dieser Änderung weiterhin wie erwartet funktioniert:

    • In einem neuen Migrationsleitfaden werden die Schritte erläutert, die Entwickler in API-Clients ausführen müssen, die derzeit Standard-Broadcasts und ‑Streams verwenden.
    • Im Leitfaden Life of a broadcast (Das Leben einer Übertragung) wird Schritt für Schritt erklärt, wie du eine Live-Veranstaltung auf YouTube erstellst und verwaltest. In jedem Schritt werden die API-Aufrufe oder andere Aktionen beschrieben, die Sie ausführen müssen, um eine bestimmte Aktion abzuschließen. Ihre Anwendung muss diesen Prozess befolgen, wenn YouTube die Unterstützung von Standardstreams und ‑übertragungen einstellt.

31. März 2020

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Die Ressource sponsor und die Methode sponsors.list wurden eingestellt und durch die Ressource member und die Methode members.list ersetzt.

Die Methode sponsors.list wird ab dem 30. September 2020 nicht mehr unterstützt. API-Clients sollten Aufrufe der Methode sponsors.list aktualisieren, sodass stattdessen die Methode members.list verwendet wird. Weitere Informationen zur neuen Ressource finden Sie im Versionsverlauf der YouTube Data API.

11. März 2020

Der Abschnitt Aufnahmepunkt im Leitfaden YouTube-Liveinhalte über HLS bereitstellen wurde aktualisiert, um den Prozess zu verdeutlichen, den ein Encoder verwenden sollte, um den Parameterwert file= beim Erstellen der primären und sekundären Aufnahme-URLs zu vervollständigen.

4. Februar 2020

Der Leitfaden Live-YouTube-Inhalte über HLS bereitstellen wurde aktualisiert. Es wird nun darauf hingewiesen, dass DELETE-Anfragen optional sind und vom HLS-Endpunkt von YouTube ignoriert werden. Aus Leistungsgründen empfiehlt YouTube, dass Clients keine DELETE-Anfragen senden.

10. Januar 2020

Die API unterstützt jetzt die Möglichkeit, Inhalte zu identifizieren, die speziell für Kinder erstellt wurden. YouTube bezeichnet diese Inhalte als „speziell für Kinder“. Weitere Informationen zu Inhalten speziell für Kinder findest du in der YouTube-Hilfe.

  • Die liveBroadcast-Ressource unterstützt zwei neue Eigenschaften, mit denen Creator und Zuschauer Inhalte als „speziell für Kinder“ kennzeichnen können:
    • Mit dem Attribut selfDeclaredMadeForKids können Creator angeben, ob ein Livestream für Kinder bestimmt ist. Dieses Attribut kann beim Erstellen einer Übertragung über die liveBroadcasts.insert-Methode festgelegt werden. Dieses Attribut ist nur in API-Antworten enthalten, die liveBroadcast-Ressourcen enthalten, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
    • Mit der Eigenschaft madeForKids kann jeder API-Nutzer den Status „Für Kinder“ einer Übertragung abrufen. Der Status kann beispielsweise anhand des Werts des Attributs selfDeclaredMadeForKids ermittelt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Livestreams findest du in der YouTube-Hilfe.
  • In der YouTube Data API unterstützt die channel-Ressource auch die neuen Attribute selfDeclaredMadeForKids und madeForKids.

Wir haben auch die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen finden Sie im Revisionsverlauf der Nutzungsbedingungen für YouTube-APIs. Die Änderungen an den Nutzungsbedingungen für YouTube API-Dienste und den Entwicklerrichtlinien treten am 10. Januar 2020 um 09:00 Uhr (Pazifische Zeit) in Kraft.

20. August 2019

Der Abschnitt Anforderungen im Leitfaden YouTube-Liveinhalte über HLS bereitstellen wurde mit zwei Änderungen aktualisiert:

  • Darin wird erklärt, dass es eine Best Practice ist, sowohl bestätigte als auch ausstehende Segmente in jede Media-Playlist aufzunehmen. So ist es weniger wahrscheinlich, dass ein Segment übersprungen wird, wenn eine Media-Playlist auf dem Server verloren geht. Sie können beispielsweise bis zu zwei bestätigte und bis zu fünf ausstehende Segmente in jede Media-Playlist aufnehmen.
  • Jetzt ist es erforderlich, für jedes Media-Segment eine Media-Playlist zu senden. Dadurch kann sich der Server schnell erholen, wenn eine Media-Playlist verloren geht. Diese Vorgehensweise wurde zuvor als Empfehlung aufgeführt.

28. Juni 2019

YouTube unterstützt jetzt die HLS-Aufnahme. Dementsprechend unterstützt die ingestionType-Property der liveStream-Ressource den neuen Wert hls, um Streams zu identifizieren, die über HLS auf YouTube hochgeladen wurden.

Im neuen Leitfaden Live-YouTube-Inhalte über HLS bereitstellen findest du Richtlinien für das Streamen von Live-Inhalten über HLS von einem Encoder zu YouTube. Der Leitfaden soll Encoder-Anbietern helfen, die HLS-Bereitstellung in ihre Produkte zu integrieren.

4. April 2019

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenzdokumentation wurde aktualisiert, um gängige Anwendungsfälle für jede Methode besser zu erläutern und dynamische, hochwertige Codebeispiele über das APIs Explorer-Widget bereitzustellen. Ein Beispiel finden Sie in der Dokumentation zur Methode liveBroadcasts.list. Auf Seiten, auf denen API-Methoden beschrieben werden, gibt es jetzt zwei neue Elemente:

    • Mit dem APIs Explorer-Widget können Sie Autorisierungsbereiche auswählen, Beispielparameter und ‑attributwerte eingeben und dann tatsächliche API-Anfragen senden und tatsächliche API-Antworten ansehen. Das Widget bietet auch eine Vollbildansicht mit vollständigen Codebeispielen, die dynamisch aktualisiert werden, um die von Ihnen eingegebenen Bereiche und Werte zu verwenden.

    • Im Abschnitt Häufige Anwendungsfälle werden ein oder mehrere häufige Anwendungsfälle für die auf der Seite beschriebene Methode beschrieben. Sie können beispielsweise die Methode liveBroadcasts.list aufrufen, um Daten zu einer bestimmten Übertragung oder zu den Übertragungen des aktuellen Nutzers abzurufen.

      Über die Links in diesem Abschnitt können Sie APIs Explorer mit Beispielwerten für Ihren Anwendungsfall füllen oder APIs Explorer im Vollbildmodus mit diesen Werten öffnen. Diese Änderungen sollen es Ihnen erleichtern, Codebeispiele zu finden, die direkt auf den Anwendungsfall anwendbar sind, den Sie in Ihrer eigenen Anwendung implementieren möchten.

    Codebeispiele werden derzeit für Java, JavaScript, PHP, Python und curl unterstützt.

  • Die Seite Codebeispiele hat ebenfalls eine neue Benutzeroberfläche, die alle oben beschriebenen Funktionen bietet. Mit diesem Tool können Sie Anwendungsfälle für verschiedene Methoden untersuchen, Werte in den APIs Explorer laden und den Vollbild-APIs Explorer öffnen, um Codebeispiele in Java, JavaScript, PHP und Python zu erhalten.

    Im Zusammenhang mit dieser Änderung wurden die Seiten entfernt, auf denen zuvor verfügbare Codebeispiele für Java, PHP und Python aufgeführt waren.

25. Februar 2019

Die Dokumentation der Ressourcen liveChatMessage und superChatEvent wurde aktualisiert, um zu berücksichtigen, dass beide Ressourcen jetzt Informationen zu Super Stickern enthalten können. Super Sticker sind eine Art Super Chat-Nachricht, bei der ein Bild angezeigt wird. Wie bei anderen Super Chats wird eine Super Sticker-Nachricht von einem Fan während eines YouTube-Livestreams gekauft.

  • In einer liveChatMessage-Ressource ist die snippet.type-Property jetzt auf superStickerEvent festgelegt, um anzugeben, dass die Ressource Informationen zu einem Super Sticker enthält. In diesem Fall enthält die Ressource auch das snippet.superStickerDetails-Objekt, das zusätzliche Informationen zum Super Sticker enthält.
  • In einer superChatEvent-Ressource gibt der boolesche Wert snippet.isSuperStickerEvent an, ob die Super Chat-Nachricht auch ein Super Sticker ist. Falls ja, enthält das snippet.superStickerMetadata-Objekt zusätzliche Details zum Super Sticker.

5. April 2018

Die Beschreibung der superChatEvents.list-Methode wurde aktualisiert, um der Tatsache Rechnung zu tragen, dass die API-Antwort nicht mehr fanFundingEvents enthält, die Anfang 2017 eingestellt wurden.

3. April 2017

Es wurden neue Java-Codebeispiele hinzugefügt, die zeigen, wie Live-Chat-Nachrichten aufgelistet, eingefügt und gelöscht werden. In den Beispielen werden die folgenden Methoden aufgerufen:

13. Februar 2017

Dieses Update enthält die folgenden Änderungen:

  • Aktualisierungen vorhandener Ressourcen und Methoden

    • Die Methode liveCuepoints.insert wurde aktualisiert, um der Tatsache Rechnung zu tragen, dass der Parameter onBehalfOfContentOwner derzeit erforderlich ist. Außerdem wurde die Beschreibung der Methode aktualisiert. Es wird nun darauf hingewiesen, dass Aufrufe dieser Methode von einem Konto autorisiert werden müssen, das mit einem YouTube-Rechteinhaber verknüpft ist.

9. Februar 2017

Dieses Update enthält die folgenden Änderungen:

  • Aktualisierungen vorhandener Ressourcen und Methoden

    • Mit dem neuen Parameter hl der Methode superChatEvents.list können Sie angeben, dass der Property-Wert snippet.displayString gemäß den Konventionen einer bestimmten Sprache formatiert werden soll. Die Definition dieses Attributs wurde entsprechend aktualisiert.

      Der Parameterwert muss ein Sprachcode sein, der in der von der Methode i18nLanguages.list zurückgegebenen Liste enthalten ist. Der Standardwert ist en. Das bedeutet, dass Anzeigestrings standardmäßig so formatiert werden, wie sie im Englischen verwendet würden. Standardmäßig wird ein String beispielsweise als $1.00 und nicht als $1,00 formatiert.

1. Februar 2017

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Die neue superChatEvent-Ressource stellt eine Super Chat-Nachricht dar, die von einem Fan während eines YouTube-Livestreams gekauft wurde. Im YouTube-Livechat-Stream heben sich Super Chats gleich doppelt von anderen Nachrichten ab:

      • Super Chats werden farblich hervorgehoben.
      • Super Chats bleiben für einen bestimmten Zeitraum im Ticker angepinnt.

      Die Farbe des Super Chats, der Zeitraum, für den er im Ticker angepinnt bleibt, und die maximale Nachrichtenlänge hängen vom Kaufbetrag ab. Weitere Informationen zu Super Chats findest du in der YouTube-Hilfe.

      Die API unterstützt eine Methode zum Auflisten von Super Chat-Ereignissen für die Livestreams eines Kanals in den letzten 30 Tagen. Mit dieser Methode werden auch Daten zu Fan-Finanzierungsereignissen (fanFundingEvents) aus dem letzten Livestream des Kanals zurückgegeben.

  • Aktualisierungen vorhandener Ressourcen und Methoden

    • Das Attribut snippet.type unterstützt jetzt den Wert superChatEvent, der angibt, dass die Ressource einen Super Chat beschreibt.

      Außerdem enthält die neue snippet.superChatDetails-Eigenschaft der liveChatMessage-Ressource und ihre untergeordneten Elemente Informationen zum Super Chat-Event.

    • Die cdn.resolution-Eigenschaft der liveStream-Ressource unterstützt jetzt den Wert 2160p.

  • Neue und aktualisierte Fehler

    • Die API unterstützt die folgenden neuen Fehler:

      Fehlerdetails
      liveBroadcasts.insert, liveBroadcasts.update Die Methoden liveBroadcasts.insert und liveBroadcasts.update geben 400-Fehler (Bad Request) zurück, um anzugeben, dass die liveBroadcast-Ressource, die eingefügt oder aktualisiert wird, einen ungültigen Wert für das Attribut contentDetails.enableEmbed oder das Attribut contentDetails.projection enthält. Die Fehlerursachen für die beiden neuen Fehler sind invalidEmbedSetting bzw. invalidProjection.

12. Januar 2017

Hinweis:Dies ist eine Ankündigung zur Einstellung.

Mit der Einführung der neuen Super Chat-Funktion hat YouTube die Fan-Funding-Funktion eingestellt. Die Fan-Funding-API wird am 28. Februar 2017 deaktiviert. Ab diesem Datum gilt Folgendes:

11. August 2016

Dieses Update enthält die folgenden Änderungen:

  • Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („die aktualisierten Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich beschrieben werden, enthalten eine Vielzahl von Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält dieses Update mehrere unterstützende Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

    Die vollständige Liste der neuen Dokumente finden Sie im Versionsverlauf der aktualisierten Nutzungsbedingungen. Außerdem werden zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder den zugehörigen Dokumenten ebenfalls in diesem Revisionsverlauf erläutert. Über einen Link im Dokument können Sie einen RSS-Feed abonnieren, in dem Änderungen im Revisionsverlauf aufgeführt sind.

20. Mai 2016

YouTube unterstützt jetzt die Aufnahme von DASH-Inhalten. Dementsprechend unterstützt die ingestionType-Property der liveStream-Ressource den neuen Wert dash, um Streams zu identifizieren, die über DASH auf YouTube hochgeladen wurden.

Im neuen Leitfaden Live-YouTube-Inhalte über DASH bereitstellen findest du Richtlinien für die Verwendung des DASH-Bereitstellungsformats zum Streamen von Live-Daten auf YouTube über einen Encoder. Es soll Encoder-Anbietern helfen, ihren Produkten Unterstützung für die DASH-Bereitstellung hinzuzufügen.

18. April 2016

Dieses Update enthält die folgenden Änderungen:

  • Aktualisierungen vorhandener Ressourcen und Methoden

    • liveStream-Ressourcenupdates

      • YouTube unterstützt jetzt Streams mit einer Auflösung von 1440p mit 30 oder 60 Bildern pro Sekunde.

        Außerdem enthält die liveStream-Ressource neue Eigenschaften zum Angeben der Bildrate und Auflösung der eingehenden Videodaten:

        Attribute
        cdn.frameRate Die Framerate der eingehenden Videodaten. Gültige Werte sind 30fps und 60fps.
        cdn.resolution Die Auflösung der eingehenden Videodaten. Gültige Werte für die Property sind: 1440p, 1080p, 720p, 480p, 360p und 240p.

      • Mit der Einführung der Eigenschaften cdn.frameRate und cdn.resolution der Ressource liveStream wird die Ressource cdn.format jetzt eingestellt. Mit der Eigenschaft cdn.format werden Auflösung und Framerate in einem einzigen Wert angegeben.

        Wir empfehlen Ihnen, auf die neu unterstützten Felder umzustellen. In der Zwischenzeit funktioniert cdn.format weiterhin. Außerdem sind Anfragen zum Einfügen von Livestreams derzeit erfolgreich, solange Sie Werte für die Property cdn.format oder die Properties cdn.frameRate und cdn.resolution angeben. Wenn Sie Werte für alle drei Attribute angeben, gibt die API möglicherweise einen Fehler zurück, wenn die Werte nicht übereinstimmen.

        Das Attribut cdn.format ist zwar eingestellt, unterstützt aber jetzt zwei neue Werte: 1440p und 1440p_hfr. Damit wird die Unterstützung der API für 1440p-Streams mit 30 oder 60 Bildern pro Sekunde berücksichtigt.

    • liveBroadcast-Ressourcenupdates

      • Die liveBroadcast-Ressource enthält die folgenden neuen Attribute:

        Attribute
        contentDetails.boundStreamLastUpdateTimeMs Datum und Uhrzeit der letzten Aktualisierung des Livestreams, auf den in der contentDetails.boundStreamId-Eigenschaft der Übertragung verwiesen wird.
        contentDetails.projection Das Projektionsformat der Übertragung. Der Standardwert der Property ist rectangular. Gültige Werte für die Property sind 360 und rectangular.

      • Die Definition des statistics.totalChatCount-Attributs der liveBroadcast-Ressource wurde aktualisiert. Der Attributwert wird nur angezeigt, wenn die Übertragung mindestens eine Chatnachricht enthält.

    • liveChatMessage-Ressourcenupdates

      • Die Eigenschaft snippet.type unterstützt zwei neue Werte: messageDeletedEvent und userBannedEvent. Diese entsprechen den neuen Eigenschaften, die im folgenden Aufzählungspunkt beschrieben werden. Die Definition des Attributs snippet.authorChannelId wurde ebenfalls aktualisiert, um zu erläutern, was der Attributwert für diese neuen Nachrichtentypen angibt.

      • Die liveChatMessage-Ressource enthält die folgenden neuen Attribute:

        Attribute
        snippet.messageDeletedDetails Dieses Objekt enthält Informationen zu einer Nachricht, die von einem Chat-Moderator gelöscht wurde. Das Objekt ist nur vorhanden, wenn der Wert der Property snippet.type messageDeletedEvent ist.
        snippet.userBannedDetails Dieses Objekt enthält Informationen zu einem Nutzer, der von der Teilnahme am Chat ausgeschlossen wurde. Das Objekt enthält auch Informationen zum Ausschluss selbst, nämlich ob er dauerhaft oder vorübergehend ist. Wenn der Ausschluss vorübergehend ist, wird die Dauer des Ausschlusses in einer der Eigenschaften des Objekts angegeben.

        Dieses Objekt ist nur vorhanden, wenn der Wert der Eigenschaft snippet.type userBannedEvent ist.

  • Neue und aktualisierte Fehler

    • Die API unterstützt die folgenden neuen Fehler:

      Fehlerdetails
      liveBroadcasts.bind Die Methode liveBroadcasts.bind gibt den Fehler 403 (Forbidden) zurück, um anzugeben, dass der Nutzer innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet hat. Der Fehlergrund ist userRequestsExceedRateLimit.

      Die Methoden liveBroadcasts.insert und liveBroadcasts.update unterstützen diesen Fehler bereits.
      liveStreams.insert Die Methode liveStreams.insert unterstützt vier neue 400-Fehler (Bad Request), die einen ungültigen Property-Wert in der liveStream-Ressource angeben, die mit der Anfrage eingefügt werden sollte. In der folgenden Liste sind die Fehlerursachen und die zugehörigen Eigenschaften aufgeführt:
      liveStreams.insert Die Methode liveStreams.insert unterstützt zwei neue 400-Fehler (Bad Request), die jeweils darauf hinweisen, dass ein erforderlicher Wert in der liveStream-Ressource, die mit der Anfrage eingefügt werden sollte, nicht vorhanden ist. In der folgenden Liste sind die Fehlerursachen und die zugehörigen Eigenschaften aufgeführt:
      Wenn Sie eine liveStream-Ressource einfügen, müssen Sie einen Wert für das Attribut cdn.format oder für die Attribute cdn.frameRate und cdn.resolution angeben.
      • Die API gibt einen formatRequired-Fehler zurück, wenn Sie für keine der drei Eigenschaften einen Wert angeben.
      • Die API gibt einen frameRateRequired-Fehler zurück, wenn Sie einen Wert für cdn.resolution, aber nicht für cdn.frameRate angeben.
      • Die API gibt einen resolutionRequired-Fehler zurück, wenn Sie einen Wert für cdn.frameRate, aber nicht für cdn.resolution angeben.
      liveStreams.update Die Methode liveStreams.update gibt einen 403-Fehler (Forbidden) zurück, wenn mit der Anfrage versucht wird, den Wert einer der folgenden nicht veränderbaren Eigenschaften zu ändern: Der reason in der Fehlerantwort ist liveStreamModificationNotAllowed.

18. Dezember 2015

Laut EU-Gesetzen müssen bestimmte Informationen für Endnutzer in der EU offengelegt und ihre Einwilligung eingeholt werden. Daher müssen Sie für Endnutzer in der Europäischen Union die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben einen Hinweis auf diese Anforderung in unsere YouTube-API-Nutzungsbedingungen aufgenommen.

17. Dezember 2015

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Die API unterstützt mehrere neue Ressourcen, um die Chatfunktion für Live-Übertragungen zu ermöglichen. YouTube unterstützt die Livechat-Funktion während aktiver Livestreams. Mit diesen Ressourcen und ihren Methoden können Chatnachrichten abgerufen und administrative Funktionen für den Chat ausgeführt werden.

      Ressourcen
      liveChatMessage Diese Ressource stellt eine Nachricht in einem YouTube-Livechat dar. YouTube unterstützt verschiedene Arten von Nachrichten, darunter Textnachrichten und Fan-Finanzierungsereignisse. Bei einigen Nachrichtentypen wird eine bestimmte Phase des Chats angegeben, z. B. der Beginn eines Zeitraums, in dem nur Sponsoren chatten können, oder das Ende des Chats. Die API unterstützt Methoden zum Auflisten, Einfügen und Löschen von Livechat-Nachrichten.
      liveChatModerators Diese Ressource identifiziert einen Chatmoderator. Moderatoren können bestimmte administrative Funktionen ausführen, z. B. Nutzer aus dem Chat ausschließen oder Nachrichten entfernen. Die API unterstützt Methoden zum Auflisten, Einfügen und Löschen von Livechat-Moderatoren.
      liveChatBans Mit dieser Ressource wird ein Nutzer identifiziert, der keine Nachrichten in einem bestimmten Livechat posten darf. Sperren können vorübergehend oder dauerhaft sein. Die API unterstützt Methoden zum Einfügen und Löschen von Livechat-Sperren.
      fanFundingEvents Diese Ressource stellt ein Fan-Funding-Ereignis auf einem YouTube-Kanal dar. Mit der Finanzierung durch Fans können Zuschauer YouTube-Creator mit einmaligen Zahlungen unterstützen.

      Mit der Methode fanFundingEvents.list der API werden die Fan-Finanzierungsereignisse eines Kanals aufgelistet. Wenn Fan-Fundings über einen Livechat während einer Liveübertragung des Kanals gestartet werden, wird im Livechat der Übertragung auch eine fanFundingEvent-Nachricht angezeigt.

      Weitere Informationen zur Fan-Finanzierung findest du in der YouTube-Hilfe.
      sponsors Die sponsor-Ressource gibt einen Sponsor eines YouTube-Kanals an. Ein Sponsor zahlt eine monatliche Gebühr an einen Kanal. Neben den Nachrichten von Unterstützern wird in den Livechats des Kanals ein Badge angezeigt. Außerdem können sie an Livechats teilnehmen, die ausschließlich für Unterstützer des Kanals angeboten werden.

      Mit der Methode sponsors.list der API werden die Sponsoren eines Kanals aufgelistet. Wenn Nutzer sich während einer Liveübertragung, die dem Kanal gehört, als Unterstützer eines Kanals registrieren, fügt die API dem Livechat der Übertragung auch eine newSponsorEvent-Nachricht hinzu.

      Weitere Informationen zum Unterstützer-Status

  • Aktualisierungen vorhandener Ressourcen und Methoden

    • Die liveBroadcast-Ressource enthält die folgenden neuen Attribute:

      Attribute
      snippet.liveChatId Die ID für den YouTube-Livechat der Übertragung. Mit dieser ID können Sie die Methoden der liveChatMessage-Ressource verwenden, um Chatnachrichten abzurufen, einzufügen oder zu löschen. Außerdem können Sie Chatmoderatoren hinzufügen oder entfernen, Nutzer für die Teilnahme an Livechats sperren oder bestehende Sperren aufheben.
      contentDetails.closedCaptionsType Hinweis: Dieses Attribut ersetzt das Attribut contentDetails.enableClosedCaptions.

      Dieses Attribut gibt an, ob Untertitel für deine Übertragung aktiviert sind und, falls ja, welche Art von Untertiteln du bereitstellst:
      • closedCaptionsDisabled: Untertitel sind für die Liveübertragung deaktiviert.
      • closedCaptionsHttpPost: Sie senden Untertitel per HTTP POST an eine Aufnahme-URL, die mit Ihrem Livestream verknüpft ist.
      • closedCaptionsEmbedded: Untertitel werden im Videostream im EIA-608- und/oder CEA-708-Format codiert.
      contentDetails.enableClosedCaptions Dieses Attribut wurde am 17. Dezember 2015 eingestellt. Verwende stattdessen die Property contentDetails.closedCaptionsType. Für API-Clients, die diese Eigenschaft bereits verwenden:
      • Wenn Sie den Attributwert auf true festlegen, entspricht das dem Festlegen des Attributs contentDetails.closedCaptionsType auf closedCaptionsHttpPost.
      • Wenn Sie den Attributwert auf false festlegen, entspricht das dem Festlegen des Attributs contentDetails.closedCaptionsType auf closedCaptionsDisabled.

    • Mit dem neuen broadcastType-Parameter der liveBroadcasts.list-Methode können Sie eine API-Antwort filtern, sodass sie nur Ereignis-Broadcasts, nur persistente Broadcasts oder alle Broadcasts enthält.

      Eine dauerhafte Übertragung ist eine Übertragung, die immer existiert und nicht an ein bestimmtes Ereignis gebunden ist. Der Standard-Broadcast eines Kanals ist ein dauerhafter Broadcast, auf den über das Live-Dashboard in YouTube Creator Studio zugegriffen werden kann. Die anderen Übertragungen des Kanals sind Event-Übertragungen.

  • Im Feld status.healthStatus.configurationIssues[].type der liveStream-Ressource werden die folgenden neuen Fehler im Zusammenhang mit dem Status gemeldet:

    Fehler
    audioTooManyChannels Die Audiodaten umfassen mehr als zwei Kanäle. Es werden aber nur ein Kanal (Mono) oder zwei Kanäle (Stereo) unterstützt. Korrigiere die Anzahl der Audiokanäle.
    frameRateHigh Die aktuelle Framerate ist zu hoch. Stelle die Framerate auf %(framerate)s fps oder niedriger ein.

  • Das Veröffentlichungsdatum der vorherigen Dokumentationsaktualisierung wurde korrigiert.

  • Neue und aktualisierte Fehler

    • Zusätzlich zu den für die oben aufgeführten neuen Ressourcen definierten Fehlern unterstützt die API die folgenden neuen Fehler:

      Fehlerdetails
      liveBroadcasts.update
      HTTP-Antwortcodeforbidden (403)
      GrundclosedCaptionsTypeModificationNotAllowed
      BeschreibungDer Wert contentDetails.closedCaptionsType kann nur geändert werden, wenn sich die Übertragung im Status created oder ready befindet.
      liveBroadcasts.update
      HTTP-AntwortcodeinvalidValue (400)
      GrundinvalidEnableClosedCaptions
      BeschreibungIn der liveBroadcast-Ressource ist der Wert der Eigenschaft contentDetails.enableClosedCaptions nicht mit dem Wert der Einstellung contentDetails.closedCaptionType kompatibel. Ändern Sie die Ressource so, dass sie nur eines der beiden Attribute enthält, und senden Sie die Anfrage noch einmal.

19. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Hinweis:Die Dokumentation für die liveChat-Ressource und ihre Methoden ist vertraulich und nur für ausgewählte YouTube-Partner sichtbar.

      Die neue liveChat-Ressource enthält einen Kommentar, der während einer Liveübertragung auf YouTube gepostet wurde. Die API unterstützt zwei Methoden für diese Ressource:

      Methoden
      liveChats.list Listet Livechat-Nachrichten für eine Übertragung auf.
      liveChats.insert Erstellen Sie eine neue Chatnachricht.

      Livechat-Nachrichten können nur abgerufen und gepostet werden, während eine Übertragung live ist.

  • Aktualisierungen vorhandener Ressourcen und Methoden

    • Die liveStream-Ressource enthält die folgenden neuen Attribute:

      Attribute
      snippet.isDefaultStream Gibt an, ob es sich bei diesem Stream um den Standardstream für den Kanal handelt. Der Standardstream eines Kanals ist unbegrenzt verfügbar, hat keine Start- oder Endzeit und kann nicht gelöscht werden. Weitere Informationen zur Funktionsweise von Standardstreams finden Sie in der Definition der Property.
      status.healthStatus Dieses Objekt enthält Informationen, die zur Identifizierung, Diagnose und Behebung von Streamingproblemen verwendet werden können. Das Objekt enthält eine Reihe von untergeordneten Eigenschaften, mit denen Sie den Zustand eines Livestream-Videos beurteilen können.

      Insbesondere im status.healthStatus.configurationIssues[]-Objekt werden Probleme aufgeführt, die sich auf einen Videostream auswirken. Im neuen Dokument Konfigurationsprobleme für LiveStream-Ressourcen werden alle Probleme aufgeführt, die von der API gemeldet werden.
      contentDetails.isReusable Gibt an, ob der Stream wiederverwendbar ist. Das bedeutet, dass er an mehrere Übertragungen gebunden werden kann. Es ist üblich, dass Broadcaster denselben Stream für viele verschiedene Übertragungen wiederverwenden, wenn diese zu unterschiedlichen Zeiten stattfinden.

    • Die liveBroadcast-Ressource enthält die folgenden neuen Attribute:

      Attribute
      snippet.isDefaultBroadcast Gibt an, ob es sich bei dieser Übertragung um die Standardübertragung für den Kanal handelt. Wenn ein YouTube-Kanal für Livestreaming aktiviert ist, erstellt YouTube einen Standardstream und eine Standardsendung für den Kanal. Der Stream definiert, wie der Kanalinhaber Livevideos an YouTube sendet. Die Übertragung ist die Art und Weise, wie Zuschauer den Standardstream sehen können. Weitere Informationen zur Funktionsweise von Standardübertragungen finden Sie in der Definition der Property.
      contentDetails.enableLowLatency Gibt an, ob diese Übertragung für das Streaming mit niedriger Latenz codiert werden soll. Bei einem Stream mit geringer Latenz dauert es weniger lange, bis das Video für Nutzer sichtbar ist, die sich eine Übertragung ansehen. Allerdings kann sich das auch auf die Auflösung für die Zuschauer des Streams auswirken.
      statistics.totalChatCount Die Gesamtzahl der Livechat-Nachrichten, die mit der Übertragung verknüpft sind. Die Property und ihr Wert sind vorhanden, wenn die Übertragung für den Nutzer sichtbar ist und die Livechat-Funktion aktiviert ist. Nach dem Ende der Übertragung wird für diese Eigenschaft kein Wert mehr angegeben. Diese Eigenschaft gibt also nicht die Anzahl der Chatnachrichten für ein archiviertes Video einer abgeschlossenen Liveübertragung an.

  • Neue und aktualisierte Fehler

    • Zusätzlich zu den für die neue liveChat-Ressource definierten Fehlern unterstützt die API den folgenden neuen Fehler:

      Fehlerdetails
      liveStreams.update
      HTTP-Antwortcodeforbidden (403)
      GrundliveStreamModificationNotAllowed
      BeschreibungMit der API können Sie einen wiederverwendbaren Stream nicht in einen nicht wiederverwendbaren Stream ändern und umgekehrt. Weitere Informationen finden Sie unter Informationen zu Übertragungen und Streams.

21. Mai 2015

Dieses Update enthält die folgenden Änderungen:

  • YouTube unterstützt jetzt Livestreaming von Videos mit 60 fps (Frames pro Sekunde). Das bedeutet eine flüssigere Wiedergabe von Gaming-Videos und anderen Videos mit schnellen Aktionen. Wenn du einen Livestream auf YouTube mit 60 FPS startest, stellt YouTube den Stream auch mit 30 FPS auf Geräten zur Verfügung, auf denen die Wiedergabe mit hoher Framerate noch nicht möglich ist.

    Das Attribut cdn.format der Ressource liveStream unterstützt zwei neue Werte für diese Funktion: 720p_hfr und 1080p_hfr.

    Weitere Informationen zu dieser Funktion findest du im YouTube Creators-Blog.

21. August 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Definition des walltime-Parameters der liveBroadcasts.control-Methode wurde aktualisiert. Der Property-Wert wird jetzt im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sssZ) angegeben.

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    insufficientPermissions liveStreamingNotEnabled Alle Methoden für die Ressourcen liveBroadcast und liveStream geben diesen Fehler zurück, wenn der Nutzer, der die API-Anfrage autorisiert hat, nicht für das Streamen von Live-Videos auf YouTube aktiviert ist. Details dazu, warum der Nutzer keine Livestreams starten kann, sind möglicherweise in den Kanaleinstellungen des Nutzers unter https://www.youtube.com/features verfügbar.
    rateLimitExceeded userRequestsExceedRateLimit Die Methoden liveBroadcasts.insert und liveStreams.insert geben diesen Fehler zurück, um anzugeben, dass der Nutzer innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet hat.

2. Mai 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Beschreibungen der liveStream-Ressource und der liveBroadcasts.bind-Methode wurden aktualisiert. Es wird nun darauf hingewiesen, dass eine Übertragung nur an einen Videostream gebunden werden kann, ein Videostream jedoch an mehrere Übertragungen. Es handelt sich lediglich um eine Korrektur der Dokumentation. Die zugrunde liegende API-Funktionalität hat sich nicht geändert.

  • Die contentDetails.monitorStream.enableMonitorStream-Property der liveBroadcast-Ressource wurde aktualisiert. Wenn der Wert der Property true ist, müssen Sie die Übertragung in den Status testing versetzen, bevor Sie sie in den Status live versetzen können. Wenn der Wert der Property false ist, darf die Übertragung keine testing-Phase haben. Sie können die Übertragung also direkt in den Status live überführen.

  • Die settings.offsetTimeMs-Property der liveCuepoint-Ressource wurde aktualisiert. Wenn dein Broadcast keinen Monitorstream hat, solltest du keinen Wert für die Property angeben.

  • Alle Methoden für die Ressourcen liveBroadcast und liveStream unterstützen jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Mit diesen Parametern können Sie dieselben Autorisierungsanmeldedaten verwenden, um API-Anfragen für verschiedene Kanäle abzuschließen, die demselben Rechteinhaber gehören.

  • Die Dokumentation der Methode liveCuepoints.insert wurde aktualisiert. Es wird nun darauf hingewiesen, dass Sie beim Aufrufen dieser Methode einen Wert für das Attribut settings.walltime festlegen können.

  • In der Fehlerdokumentation wird jetzt der HTTP-Antwortcode für jeden Fehlertyp angegeben.

  • Die API unterstützt jetzt den folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    insufficientPermissions livePermissionBlocked Die Methoden liveBroadcasts.insert, liveBroadcasts.transition und liveStreams.insert geben diesen Fehler zurück, wenn der Nutzer, der die Anfrage autorisiert hat, keine Livestreams auf YouTube starten kann. Details dazu, warum der Nutzer keine Livestreams starten kann, sind möglicherweise in den Kanaleinstellungen des Nutzers unter https://www.youtube.com/features verfügbar.

  • Der Fehler invalidScheduledStartTime der Methode liveBroadcasts.insert wurde aktualisiert, um zu verdeutlichen, dass die geplante Startzeit nah genug am aktuellen Datum liegen muss, damit eine Übertragung zuverlässig geplant werden kann.

13. Dezember 2013

Dieses Update enthält die folgenden Änderungen:

  • Die neue status.recordingStatus-Eigenschaft der liveBroadcast-Ressource gibt den aktuellen Status der Übertragung an.

  • Die neue contentDetails.enableClosedCaptions-Property der liveBroadcast-Ressource gibt an, ob Untertitel für die Übertragung aufgenommen werden können. Der Eigenschaftswert kann beim Einfügen oder Aktualisieren einer Broadcast-Nachricht festgelegt werden. Er kann jedoch nicht mehr aktualisiert werden, sobald sich die Broadcast-Nachricht im Status testing oder live befindet. Wenn Sie diese Eigenschaft auf true festlegen, wird die Ingest-URL für die Untertitel der Übertragung durch die liveStream-Ressource angegeben, die an die Übertragung gebunden ist.

  • Die snippet.scheduledEndTime-Eigenschaft der liveBroadcast-Ressource unterstützt jetzt Übertragungen, die auf unbestimmte Zeit geplant sind. Durch diese Änderung ist die Property in liveBroadcasts.insert- und liveBroadcasts.update-Anfragen nicht mehr erforderlich.

    Wenn Sie eine liveBroadcast-Ressource abrufen, in der kein Wert für diese Property angegeben ist, wird die Übertragung auf unbestimmte Zeit fortgesetzt. Wenn Sie die Methode liveBroadcasts.insert oder liveBroadcasts.update aufrufen und keinen Wert für diese Eigenschaft angeben, wird die Übertragung auf unbestimmte Zeit geplant.

  • Das Attribut contentDetails.recordFromStart der Ressource liveBroadcast, das bereits den Standardwert true hatte, kann jetzt nur noch auf false gesetzt werden, wenn der Übertragungskanal Aufzeichnungen für Liveübertragungen deaktivieren darf.

    Wenn dein Kanal nicht berechtigt ist, Aufzeichnungen zu deaktivieren, und du versuchst, eine Übertragung mit der Eigenschaft recordFromStart auf false einzufügen, gibt die API den Fehler Forbidden zurück. Wenn dein Kanal diese Berechtigung nicht hat und du versuchst, eine Übertragung zu aktualisieren, um das Attribut recordFromStart auf false festzulegen, gibt die API außerdem einen modificationNotAllowed-Fehler zurück.

  • Die Ressource liveBroadcast enthält nicht mehr die Property enableArchive, die in den Beschreibungen der Properties contentDetails.enableDvr und contentDetails.enableEmbed erwähnt wurde.

  • Die Liste der gültigen Werte für die liveBroadcast-Property der status.lifeCycleStatus-Ressource wurde aktualisiert und enthält jetzt eine Beschreibung der einzelnen Status.

  • Die neue settings.walltime-Eigenschaft der liveCuepoint-Ressource gibt das Datum und die Uhrzeit an, zu der der Cuepoint eingefügt werden soll. Die API gibt einen Fehler zurück, wenn in einer Anfrage versucht wird, einen Cuepoint einzufügen, für den ein Wert für diese Eigenschaft und für die Eigenschaft settings.offsetTimeMs angegeben ist.

  • Das neue contentDetails-Objekt in einer liveStream-Ressource enthält Informationen zum Stream. Derzeit ist die einzige Property des Objekts contentDetails.closedCaptionsIngestionUrl. Sie gibt die Ingestion-URL für Untertitel an, die dem Videostream zugeordnet sind.

  • Die Liste der gültigen Werte für die liveStream-Property der status.streamStatus-Ressource wurde aktualisiert und enthält jetzt eine Beschreibung der einzelnen Status.

  • Mit dem neuen Parameter walltime der Methode liveBroadcasts.control können Sie das Datum und die Uhrzeit für eine Änderung des Angebots festlegen. Die API gibt einen Fehler zurück, wenn in einer Anfrage ein Wert für diesen Parameter und für den Parameter offsetTimeMs angegeben wird.

  • In der API-Antwort auf eine liveBroadcasts.list-Anfrage hat sich der Wert des Attributs kind von youtube#liveBroadcastList zu youtube#liveBroadcastListResponse geändert.

  • In der API-Antwort auf eine liveStreams.list-Anfrage hat sich der Wert des Attributs kind von youtube#liveStreamList zu youtube#liveStreamListResponse geändert.

  • Das Attribut eventId wird sowohl für liveBroadcastListResponse als auch für liveStreamListResponse nicht mehr unterstützt.

  • Die API unterstützt die folgenden neuen Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    invalidValue conflictingTimeFields Die Methode liveBroadcasts.control gibt diesen Fehler zurück, wenn in Ihrer Anfrage Werte für die Parameter offsetTimeMs und walltime angegeben sind. In einer Anfrage können entweder beide Parameter weggelassen oder ein Wert für einen der beiden Parameter angegeben werden.
    invalidValue invalidWalltime Die liveBroadcasts.control-Methode gibt diesen Fehler zurück, wenn der Wert des Parameters walltime ungültig ist.
    forbidden enableClosedCaptionsModificationNotAllowed Die Methode liveBroadcasts.update gibt diesen Fehler zurück, wenn Sie versuchen, den Wert contentDetails.enableClosedCaptions zu aktualisieren und der Status der Übertragung nicht created oder ready ist.
    invalidValue conflictingTimeFields Die Methode liveCuepoints.insert gibt diesen Fehler zurück, wenn in Ihrer Anfrage Werte für die Attribute settings.offsetTimeMs und settings.walltime angegeben sind. In einer Anfrage können entweder beide Eigenschaften weggelassen oder ein Wert für eine der beiden Eigenschaften angegeben werden.

    Außerdem wird bei der liveStreams.update-Methode kein cdnRequired-Fehler mehr unterstützt, wie es bei der liveStreams.insert-Methode der Fall ist.

10. Mai 2013

Dieses Update enthält die folgenden Änderungen:

2. Mai 2013

Dieses Update enthält die folgenden Änderungen:

27. März 2013

Dieses Update enthält die folgenden Änderungen:

  • Die folgenden Properties haben sich in der liveBroadcast-Ressource geändert:

    • Das Attribut startWithSlateCuepoint wurde in startWithSlate umbenannt.
    • Das Attribut enableArchive wurde in recordFromStart umbenannt.
    • Das Objekt slateSettings wurde verworfen und aus der Dokumentation entfernt. Fehlermeldungen im Zusammenhang mit dem slateSettings-Objekt oder seinen Attributen wurden ebenfalls entfernt. Außerdem wurde der Abschnitt „Slates anzeigen“ im Startleitfaden entfernt.

  • Die API unterstützt nicht mehr die Möglichkeit, In-Stream-Slates mit der Methode liveCuepoints.insert einzufügen. Die folgenden Dokumente wurden zur Berücksichtigung dieser Änderung aktualisiert:

18. März 2013

Dieses Update enthält die folgenden Änderungen:

  • Alle Fehlermeldungen der API wurden aktualisiert, um mögliche Fehler klarer zu erläutern und, wenn möglich, Anleitungen zur Behebung der Fehler zu geben.

  • Die API kann jetzt mehrere neue Fehler zurückgeben. In der folgenden Liste sind die Fehler und die API-Methode aufgeführt, die diesen Fehler möglicherweise zurückgibt:

    • liveBroadcasts.insert: Das geplante Ende einer Übertragung muss nach dem geplanten Beginn liegen.
    • liveBroadcasts.insert: Für die Übertragung wurde ein ungültiger Datenschutzstatus angegeben.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für die Property contentDetails.enableArchive oder es wird kein Wert dafür festgelegt.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für die Property contentDetails.enableContentEncryption oder es wird kein Wert dafür festgelegt.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für die Property contentDetails.enableDvr oder es wird kein Wert dafür festgelegt.
    • liveStreams.insert: Der Snippet-Titel muss zwischen 1 und 128 Zeichen lang sein.
    • liveStreams.update: Die Ressource enthält keinen Wert für die Property snippet.title oder es wird kein Wert dafür festgelegt.

  • Die Dokumentation zur liveStream-Ressource wurde aktualisiert. Multicast und WebM sind keine unterstützten Aufnahmemethoden, wie zuvor angegeben. Die Liste der Formate für das Attribut cdn.format wurde entsprechend aktualisiert und das Objekt cdn.multicastIngestionInfo und seine untergeordneten Attribute wurden aus der Dokumentation der Ressource entfernt. Außerdem wurde http aus der Liste der unterstützten cdn.ingestionType-Werte entfernt.