YouTube Live Streaming API – Überarbeitungsverlauf

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

12. Oktober 2026

Dieses Update enthält die folgenden Änderungen:

18. August 2026

Dieses Update enthält die folgenden Änderungen:

  • Die Dokumentation für die Methode liveBroadcasts.update wurde um neue Monetarisierungsfehler erweitert: preconditionFailed (412) (Grund: videoNotEligibleForAdsMonetization) und backendError (503) (Grund: backendError).

17. August 2026

Dieses Update enthält die folgenden Änderungen:

  • Mit der neuen snippet.categoryId-Eigenschaft der liveBroadcast-Ressource kannst du die Videokategorie festlegen, aktualisieren und abrufen, die mit einer Liveübertragung verknüpft ist.

20. Juli 2026

Dieses Update enthält die folgenden Änderungen:

9. Juli 2026

Dieses Update enthält die folgenden Änderungen:

1. Juni 2026

Dieses Update enthält die folgenden Änderungen:

  • Mit der Property contentDetails.availabilityConfig der Ressource liveBroadcast kannst du geografische Einschränkungen für eine Liveübertragung festlegen, um die regionale Verfügbarkeit von Live-Veranstaltungen zu verwalten.

26. März 2026

Dieses Update enthält die folgenden Änderungen:

  • Die Property snippet.type unterstützt jetzt den neuen Wert giftEvent.

  • Die neue Property snippet.giftEventDetails der Ressource liveChatMessage und ihre untergeordneten Elemente enthalten Informationen zum Geschenkereignis.

12. Januar 2026

Die API unterstützt jetzt das Aktivieren von Mid-Rolls und das automatische Einfügen von Mid-Rolls für Liveübertragungen.

Der Eigentümer der Übertragung kann Mid-Rolls für eine Übertragung aktivieren, sofern die Übertragung für Mid-Rolls infrage kommt. Der Inhaber kann Midrolls für eine Übertragung auch jederzeit deaktivieren.

Wenn für eine Übertragung Mid-Rolls aktiviert sind, kann der Inhaber der Übertragung die automatische Mid-Roll-Einfügung aktivieren. Sie können automatisierte Anzeigen für einen Livestream auch jederzeit deaktivieren.

Wenn der Inhaber des Livestreams automatisierte Anzeigen aktiviert, kann er eine der folgenden Optionen auswählen:

  • Mid-Roll-Anzeigen von YouTube optimieren lassen Diese Option unterstützt drei Modi:
    • Niedrig: geringeres Umsatzpotenzial, relativ wenige Unterbrechungen für Zuschauer
    • Mittel: mittleres Umsatzpotenzial, höhere Nutzerfreundlichkeit
    • Hoch: höheres Umsatzpotenzial, relativ viele Unterbrechungen für Zuschauer
  • Konfigurieren Sie die Strategie und das Intervall für das Einfügen von Mid-Rolls manuell. In diesem Fall muss der Inhaber zwei Parameter einrichten:
    1. Die Planungsstrategie für Anzeigen-Cue-Points. Cue-Points können für alle Zuschauer gleichzeitig eingefügt werden oder das Timing der Cue-Points kann von Zuschauer zu Zuschauer variieren. Bei dieser Strategie kann YouTube Cuepoints häufiger einplanen, sodass Zuschauer Cuepoints erhalten, wenn sie die Voraussetzungen dafür erfüllen.
    2. Die Länge des Intervalls zwischen Mid-Roll-Werbeunterbrechungen.

In der Dokumentation werden die folgenden API-Änderungen zur Unterstützung dieser Funktion beschrieben:

  • Das monetizationDetails-Objekt der liveBroadcast-Ressource enthält Felder für die Aktivierung von Mid-Rolls und die Konfiguration automatisierter Anzeigen.
  • Mit der Methode update können Mid-Roll-Anzeigen aktiviert oder deaktiviert werden. Diese Methode kann auch verwendet werden, um automatisierte Anzeigen für eine Liveübertragung einzurichten. In der Dokumentation werden mehrere neue Fehler beschrieben, die beim Aktualisieren der Monetarisierungs- und Einstellungen für automatische Anzeigen für eine Liveübertragung auftreten können.

14. Juli 2025

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

9. Oktober 2023

In dieser CSV-Datei kannst du nachsehen, 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 eine Übertragung einfügen kannst, unterstützt YouTube jetzt eine Funktion, mit der Mid-Roll-Werbeunterbrechungen in festen Intervallen automatisch in eine Übertragung eingefügt werden.

Wenn der Inhaber der Übertragung automatisierte Anzeigen aktiviert, kann er die folgenden Aspekte des Anzeigenverhaltens sehen:

  • die Länge des Intervalls zwischen Mid-Roll-Werbeunterbrechungen.
  • die Planungsstrategie für Cuepoints für Anzeigen. Cue-Points können für alle Zuschauer gleichzeitig eingefügt werden oder das Timing der Cue-Points kann von Zuschauer zu Zuschauer variieren. Mit der letztgenannten Strategie kann YouTube Cuepoints häufiger planen, sodass Zuschauer Cuepoints erhalten, wenn sie dazu berechtigt sind.
  • Ein Zeitraum, in dem keine Mid-Roll-Anzeigen eingeblendet werden. Bei dieser Funktion gibt der Inhaber der Übertragung an, dass das Einfügen von Mid-Roll-Anzeigen bis zu einem bestimmten Zeitpunkt pausiert wird.

In der Dokumentation werden die folgenden API-Änderungen zur Unterstützung dieser Funktion berücksichtigt:

  • Die liveBroadcast-Ressource enthält jetzt ein monetizationDetails-Objekt. Die Felder des Objekts geben an, ob die automatische Anzeigenbereitstellung 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:

  • Für die Methode liveBroadcasts.update müssen für die folgenden Felder keine Werte mehr 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 alle Kanalinhaber, die eine Liveübertragung auf YouTube durchführen, Cuepoints in diese Übertragung einfügen, die Werbeunterbrechungen auslösen können. Diese Methode ersetzt die Methode liveCuepoints.insert, mit der nur YouTube-Inhaltspartner Cuepoints in Liveübertragungen einfügen konnten.

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

  • Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

    Die Methode liveCuepoints.insert wird nicht mehr unterstützt. Der Support für die Methode liveCuepoints.insert wird am oder nach dem 1. Mai 2023 eingestellt. API-Nutzer sollten ihre Anwendungen so aktualisieren, dass stattdessen die Methode liveBroadcasts.cuepoint aufgerufen wird.

  • Die Dokumentation für die Methode liveBroadcasts.control wurde entfernt. Eine Mitteilung zur Einstellung dieser Methode wurde im September 2020 veröffentlicht.

1. Oktober 2022

Dieses Update enthält die folgenden Änderungen:

  • Für die Methode liveBroadcasts.update müssen für die folgenden Felder keine Werte mehr 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

  • Das neue Attribut snippet.membershipGiftingDetails der Ressource liveChatMessage und die untergeordneten Elemente enthalten Informationen zum Ereignis „Verschenke eine Mitgliedschaft“. Ebenso enthalten 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 Chatnachricht für treue Mitglieder-Event. Die neue Property snippet.newSponsorDetails und ihre untergeordneten Elemente enthalten Informationen zum Ereignis „Neuer Sponsor“.

1. Dezember 2020

Die Methode liveBroadcasts.transition der API unterstützt einen neuen 403-Fehler (Forbidden), der angibt, dass der Nutzer innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet hat. Die Fehlerursache 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 auf Kinder ausgerichtet kennzeichnen möchtest, setze die Property status.selfDeclaredMadeForKids auf true, wenn du die Methode liveBroadcasts.insert aufrufst, um die Übertragung zu erstellen.

  • Hinweis:Diese Änderung umfasst eine Einstellungserklärung und ein Update einer früheren Einstellungserklärung.

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

    Das Datum für die Einstellung der am 16. April 2020 angekündigten Funktionen, das ursprünglich für den 1. September 2020 geplant war, wurde verschoben und wird nun am oder nach dem 1. Oktober 2020 erfolgen. Die in der Ankündigung zur Einstellung enthaltenen Funktionen und die Methode liveBroadcasts.control werden also gleichzeitig eingestellt.

17. Juli 2020

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

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, müssen Sie ihn aktualisieren, um die Framerate und die Auflösung separat mit den Properties cdn.frameRate und cdn.resolution anzugeben.

6. Juli 2020

Der Leitfaden Live-Inhalte von YouTube über HLS bereitstellen wurde aktualisiert und enthält einige Änderungen:

  • Die empfohlene Dauer für ein Media-Segment wurde auf ein bis vier Sekunden aktualisiert.
  • In einem neuen Abschnitt wird erläutert, wie du eine HLS-Ingest-URL aus YouTube Creator Studio abrufst.
  • 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-Ingest-URL über die YouTube API oder YouTube Creator Studio abgerufen wird.

Außerdem wird im neuen Vergleich der Aufnahmeprotokolle aufgeführt, welche Aufnahmeprotokolle von YouTube unterstützt werden, welche Codecs für die einzelnen Protokolle unterstützt werden und welche Anwendungsfälle für die einzelnen Protokolle infrage kommen.

16. April 2020

Dieses Update enthält eine neue Property und eine Ankündigung zur Einstellung:

  • Die Ressource liveBroadcast unterstützt jetzt das Attribut contentDetails.enableAutoStop. Die Property gibt an, ob eine Übertragung etwa eine Minute, nachdem der Kanalinhaber das Streamen von Videos im verknüpften Videostream beendet hat, automatisch beendet werden soll.

    Das Dokument Lebenszyklus einer Übertragung wurde aktualisiert. Es wird nun erklärt, wie sich die schrittweise Erstellung und Verwaltung eines YouTube-Live-Events ändert, wenn du die Properties contentDetails.enableAutoStart oder contentDetails.enableAutoStop auf true setzt.

  • Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen. Diese Änderungen treten am oder nach dem 1. September 2020 in Kraft. Das tatsächliche Datum, an dem die Änderungen wirksam werden, wird unten als Datum der Einstellung bezeichnet.

    In diesem Update wird eine potenziell funktionsgefährdende Änderung erläutert. Sie betrifft API-Clientanwendungen, die die Standardressourcen liveStream und liveBroadcast von Kanälen verwenden, um Live-Inhalte auf YouTube zu streamen. Konkret können die Broadcast-ID und die 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 einer der folgenden Punkte zutrifft:

    • Es wird der Wert der Eigenschaft isDefaultBroadcast der Ressource liveBroadcast geprüft. Diese Eigenschaft wird nach dem Einstellungsdatum nicht mehr zurückgegeben.
    • Es wird der Wert des Attributs isDefaultStream der Ressource liveStream geprüft. Diese Property wird nach dem Datum der Einstellung nicht mehr zurückgegeben.
    • Sie ruft die Methode liveBroadcasts.list auf und setzt den Parameterwert broadcastType auf persistent oder all. Dieser Parameter wird im Rahmen dieser Änderungen eingestellt. Ab dem Einstellungsdatum:
      • Wenn der Parameterwert broadcastType persistent ist, gibt die Methode liveBroadcasts.list keine Ergebnisse zurück.
      • Wenn der Parameterwert broadcastType all ist, gibt die Methode liveBroadcasts.list keine dauerhaften Übertragungen zurück, die vor diesem Zeitpunkt vorhanden waren.

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

    Ab dem Einstellungsdatum gilt Folgendes:

    • YouTube erstellt keine Standardstreams und ‑übertragungen mehr. Anstatt sich auf die Standardressourcen zu verlassen, müssen API-Clients in der Lage sein, liveBroadcast- und liveStream-Ressourcen zu erstellen und zu verwalten und diese Ressourcen miteinander zu verknüpfen.
    • Wenn die Standardübertragung und der Standardstream eines Kanals aktiv sind, d. h. der Kanal sie zum Zeitpunkt des Inkrafttretens der Einstellung für eine Liveübertragung verwendet, ist die laufende Übertragung nicht betroffen. Nach dem Ende dieser Übertragung kann der Kanal die Standardübertragung und den Standardstream jedoch nicht mehr verwenden.
    • Wenn die Standardübertragung und der Standardstream eines Kanals nicht aktiv sind, ignoriert YouTube nach 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:

    • Ein neuer Migrationsleitfaden beschreibt die Schritte, die Entwickler in API-Clients ausführen müssen, die derzeit Standard-Broadcasts und ‑Streams verwenden.
    • Im Leitfaden Der Lebenszyklus 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 Mitteilung über die Einstellung von Funktionen.

Die Ressource sponsor und die Methode sponsors.list wurden verworfen 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, um stattdessen die Methode members.list zu verwenden. Weitere Informationen zur neuen Ressource findest du im Überarbeitungsverlauf der YouTube Data API.

11. März 2020

Der Abschnitt Ingestion endpoint im Leitfaden Delivering Live YouTube Content via HLS 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-Inhalte von YouTube über HLS bereitstellen wurde aktualisiert. Es wird jetzt 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 für Kinder zu identifizieren, die YouTube als „speziell für Kinder“ bezeichnet. Weitere Informationen zu Inhalten, die als „speziell für Kinder“ gekennzeichnet sind, findest du in der YouTube-Hilfe.

  • Die Ressource liveBroadcast unterstützt zwei neue Properties, mit denen Creator und Zuschauer Inhalte identifizieren können, die speziell für Kinder erstellt wurden:
    • Mit der Property selfDeclaredMadeForKids können Creator angeben, ob eine Liveübertragung auf Kinder ausgerichtet ist. Diese Eigenschaft kann beim Erstellen einer Übertragung über die liveBroadcasts.insert-Methode festgelegt werden. Diese Property ist nur in API-Antworten enthalten, die liveBroadcast-Ressourcen enthalten, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
    • Mit der madeForKids-Property kann jeder API-Nutzer den Status „speziell für Kinder“ einer Übertragung abrufen. Der Status kann beispielsweise anhand des Werts des Attributs selfDeclaredMadeForKids bestimmt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen findest du in der YouTube-Hilfe.
  • In der YouTube Data API unterstützt die Ressource channel auch die neuen Properties selfDeclaredMadeForKids und madeForKids.

Wir haben auch die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler*innen aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf der Nutzungsbedingungen der YouTube API-Dienste. Die Änderungen an den Nutzungsbedingungen für YouTube API-Dienste und den Richtlinien für Entwickler treten am 10. Januar 2020 (Pacific Time) in Kraft.

20. August 2019

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

  • Darin wird erläutert, dass es empfehlenswert ist, sowohl bestätigte als auch ausstehende Segmente in jede Media-Playlist aufzunehmen. Dadurch wird die Wahrscheinlichkeit verringert, dass ein Segment übersprungen wird, wenn eine Medien-Playlist auf der Serverseite verloren geht. Sie können beispielsweise bis zu zwei bestätigte Segmente und bis zu fünf ausstehende Segmente in jede Medien-Playlist aufnehmen.
  • Es ist jetzt erforderlich, für jedes Mediensegment eine Medien-Playlist zu senden. So kann der Server schnell wiederhergestellt werden, wenn eine Medien-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 Property ingestionType der Ressource liveStream den neuen Wert hls, um Streams zu identifizieren, die über HLS in YouTube aufgenommen wurden.

Der neue Leitfaden Live-Inhalte auf YouTube über HLS bereitstellen enthält Richtlinien für die Verwendung von HLS zum Streamen von Live-Inhalten von einem Encoder auf 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, tatsächliche API-Anfragen senden und tatsächliche API-Antworten sehen. 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. Beispielsweise kannst du die Methode liveBroadcasts.list aufrufen, um Daten zu einem bestimmten Broadcast oder zu den Broadcasts des aktuellen Nutzers abzurufen.

      Über die Links in diesem Abschnitt können Sie den APIs Explorer mit Beispielwerten für Ihren Anwendungsfall füllen oder den Vollbild-APIs Explorer 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 APIs Explorer im Vollbildmodus öffnen, um Codebeispiele in Java, JavaScript, PHP und Python zu erhalten.

    Im Zuge 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, in der ein Bild angezeigt wird. Wie andere Super Chats wird auch eine Super Sticker-Nachricht von einem Fan während eines YouTube-Livestreams gekauft.

  • In einer liveChatMessage-Ressource ist das Attribut snippet.type 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 Methode superChatEvents.list wurde aktualisiert, um zu berücksichtigen, dass die API-Antwort keine fanFundingEvents mehr enthält, die Anfang 2017 eingestellt wurden.

3. April 2017

Es wurden neue Java-Codebeispiele hinzugefügt, die zeigen, wie du Livechat-Nachrichten auflisten, einfügen und löschen kannst. 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 zu berücksichtigen, 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 Wert des Attributs 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 das Standardverhalten darin besteht, Anzeigestrings so zu formatieren, wie sie im Englischen verwendet würden. Beispielsweise wird ein String standardmäßig 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 ein Fan während eines YouTube-Livestreams gekauft hat. Super Chats heben sich im YouTube-Live-Chat-Stream auf zwei Arten von anderen Nachrichten ab:

      • Super Chats werden farblich hervorgehoben.
      • Super Chats bleiben für eine bestimmte Zeit im Ticker angepinnt.

      Die Farbe des Super Chats, die Dauer, für die 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. Diese Methode gibt auch Daten zu Fan-Funding-Ereignissen (fanFundingEvents) aus dem letzten Livestream des Kanals zurück.

  • 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 enthalten das neue Attribut snippet.superChatDetails der Ressource liveChatMessage und die untergeordneten Elemente Informationen zum Super Chat-Ereignis.

    • Das Attribut cdn.resolution der Ressource liveStream 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 eingefügte oder aktualisierte liveBroadcast-Ressource einen ungültigen Wert für die Property contentDetails.enableEmbed oder contentDetails.projection enthält. Die Fehlerursachen für die beiden neuen Fehler sind invalidEmbedSetting bzw. invalidProjection.

12. Januar 2017

Hinweis: Dies ist eine Mitteilung über die Einstellung von Funktionen.

Im Zusammenhang mit der Veröffentlichung 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ändigen neuen Dokumente werden im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen beschrieben. Zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder den zugehörigen Dokumenten werden ebenfalls in diesem Überarbeitungsverlauf erläutert. Über einen Link in diesem Dokument können Sie einen RSS-Feed abonnieren, in dem die Änderungen in diesem Überarbeitungsverlauf aufgeführt sind.

20. Mai 2016

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

Der neue Leitfaden Live-Inhalte auf YouTube über DASH bereitstellen enthält Richtlinien für die Verwendung des DASH-Bereitstellungsformats, um Live-Daten von einem Encoder auf YouTube zu streamen. 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 bei 30 oder 60 Bildern pro Sekunde.

        Außerdem enthält die liveStream-Ressource neue Properties, mit denen die Framerate und die Auflösung der eingehenden Videodaten angegeben werden können:

        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 Attributwerte sind: 1440p, 1080p, 720p, 480p, 360p und 240p.

      • Mit der Einführung der Eigenschaften cdn.frameRate und cdn.resolution der liveStream-Ressource wird die cdn.format-Ressource nicht mehr unterstützt. 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 veraltet, 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-Ressourcenaktualisierungen

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

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

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

    • liveChatMessage-Ressourcenaktualisierungen

      • Die Property snippet.type unterstützt zwei neue Werte, messageDeletedEvent und userBannedEvent, die den neuen Properties entsprechen, 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 Ressource liveChatMessage enthält die folgenden neuen Attribute:

        Attribute
        snippet.messageDeletedDetails Dieses Objekt enthält Informationen zu einer Nachricht, die von einem Chatmoderator gelöscht wurde. Das Objekt ist nur vorhanden, wenn der Wert des Attributs 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 zur Sperre selbst, d. h. ob die Sperre dauerhaft oder vorübergehend ist. Wenn die Sperre vorübergehend ist, wird die Dauer der Sperre in einer der Properties des Objekts angegeben.

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

  • Neue und aktualisierte Fehler

    • Die API unterstützt die folgenden neuen Fehler:

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

      Die Methoden liveBroadcasts.insert und liveBroadcasts.update unterstützen bereits denselben Fehler.
      liveStreams.insert Die Methode liveStreams.insert unterstützt vier neue 400-Fehler (Bad Request), die einen ungültigen Attributwert in der liveStream-Ressource identifizieren, die mit der Anfrage eingefügt werden sollte. In der folgenden Liste sind die Fehlerursachen und die zugehörigen Attribute 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 Attribute aufgeführt:
      Genauer gesagt: Wenn du eine liveStream-Ressource einfügst, musst du entweder einen Wert für die Property cdn.format oder für die Properties cdn.frameRate und cdn.resolution angeben.
      • Die API gibt einen formatRequired-Fehler zurück, wenn Sie für keine der drei Properties einen Wert angeben.
      • Die API gibt den Fehler frameRateRequired zurück, wenn Sie einen Wert für cdn.resolution, aber nicht für cdn.frameRate angeben.
      • Die API gibt den Fehler resolutionRequired zurück, wenn Sie einen Wert für cdn.frameRate, aber nicht für cdn.resolution angeben.
      liveStreams.update Die Methode liveStreams.update gibt den Fehler 403 (Forbidden) zurück, wenn mit der Anfrage versucht wird, den Wert einer der folgenden unveränderlichen Eigenschaften zu ändern: Der reason in der Fehlerantwort ist liveStreamModificationNotAllowed.

18. Dezember 2015

Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzern in der EU bestimmte Informationen offengelegt und ihre Einwilligung eingeholt werden. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben einen Hinweis auf diese Anforderung in die Nutzungsbedingungen der YouTube API 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 unterstützen. YouTube unterstützt die Livechat-Funktion während aktiver Liveübertragungen. Diese Ressourcen und ihre Methoden unterstützen das Abrufen von Chatnachrichten sowie administrative Funktionen für den Chat.

      Ressourcen
      liveChatMessage Diese Ressource stellt eine Nachricht in einem YouTube-Livechat dar. YouTube unterstützt verschiedene Arten von Nachrichten, darunter Textnachrichten und Fan-Funding-Ereignisse. Einige Nachrichtentypen kennzeichnen eine bestimmte Phase des Chats, z. B. den Beginn eines Zeitraums, in dem nur Kanalmitglieder Nachrichten senden 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 einige 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 Live-Chat-Moderatoren.
      liveChatBans Diese Ressource identifiziert einen Nutzer, der keine Nachrichten in einem bestimmten Live-Chat 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 Fan-Funding können Zuschauer YouTube-Creator einmalig finanziell unterstützen.

      Mit der Methode fanFundingEvents.list der API werden die Fan-Funding-Ereignisse eines Kanals aufgelistet. Fan-Funding-Ereignisse, die über einen Live-Chat während einer Liveübertragung des Kanals initiiert werden, lösen auch eine fanFundingEvent-Nachricht im Live-Chat der Übertragung aus.

      Weitere Informationen zur Fan-Funding findest du in der YouTube-Hilfe.
      sponsors Die Ressource sponsor identifiziert einen Sponsor eines YouTube-Kanals. Ein Sponsor zahlt eine monatliche Gebühr an einen Kanal. In den Live-Chats des Kanals wird neben den Nachrichten des Sponsors ein Badge angezeigt. Außerdem können Sponsoren an Live-Chats teilnehmen, die exklusiv für Sponsoren 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 eines Kanals als Unterstützer registrieren, fügt die API dem Live-Chat der Übertragung auch eine newSponsorEvent-Nachricht hinzu.

      Weitere Informationen zu Sponsorings findest du in der YouTube-Hilfe.

  • Aktualisierungen vorhandener Ressourcen und Methoden

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

      Attribute
      snippet.liveChatId Die ID des YouTube-Livechats für die Ü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: Du sendest Untertitel per HTTP-POST an eine Ingestion-URL, die mit deinem Livestream verknüpft ist.
      • closedCaptionsEmbedded: Untertitel werden im Videostream mit den Formaten EIA-608 und/oder CEA-708 codiert.
      contentDetails.enableClosedCaptions Diese Property 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 Parameter broadcastType der Methode liveBroadcasts.list kannst du eine API-Antwort so filtern, dass sie Event-Broadcasts, persistente Broadcasts oder alle Broadcasts enthält.

      Ein dauerhafter Broadcast ist immer vorhanden und nicht an ein bestimmtes Ereignis gebunden. Der Standard-Broadcast eines Kanals ist ein persistenter Broadcast und kann über das Live-Dashboard im YouTube Creator Studio aufgerufen werden. Die anderen Übertragungen des Kanals sind Event-Übertragungen.

  • Im Feld status.healthStatus.configurationIssues[].type der Ressource liveStream werden die folgenden neuen Statusfehler 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. Bitte lege die Framerate auf maximal %(framerate)s fps fest.

  • 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 der Broadcast den Status created oder ready hat.
      liveBroadcasts.update
      HTTP-AntwortcodeinvalidValue (400)
      GrundinvalidEnableClosedCaptions
      BeschreibungIn der liveBroadcast-Ressource ist der Wert der contentDetails.enableClosedCaptions-Property mit dem Wert der contentDetails.closedCaptionType-Einstellung inkompatibel. Ä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 zur Ressource liveChat und ihren 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 Live-Chat-Nachrichten für eine Übertragung auf.
      liveChats.insert Erstellen Sie eine neue Chatnachricht.

      Livechat-Nachrichten können nur abgerufen und gepostet werden, während ein Stream live ist.

  • Aktualisierungen vorhandener Ressourcen und Methoden

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

      Attribute
      snippet.isDefaultStream Gibt an, ob dieser Stream der Standardstream für den Kanal ist. 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 du den Zustand eines Live-Videostreams bewerten kannst.

      Insbesondere im Objekt status.healthStatus.configurationIssues[] 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, d. h., ob 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 Eigenschaften:

      Attribute
      snippet.isDefaultBroadcast Gibt an, ob diese Übertragung die Standardübertragung für den Kanal ist. 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-Broadcasts finden Sie in der Definition der Property.
      contentDetails.enableLowLatency Gibt an, ob diese Übertragung für Low-Latency-Streaming codiert werden soll. Bei einem Stream mit niedriger Latenz kann die Zeit, die es dauert, bis das Video für die Zuschauer einer Übertragung sichtbar ist, verkürzt werden. Dies kann sich jedoch auch auf die Auflösung für die Zuschauer des Streams auswirken.
      statistics.totalChatCount Die Gesamtzahl der Live-Chat-Nachrichten, die mit der Übertragung verknüpft sind. Das Attribut und sein Wert sind vorhanden, wenn die Übertragung für den Nutzer sichtbar ist und die Live-Chat-Funktion aktiviert ist. Nach dem Ende der Übertragung wird für dieses Attribut kein Wert mehr angegeben. Diese Property 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 Live-Videostreams mit 60 Bildern pro Sekunde (fps). Das bedeutet eine flüssigere Wiedergabe von Gaming- und anderen Videos mit schnellen Bewegungen. 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 verfügbar ist.

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

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

21. August 2014

Dieses Update enthält die folgenden Änderungen:

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

  • 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 berechtigt ist, Live-Videos auf YouTube zu streamen. In den Kanaleinstellungen des Nutzers unter https://www.youtube.com/features findest du möglicherweise weitere Informationen dazu, warum der Nutzer keine Live-Videos streamen kann.
    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 Ressource liveStream und der Methode liveBroadcasts.bind 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 Property contentDetails.monitorStream.enableMonitorStream der Ressource liveBroadcast wurde aktualisiert. Wenn der Wert der Property true ist, musst du den Broadcast in den Status testing versetzen, bevor du ihn in den Status live versetzen kannst. Wenn der Wert der Property false ist, kann die Übertragung keine testing-Phase haben. Sie können die Übertragung also direkt in den Status live versetzen.

  • Die Property settings.offsetTimeMs der Ressource liveCuepoint wurde aktualisiert. Es wird nun darauf hingewiesen, dass du keinen Wert für die Property angeben solltest, wenn dein Broadcast keinen Monitor-Stream hat.

  • Alle Methoden für die Ressourcen liveBroadcast und liveStream unterstützen jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Mit diesen Parametern kannst du dieselben Autorisierungsdaten verwenden, um API-Anfragen für verschiedene Kanäle desselben Rechteinhabers auszuführen.

  • Die Dokumentation zur Methode liveCuepoints.insert wurde aktualisiert. Es wird jetzt 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 Live-Videos auf YouTube streamen kann. In den Kanaleinstellungen des Nutzers unter https://www.youtube.com/features findest du möglicherweise weitere Informationen dazu, warum der Nutzer keine Live-Videos streamen kann.

  • Der invalidScheduledStartTime-Fehler der liveBroadcasts.insert-Methode 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-Property 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 Attributwert kann beim Einfügen oder Aktualisieren einer Übertragung festgelegt werden. Er kann jedoch nicht mehr aktualisiert werden, wenn die Übertragung den Status testing oder live hat. Wenn du diese Property auf true festlegst, wird in der liveStream-Ressource, die an die Übertragung gebunden ist, die Aufnahme-URL angegeben, die für die Untertitel der Übertragung verwendet werden soll.

  • Die Property snippet.scheduledEndTime der Ressource liveBroadcast unterstützt jetzt Übertragungen, die auf unbestimmte Zeit fortgesetzt werden sollen. 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 Property angeben, wird die Übertragung auf unbestimmte Zeit fortgesetzt.

  • Das Attribut contentDetails.recordFromStart der Ressource liveBroadcast, das bereits den Standardwert true hatte, kann jetzt nur auf false gesetzt werden, wenn der übertragende Kanal 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 zu setzen, gibt die API den Fehler Forbidden zurück. Wenn dein Kanal nicht über diese Berechtigung verfügt und du versuchst, eine Übertragung zu aktualisieren, um die Eigenschaft recordFromStart auf false festzulegen, gibt die API den Fehler modificationNotAllowed 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 das Attribut status.lifeCycleStatus der Ressource liveBroadcast wurde aktualisiert und enthält jetzt eine Beschreibung der einzelnen Status.

  • Das neue Attribut settings.walltime der Ressource liveCuepoint 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 Cue-Point einzufügen, der einen Wert für diese Property und für die Property settings.offsetTimeMs angibt.

  • Das neue contentDetails-Objekt in einer liveStream-Ressource enthält Informationen zum Stream. Derzeit ist die einzige Eigenschaft 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 Eigenschaft status.streamStatus der Ressource liveStream wurde aktualisiert und enthält jetzt eine Beschreibung der einzelnen Status.

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

  • 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 in youtube#liveStreamListResponse geändert.

  • Das Attribut eventId wird sowohl in liveBroadcastListResponse als auch in 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 Methode liveBroadcasts.control 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 du versuchst, 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 Attribute weggelassen oder ein Wert für eines der beiden Attribute angegeben werden.

    Außerdem unterstützt die Methode liveStreams.update keinen cdnRequired-Fehler mehr, der dem von der Methode liveStreams.insert unterstützten Fehler ähnelt.

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 Attribute haben sich in der Ressource liveBroadcast 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. Der Abschnitt „Displaying Slates“ (Slates anzeigen) im Startleitfaden wurde 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 besser zu erklären und, wenn möglich, Hinweise zu deren Behebung zu geben.

  • Die API kann jetzt mehrere neue Fehler zurückgeben. In der folgenden Liste werden 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 den Broadcast ist ein ungültiger Datenschutzstatus angegeben.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für die Eigenschaft contentDetails.enableArchive oder es wird kein Wert für sie festgelegt.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für die Eigenschaft contentDetails.enableContentEncryption oder es wird kein Wert für sie festgelegt.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für die Eigenschaft contentDetails.enableDvr oder es wird kein Wert für sie 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 Eigenschaft snippet.title oder es wird kein Wert für sie festgelegt.

  • Die Dokumentation zur Ressource liveStream wurde aktualisiert, um zu verdeutlichen, dass Multicast und WebM keine unterstützten Aufnahmemethoden sind, 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.