YouTube Live Streaming API – Überarbeitungsverlauf

Auf dieser Seite werden Änderungen an der YouTube Live Streaming API und Aktualisierungen der Dokumentation aufgeführt. Dieses Änderungsprotokoll abonnieren Abonnieren

9. Oktober 2023

In dieser CSV-Datei kannst du nachsehen, welche Sticker-IDs zu welchen Super Stickern gehören. Die Definitionen der Eigenschaft liveChatMessage der Ressource snippet.superStickerDetails.superStickerMetadata.stickerId und der Eigenschaft superChatEvent der Ressource snippet.superStickerMetadata.stickerId wurden beide aktualisiert, um diese Informationen widerzuspiegeln.

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 können.

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

  • Das Intervall zwischen Mid-Roll-Werbeunterbrechungen
  • Planungsstrategie für Anzeigenreferenzpunkte. Cue-Punkte können für alle Betrachter gleichzeitig eingefügt werden oder das Timing der Cue-Punkte kann von Betrachter zu Betrachter variieren. Die letztere Strategie ermöglicht es YouTube, Cue-Punkte mit einer höheren Rate zu planen, sodass Zuschauer Cue-Punkte erhalten können, wenn sie dazu berechtigt sind.
  • Ein Zeitraum, in dem keine Mid-Roll-Anzeigen eingeblendet werden. Für diese Funktion gibt der Inhaber der Übertragung an, dass das Einfügen von Mid-Roll-Anzeigen bis zu einem bestimmten Zeitpunkt pausiert wird.

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

  • Die Ressource liveBroadcast enthält jetzt ein monetizationDetails-Objekt. Die Felder des Objekts geben an, ob die automatische Anzeigenbereitstellung für die Übertragung aktiviert ist, und geben zusätzliche Informationen zum Planen von Cue-Punkten an.
  • Der Parameter part der Methode liveBroadcast.list unterstützt den Wert monetizationDetails.
  • Mit der Methode update kannst du das Einfügen von Mid-Roll-Anzeigen für einen bestimmten Zeitraum in einer Liveübertragung pausieren. In der Dokumentation sind 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 Methode liveBroadcasts.update müssen keine Werte mehr für diese Felder angegeben werden:

    • snippet.title
    • status.privacyStatus

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

1. November 2022

  • Mit der neuen liveBroadcasts.cuepoint-Methode kann jeder Kanalinhaber, der eine Liveübertragung auf YouTube ausführt, in diese Übertragung Cue-Punkte einfügen, die Werbeunterbrechungen auslösen können. Diese Methode ersetzt die Methode liveCuepoints.insert, mit der nur YouTube-Contentpartner Cue-Punkte in Liveübertragungen einfügen konnten.

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

  • Hinweis: Diese Mitteilung wird verworfen.

    Die Methode liveCuepoints.insert wurde eingestellt. Die Unterstützung 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. Im September 2020 wurde für diese Methode ein Hinweis zur Einstellung dieser Methode veröffentlicht.

1. Oktober 2022

Dieses Update enthält die folgenden Änderungen:

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

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

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

  • Die Dokumentation für veraltete liveBroadcast-Felder wurde entfernt:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1. April 2022

Dieses Update enthält die folgenden Änderungen:

  • Das Attribut snippet.type unterstützt jetzt zwei neue Werte:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • Das neue Attribut snippet.membershipGiftingDetails der Ressource „liveChatMessage“ und ihre untergeordneten Elemente enthalten Informationen zum Ereignis „Verschenke eine Mitgliedschaft“. Analog dazu enthalten die neue snippet.giftMembershipReceivedDetails-Property und ihre untergeordneten Elemente Informationen zum Ereignis „Geschenk erhalten“.

15. September 2020

Dieses Update enthält die folgenden Änderungen:

  • Das Attribut snippet.type unterstützt jetzt zwei neue Werte:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • Das neue Attribut snippet.memberMilestoneChatDetails der Ressource „liveChatMessage“ und ihre untergeordneten Elemente enthalten Informationen zum Chatereignis für treue Mitglieder. Die neue snippet.newSponsorDetails-Property und ihre untergeordneten Properties enthalten ebenfalls Informationen zum Ereignis „Neuer Sponsor“.

1. Dezember 2020

Die Methode liveBroadcasts.transition der API unterstützt einen neuen 403-Fehler (Forbidden), der darauf hinweist, dass der Nutzer zu viele Anfragen innerhalb eines bestimmten Zeitraums gesendet hat. Die Fehlerursache ist userRequestsExceedRateLimit.

21. September 2020

  • Die Definition der Eigenschaft liveBroadcast der Ressource status.madeForKids wurde aktualisiert, um zu verdeutlichen, dass sie schreibgeschützt ist. Dies bedeutet nicht, dass sich die API-Funktionalität geändert hat.

    Wenn du eine Liveübertragung als auf Kinder ausgerichtet festlegen möchtest, musst du das Attribut status.selfDeclaredMadeForKids auf true setzen, wenn du zum Erstellen der Übertragung die Methode liveBroadcasts.insert aufrufst.

  • Hinweis:Diese Änderung enthält 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 der Fehler „Unzulässig“ (403) zurückgegeben und die Methode wird später vollständig entfernt. Kunden können trotzdem ihr eigenes SLA implementieren, indem sie dem Video, das an die Datenaufnahmeserver von YouTube gesendet wird, ein Overlay hinzufügen.

    Das ursprünglich für den 1. September 2020 geplante Einstellungsdatum der Ankündigung vom 16. April 2020 wurde nach hinten verschoben und gilt jetzt am oder nach dem 1. Oktober 2020. Daher werden die in dieser Einstellungsankündigung enthaltenen Features und die Methode liveBroadcasts.control gleichzeitig verworfen.

17. Juli 2020

Hinweis:Dies ist ein Update zu einer früheren Einstellungsankündigung.

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 weiterhin verwendet wird, schlagen ab diesem Datum fehl.

Wenn in Ihrem Code noch das Feld cdn.format verwendet wird, muss es aktualisiert werden, um die Framerate und die Auflösung separat mit den Attributen cdn.frameRate und cdn.resolution anzugeben.

6. Juli 2020

Der Leitfaden YouTube-Liveinhalte über HLS bereitstellen wurde mit einigen Änderungen aktualisiert:

  • Die empfohlene Dauer für ein Mediensegment wurde auf ein bis vier Sekunden aktualisiert.
  • In einem neuen Abschnitt wird erläutert, wie du eine HLS-Aufnahme-URL von YouTube Creator Studio abrufen kannst.
  • Eine Anleitung zum Formatieren des Parameterwerts file wurde in den neuen Abschnitt Completing the HLS Ingestion URL (HLS-Aufnahme-URL abschließen) verschoben. Diese Anleitung gilt unabhängig davon, ob die HLS-Aufnahme-URL aus der YouTube API oder aus YouTube Creator Studio stammt.

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

16. April 2020

Diese Aktualisierung umfasst eine neue Property und eine entsprechende Mitteilung:

  • Die Ressource liveBroadcast unterstützt jetzt das Attribut contentDetails.enableAutoStop. Die Eigenschaft gibt an, ob eine Übertragung automatisch etwa eine Minute, nachdem der Kanalinhaber das Videostreaming im gebundenen Videostream beendet hat, beendet werden soll.

    Die Lebensdauer einer Übertragungsdokument wurde aktualisiert. Es wird jetzt erklärt, wie sich der Schritt-für-Schritt-Prozess zum Erstellen und Verwalten einer Live-YouTube-Veranstaltung ändert, wenn du die Properties contentDetails.enableAutoStart oder contentDetails.enableAutoStop auf true setzt.

  • Hinweis: Diese Mitteilung wird verworfen. 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 Einstellungsdatum bezeichnet.

    In diesem Update wird eine möglicherweise funktionsgefährdende Änderung erläutert. Sie wirkt sich auf API-Clientanwendungen aus, die die standardmäßigen liveStream- und liveBroadcast-Ressourcen der Kanäle zum Streamen von Liveinhalten auf YouTube verwenden. Insbesondere die Broadcast-ID und die Stream-ID, die dem nichtflüchtigen Broadcast und dem Stream zugeordnet sind, können keine neuen Broadcasts mehr starten.

    Ihre Anwendung ist betroffen, wenn einer der folgenden Punkte zutrifft:

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

    Zur Erinnerung: YouTube hat in den letzten Jahren automatisch einen Standardstream und eine Standardübertragung für einen Kanal erstellt, wenn Livestreaming für diesen Kanal aktiviert wurde. Der Standardstream existierte auf unbestimmte Zeit, ihm war keine Start- oder Endzeit zugewiesen und er konnte nicht gelöscht werden. Die Standardübertragung wurde ebenfalls als dauerhaft eingestuft. Er existierte schon immer und war nicht an eine bestimmte Veranstaltung gebunden.

    Ab dem Einstellungsdatum:

    • YouTube erstellt keine Standardstreams und -übertragungen mehr. Anstatt sich auf die Standardressourcen zu verlassen, müssen API-Clients liveBroadcast- und liveStream-Ressourcen erstellen und verwalten und diese Ressourcen aneinander binden.
    • Wenn die Standardübertragung und der Standardstream eines Kanals aktiv sind, d. h., der Kanal verwendet diese Inhalte zu dem Zeitpunkt, an dem die Einstellung in Kraft tritt, für eine Liveübertragung verwendet wird, hat dies keine Auswirkungen auf die laufende Übertragung. Nach dem Ende der Übertragung kann der Kanal jedoch die Standardübertragung und den Standardstream nicht mehr verwenden.
    • Wenn die Standardübertragung und der Standardstream eines Kanals nicht aktiv sind, ignoriert YouTube nach dem Inkrafttreten der Einstellung Versuche, diese Ressourcen für die Videoübertragung zu verwenden.

    Falls 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 einer neuen Migrationsanleitung werden die Schritte erläutert, die Entwickler möglicherweise in API-Clients ausführen müssen, die derzeit Standard-Broadcasts und -Streams verwenden.
    • Im Leitfaden Das Leben einer Übertragung erfährst du Schritt für Schritt, wie du eine Live-Veranstaltung auf YouTube erstellst und verwaltest. In jedem Schritt werden die API-Aufrufe oder andere Schritte erläutert, die Sie zum Ausführen einer bestimmten Aktion ausführen müssen. Diese Vorgehensweise wird in Ihrer Anwendung ausgeführt, wenn YouTube Standardstreams und -übertragungen nicht mehr unterstützt.

31. März 2020

Hinweis: Diese Mitteilung wird verworfen.

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

Die Methode sponsors.list wird ab dem 30. September 2020 nicht mehr unterstützt. API-Clients sollten Aufrufe an die Methode sponsors.list aktualisieren, um stattdessen die Methode members.list zu verwenden. Weitere Informationen zu dieser neuen Ressource findest du im Überarbeitungsverlauf der YouTube Data API.

11. März 2020

Der Abschnitt Aufnahmeendpunkt des Leitfadens Liveinhalte von YouTube-Inhalten über HLS bereitstellen wurde aktualisiert, um den Prozess zu verdeutlichen, mit dem ein Encoder beim Erstellen der primären und Backup-Aufnahme-URLs den Parameterwert file= vervollständigen sollte.

4. Februar 2020

Der Leitfaden Live-YouTube-Inhalte über HLS bereitstellen wurde aktualisiert. Er enthält jetzt einen Hinweis, dass DELETE-Anfragen optional sind und vom HLS-Endpunkt von YouTube ignoriert werden. Aus Leistungsgründen empfiehlt YouTube Clients, keine DELETE-Anfragen zu senden.

10. Januar 2020

Die API unterstützt jetzt die Identifizierung von Inhalten, die auf Kinder ausgerichtet sind. Dies wird von YouTube als „speziell für Kinder“ bezeichnet. Weitere Informationen zu Inhalten speziell für Kinder findest du in der YouTube-Hilfe.

  • Die Ressource liveBroadcast unterstützt zwei neue Properties, mit denen Inhaltsersteller und Zuschauer Inhalte speziell für Kinder kennzeichnen können:
    • Mit der Property selfDeclaredMadeForKids können Creator angeben, ob eine Liveübertragung auf Kinder ausgerichtet ist. Dieses Attribut kann beim Erstellen einer Übertragung über die Methode liveBroadcasts.insert festgelegt werden. Dieses Attribut ist nur dann in API-Antworten mit liveBroadcast-Ressourcen enthalten, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
    • Mit der Property madeForKids kann jeder API-Nutzer den Status „Speziell für Kinder“ einer Übertragung abrufen. Der Status kann beispielsweise anhand des Werts der Property 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.

Außerdem haben wir die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen findest du in den Nutzungsbedingungen für die YouTube API-Dienste – Überarbeitungsverlauf. Die Änderungen an den Nutzungsbedingungen und Richtlinien für Entwickler der YouTube API-Dienste treten am 10. Januar 2020 (UTC -8) in Kraft.

20. August 2019

Der Abschnitt Anforderungen des Leitfadens Liveinhalte auf YouTube über HLS wurde in zweierlei Hinsicht aktualisiert:

  • Darin wird erläutert, dass es sich bewährt hat, sowohl anerkannte als auch herausragende Segmente in jede Medienplaylist aufzunehmen. Dadurch sinkt die Wahrscheinlichkeit, dass ein Segment übersprungen wird, wenn serverseitig eine Medienplaylist verloren geht. Du kannst beispielsweise bis zu zwei bestätigte Segmente und bis zu fünf herausragende Segmente in jede Medienplaylist aufnehmen.
  • Nun muss für jedes Mediensegment eine Medienplaylist gesendet werden. So kann der Server schnell wiederhergestellt werden, falls eine Medienplaylist verloren geht. Diese Vorgehensweise wurde zuvor als Empfehlung aufgeführt.

28. Juni 2019

YouTube unterstützt jetzt die HLS-Datenaufnahme. Entsprechend unterstützt das Attribut ingestionType der Ressource liveStream den neuen Wert hls, um Streams zu identifizieren, die über HLS in YouTube aufgenommen wurden.

Der neue Leitfaden Liveinhalte auf YouTube über HLS bereitstellen enthält Richtlinien für die Verwendung von HLS, um Liveinhalte über einen Encoder auf YouTube zu streamen. Der Leitfaden soll Encoderanbietern helfen, ihren Produkten HLS-Übermittlungsunterstützung hinzuzufügen.

4. April 2019

Dieses Update enthält die folgenden Änderungen:

  • Die API-Referenzdokumentation wurde aktualisiert, um häufige 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. Es gibt jetzt zwei neue Elemente auf Seiten, die API-Methoden beschreiben:

    • Mit dem APIs Explorer-Widget können Sie Autorisierungsbereiche auswählen, Beispielparameter und Eigenschaftswerte eingeben, dann tatsächliche API-Anfragen senden und die tatsächlichen 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 gängige Anwendungsfälle für die auf der Seite erläuterte Methode beschrieben. Du kannst beispielsweise die Methode liveBroadcasts.list aufrufen, um Daten zu einer bestimmten Übertragung oder Daten zu den Übertragungen 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 sehen, 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.

  • Auch die Seite Codebeispiele hat eine neue Benutzeroberfläche, die dieselben Funktionen bietet, die oben beschrieben wurden. 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 abzurufen.

    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 zu den 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 von Super Chat-Nachricht, in der ein Bild angezeigt wird. Genau wie andere Super Chats kauft ein Fan während eines YouTube-Livestreams eine Super Sticker-Nachricht.

  • In einer liveChatMessage-Ressource ist das Attribut snippet.type jetzt auf superStickerEvent gesetzt, um anzuzeigen, dass die Ressource Informationen zu einem Super Sticker enthält. In diesem Fall enthält die Ressource auch das Objekt snippet.superStickerDetails, das zusätzliche Informationen zum Super Sticker enthält.
  • In einer superChatEvent-Ressource gibt der boolesche snippet.isSuperStickerEvent-Wert an, ob die Super Chat-Nachricht auch ein Super Sticker ist. In diesem Fall 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 fanFundingEvents nicht mehr enthält. Diese wurden Anfang 2017 eingestellt.

3. April 2017

Es wurden neue Java-Codebeispiele hinzugefügt, die zeigen, wie Livechat-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:

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Die Methode liveCuepoints.insert wurde aktualisiert, um die Tatsache zu berücksichtigen, dass der Parameter onBehalfOfContentOwner derzeit erforderlich ist. Außerdem wurde die Beschreibung der Methode aktualisiert, um zu verdeutlichen, dass Aufrufe an diese 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:

  • Änderungen an vorhandenen Ressourcen und Methoden

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

      Der Parameterwert muss ein Sprachcode sein, der in der Liste enthalten ist, die von der Methode i18nLanguages.list zurückgegeben wird. Der Standardwert ist en. Das bedeutet, dass Anzeigestrings standardmäßig so formatiert werden, wie sie auf Englisch verwendet werden würden. Ein String hat beispielsweise standardmäßig das Format $1.00 und nicht $1,00.

1. Februar 2017

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Die neue superChatEvent-Ressource steht für eine Super Chat-Nachricht, die ein Fan während eines YouTube-Livestreams gekauft hat. Im Livechat auf YouTube können sich Super Chats von anderen Nachrichten auf zwei Arten abheben:

      • 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 der letzten 30 Tage. Diese Methode gibt auch Daten zu Ereignissen im Zusammenhang mit der Finanzierung durch Fans (fanFundingEvents) aus dem letzten Livestream des Kanals zurück.

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Die Property 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 den Fehler 400 (Bad Request) zurück, um anzugeben, dass die eingefügte oder aktualisierte Ressource liveBroadcast 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: Diese Mitteilung wird verworfen.

In Zusammenhang mit der Veröffentlichung der neuen Super Chat-Funktion hat YouTube die Funktion zur Finanzierung durch Fans eingestellt und 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 der YouTube API-Dienste („Aktualisierte Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich erörtert werden, enthalten zahlreiche Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält diese Aktualisierung mehrere Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

    Die vollständigen neuen Dokumente finden Sie im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen. Außerdem werden künftige Änderungen der aktualisierten Nutzungsbedingungen oder dieser ergänzenden Dokumente im Überarbeitungsverlauf erläutert. Über einen Link in diesem Dokument können Sie einen RSS-Feed abonnieren, in dem Änderungen im Überarbeitungsverlauf aufgeführt sind.

20. Mai 2016

YouTube unterstützt jetzt die DASH-Datenaufnahme. Entsprechend unterstützt das Attribut ingestionType der Ressource liveStream den neuen Wert dash, um Streams zu identifizieren, die mithilfe von DASH in YouTube aufgenommen wurden.

Der neue Leitfaden Live-YouTube-Inhalte über DASH bereitstellen enthält Richtlinien für die Verwendung des DASH-Übermittlungsformats zum Streamen von Livedaten auf YouTube über einen Encoder. Sie soll Encoder-Anbietern dabei helfen, ihren Produkten DASH-Lieferungssupport hinzuzufügen.

18. April 2016

Dieses Update enthält die folgenden Änderungen:

  • Änderungen an vorhandenen Ressourcen und Methoden

    • liveStream-Ressourcenupdates

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

        Darüber hinaus enthält die Ressource liveStream neue Eigenschaften zur Angabe der Framerate 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 Attributwerte sind 1440p, 1080p, 720p, 480p, 360p und 240p.

      • Gemäß der Einführung der Attribute cdn.frameRate und cdn.resolution der Ressource liveStream wurde das cdn.format der Ressource verworfen. 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 aktuell erfolgreich, sofern du Werte für die Property cdn.format oder die Properties cdn.frameRate und cdn.resolution angibst. Wenn Sie Werte für alle drei Eigenschaften angeben, gibt die API möglicherweise einen Fehler zurück, falls die Werte nicht übereinstimmen.

        Das Attribut cdn.format wurde zwar eingestellt, unterstützt jetzt aber die beiden neuen Werte 1440p und 1440p_hfr, die angeben, dass die API 1440p-Streams mit 30 oder 60 Bildern pro Sekunde unterstützt.

    • liveBroadcast-Ressourcenupdates

      • 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 der Übertragung verwiesen wird.
        contentDetails.projection Das Projektionsformat der Übertragung. Der Standardwert des Attributs ist rectangular. Gültige Werte für das Attribut sind 360 und rectangular.

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

    • liveChatMessage-Ressourcenupdates

      • Das Attribut snippet.type unterstützt zwei neue Werte – messageDeletedEvent und userBannedEvent –, die den neuen Eigenschaften 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 Mitteilungstypen 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 über einen Nutzer, der für die Teilnahme am Chat gesperrt wurde. Das -Objekt enthält auch Informationen über die Sperre selbst, z. B. ob die Sperre dauerhaft oder vorübergehend ist. Wenn das Verbot nur vorübergehend ist, gibt eine der Objekteigenschaften die Dauer der Sperre an.

        Dieses Objekt ist nur vorhanden, wenn der Attributwert 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 anzuzeigen, dass der Nutzer zu viele Anfragen innerhalb eines bestimmten Zeitraums gesendet hat. Die Fehlerursache ist userRequestsExceedRateLimit.

      Die Methoden liveBroadcasts.insert und liveBroadcasts.update unterstützen denselben Fehler bereits.
      liveStreams.insert Die Methode liveStreams.insert unterstützt vier neue 400-Fehler (Bad Request), die einen ungültigen Attributwert in der Ressource liveStream identifizieren, den die Anfrage einfügen wollte. In der folgenden Liste sind die Fehlerursachen und die zugehörigen Attribute aufgeführt:
      liveStreams.insert Die Methode liveStreams.insert unterstützt zwei neue Fehler vom Typ 400 (Bad Request), die jeweils darauf hinweisen, dass in der Ressource liveStream, die in der Anfrage eingefügt werden soll, kein erforderlicher Wert vorhanden ist. In der folgenden Liste sind die Fehlerursachen und die zugehörigen Attribute aufgeführt:
      Genauer gesagt müssen Sie beim Einfügen einer liveStream-Ressource einen Wert für das Attribut cdn.format oder für die Attribute cdn.frameRate und cdn.resolution angeben.
      • Die API gibt den Fehler formatRequired zurück, wenn Sie für keines der drei Attribute einen Wert angeben.
      • Die API gibt den Fehler frameRateRequired zurück, wenn Sie für cdn.resolution einen Wert angeben, aber nicht für cdn.frameRate.
      • Die API gibt den Fehler resolutionRequired zurück, wenn Sie für cdn.frameRate einen Wert angeben, aber nicht für cdn.resolution.
      liveStreams.update Die Methode liveStreams.update gibt den Fehler 403 (Forbidden) zurück, wenn mit der Anfrage versucht wird, den Wert eines der folgenden nicht änderbaren Attribute 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 Einwilligungen von Endnutzern eingeholt werden. Für Endnutzer in der Europäischen Union müssen Sie daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Einen entsprechenden Hinweis finden Sie in den Nutzungsbedingungen für die YouTube API.

17. Dezember 2015

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Die API unterstützt verschiedene neue Ressourcen für die Chatfunktion bei Liveübertragungen. 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 steht für eine Nachricht in einem YouTube-Livechat. YouTube unterstützt verschiedene Arten von Mitteilungen, darunter SMS und Ereignisse zur Finanzierung durch Fans. Einige Nachrichtentypen beziehen sich auf eine bestimmte Phase des Chats, z. B. den Beginn einer Phase nur für Unterstützer oder das Ende des Chats. Die API unterstützt Methoden zum Auflisten, Einfügen und Löschen von Nachrichten im Livechat.
      liveChatModerators Diese Ressource identifiziert einen Chatmoderator. Moderatoren können einige administrative Aufgaben ausführen, z. B. Nutzer für den Chat sperren oder Nachrichten entfernen. Die API unterstützt Methoden zum Auflisten, Einfügen und Löschen von Livechat-Moderatoren.
      liveChatBans Diese Ressource identifiziert einen Nutzer, der keine Nachrichten in einem bestimmten Livechat posten darf. Sperrungen können vorübergehend oder dauerhaft sein. Die API unterstützt Methoden zum Einfügen und Löschen von Livechat-Sperren.
      fanFundingEvents Diese Ressource steht für eine Veranstaltung zur Finanzierung durch Fans auf einem YouTube-Kanal. Die Finanzierung durch Fans bietet Zuschauern die Möglichkeit, YouTube-Creator mit einmaliger finanzieller Unterstützung freiwillig zu unterstützen.

      Mit der API-Methode fanFundingEvents.list werden die Ereignisse zur Finanzierung durch Fans für einen Kanal aufgelistet. Ereignisse zur Finanzierung durch Fans, die während einer Liveübertragung des Kanals über einen Livechat gestartet werden, lösen ebenfalls eine fanFundingEvent-Nachricht im Livechat der Übertragung aus.

      Weitere Informationen zur Finanzierung durch Fans findest du in der YouTube-Hilfe.
      sponsors Die Ressource sponsor identifiziert einen Sponsor eines YouTube-Kanals. Ein Unterstützer zahlt eine monatliche Gebühr an einen Kanal. Neben den Nachrichten des Unterstützer wird im Livechat des Kanals ein Badge angezeigt. Unterstützer können außerdem an Livechats ausschließlich für die Unterstützer des Kanals teilnehmen, sofern solche vorhanden sind.

      Mit der API-Methode sponsors.list werden die Unterstützer eines Kanals aufgelistet. Wenn sich Nutzer während einer Liveübertragung, die zu diesem Kanal gehört, als Unterstützer für einen Kanal registrieren, fügt die API außerdem eine newSponsorEvent-Nachricht im Livechat der Übertragung hinzu.

      Weitere Informationen zum Unterstützer-Status findest du in der YouTube-Hilfe.

  • Änderungen an vorhandenen Ressourcen und Methoden

    • Die Ressource liveBroadcast 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. Du kannst auch Chatmoderatoren hinzufügen oder entfernen, Nutzer von der Teilnahme an Livechats ausschließen oder bestehende Sperrungen entfernen.
      contentDetails.closedCaptionsType Hinweis: Diese Property ersetzt die contentDetails.enableClosedCaptions-Property.

      Diese Property gibt an, ob Untertitel für deine Übertragung aktiviert sind und welche Art von Untertiteln du gegebenenfalls anbietest:
      • closedCaptionsDisabled: Untertitel sind für die Liveübertragung deaktiviert.
      • closedCaptionsHttpPost: Du sendest Untertitel per HTTP POST an eine Aufnahme-URL, die mit deinem Livestream verknüpft ist.
      • closedCaptionsEmbedded: Untertitel werden im Videostream im Format EIA-608 und/oder CEA-708 codiert.
      contentDetails.enableClosedCaptions Diese Property wurde am 17. Dezember 2015 eingestellt. Verwende stattdessen das Attribut contentDetails.closedCaptionsType. Für API-Clients, die dieses Attribut bereits verwenden:
      • Das Festlegen des Attributwerts auf true entspricht dem Festlegen des Attributs contentDetails.closedCaptionsType auf closedCaptionsHttpPost.
      • Das Festlegen des Attributwerts auf false entspricht dem Festlegen des Attributs contentDetails.closedCaptionsType auf closedCaptionsDisabled.

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

      Eine dauerhafte Übertragung existiert immer und ist nicht an ein bestimmtes Ereignis gebunden. Die Standardübertragung eines Kanals ist eine dauerhafte Übertragung und kann über das Live-Dashboard in YouTube Studio aufgerufen werden. Bei den anderen Übertragungen des Kanals handelt es sich um Broadcasts von Veranstaltungen.

  • Im Feld status.healthStatus.configurationIssues[].type der Ressource liveStream werden die folgenden neuen Systemstatusfehler 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 weniger ein.

  • Das Veröffentlichungsdatum der vorherigen Dokumentationsaktualisierung wurde korrigiert.

  • Neue und aktualisierte Fehler

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

      Fehlerdetails
      liveBroadcasts.update
      HTTP-Antwortcodeforbidden (403)
      GrundclosedCaptionsTypeModificationNotAllowed
      BeschreibungDer Wert für contentDetails.closedCaptionsType kann nur geändert werden, wenn die Übertragung den Status created oder ready hat.
      liveBroadcasts.update
      HTTP-AntwortcodeinvalidValue (400)
      GrundinvalidEnableClosedCaptions
      BeschreibungIn der liveBroadcast-Ressource ist der Wert des Attributs contentDetails.enableClosedCaptions nicht mit dem Wert der Einstellung contentDetails.closedCaptionType kompatibel. Ändern Sie die Ressource so, dass sie nur eine der beiden Eigenschaften enthält, und reichen Sie die Anfrage dann noch einmal ein.

19. August 2015

Dieses Update enthält die folgenden Änderungen:

  • Neue Ressourcen und Methoden

    • Hinweis: Die Dokumentation für die Ressource liveChat 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 Livechat-Nachrichten für eine Übertragung auflisten
      liveChats.insert Erstellen Sie eine neue Chatnachricht.

      Chatnachrichten können nur während einer laufenden Übertragung abgerufen und gepostet werden.

  • Änderungen an vorhandenen 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 existiert auf unbestimmte Zeit, hat weder eine Start- noch ein Ende 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 die Qualität eines Live-Videostreams beurteilen können.

      Im Objekt status.healthStatus.configurationIssues[] werden insbesondere 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 Broadcasts gebunden sein kann. Üblicherweise verwenden Sender denselben Stream für viele verschiedene Übertragungen, wenn diese zu unterschiedlichen Zeiten stattfinden.

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

      Attribute
      snippet.isDefaultBroadcast Gibt an, ob diese Übertragung die Standardübertragung für den Kanal ist. Wenn Livestreaming für einen YouTube-Kanal aktiviert ist, erstellt YouTube einen Standardstream und eine Standardübertragung für den Kanal. Mit dem Stream wird festgelegt, wie der Kanalinhaber ein Live-Video an YouTube sendet, und die Übertragung bestimmt, 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 Streaming mit niedriger Latenz codiert werden soll. Ein Stream mit niedriger Latenz kann die Zeit reduzieren, bis das Video für Nutzer sichtbar ist, die sich eine Übertragung ansehen. Es kann aber auch die Auflösung für die Zuschauer des Streams beeinträchtigen.
      statistics.totalChatCount Die Gesamtzahl der mit der Übertragung verknüpften Livechat-Nachrichten. Die Eigenschaft und ihr Wert sind vorhanden, wenn die Übertragung für den Nutzer sichtbar ist und die Livechat-Funktion aktiviert ist. Beachten Sie, dass mit dieser Eigenschaft nach dem Ende der Übertragung kein Wert angegeben wird. Diese Property würde also nicht die Anzahl der Chatnachrichten für ein archiviertes Video einer abgeschlossenen Liveübertragung ermitteln.

  • Neue und aktualisierte Fehler

    • Zusätzlich zu den Fehlern, die für die neue liveChat-Ressource definiert wurden, 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 oder umgekehrt. Weitere Informationen findest du unter Informationen zu Broadcasts und Streams.

21. Mai 2015

Dieses Update enthält die folgenden Änderungen:

  • YouTube unterstützt jetzt Live-Videostreaming mit 60 Bildern pro Sekunde (fps), was eine reibungslosere Wiedergabe für Gaming- und andere schnelle Videos ermöglicht. Wenn du einen Livestream auf YouTube mit 60 fps startest, stellt YouTube den Stream auf Geräten, auf denen noch keine hohe Framerate verfügbar ist, mit 30 fps zur Verfügung.

    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 Creators-Blog.

21. August 2014

Dieses Update enthält die folgenden Änderungen:

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

  • Die API unterstützt jetzt die folgenden Fehler:

    Fehlertyp Fehlerdetails Beschreibung
    insufficientPermissions liveStreamingNotEnabled Bei allen Methoden für die Ressourcen liveBroadcast und liveStream wird dieser Fehler zurückgegeben, wenn der Nutzer, der die API-Anfrage autorisiert hat, das Streamen von Livevideos auf YouTube nicht aktiviert hat. Details dazu, warum der Nutzer kein Livevideo streamen 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 anzuzeigen, dass der Nutzer zu viele Anfragen innerhalb eines bestimmten Zeitraums gesendet hat.

2. Mai 2014

Dieses Update enthält die folgenden Änderungen:

  • Die Beschreibungen der liveStream-Ressource und der liveBroadcasts.bind-Methode wurden aktualisiert, um zu verdeutlichen, dass eine Übertragung nur an einen Videostream gebunden werden kann, während ein Videostream an mehrere Übertragungen gebunden werden kann. Dabei handelt es sich lediglich um eine Korrektur der Dokumentation. Die zugrunde liegende API-Funktionalität hat sich nicht geändert.

  • Das Attribut contentDetails.monitorStream.enableMonitorStream der liveBroadcast-Ressource wurde aktualisiert. Wenn der Wert des Attributs true lautet, musst du deine Übertragung in den testing-Status umwandeln, bevor du sie in den live-Status umwandeln kannst. Wenn der Wert des Attributs false lautet, darf deine Übertragung keine testing-Phase haben, sodass du die Übertragung direkt in den live-Status umwandeln kannst.

  • Das Attribut settings.offsetTimeMs der Ressource liveCuepoint wurde aktualisiert. Du solltest keinen Wert für das Attribut angeben, wenn deine Übertragung keinen Überwachungsstream hat.

  • Alle Methoden für die Ressourcen liveBroadcast und liveStream unterstützen jetzt die Parameter onBehalfOfContentOwner und onBehalfOfContentOwnerChannel. Mit diesen Parametern kannst du dieselben Anmeldedaten für die Autorisierung verwenden, um API-Anfragen für verschiedene Kanäle durchzuführen, die mit demselben Rechteinhaber verknüpft sind.

  • Die Dokumentation der Methode liveCuepoints.insert wurde aktualisiert. Sie können jetzt einen Wert für das Attribut settings.walltime festlegen, wenn Sie die Methode aufrufen.

  • 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 Bei den Methoden liveBroadcasts.insert, liveBroadcasts.transition und liveStreams.insert wird dieser Fehler zurückgegeben, wenn der Nutzer, der die Anfrage autorisiert hat, kein Livevideo auf YouTube streamen kann. Details dazu, warum der Nutzer kein Livevideo streamen kann, sind möglicherweise in den Kanaleinstellungen des Nutzers unter https://www.youtube.com/features verfügbar.

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

13. Dezember 2013

Dieses Update enthält die folgenden Änderungen:

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

  • Die neue contentDetails.enableClosedCaptions-Eigenschaft der liveBroadcast-Ressource gibt an, ob Untertitel für die Übertragung aufgenommen werden können. Der Attributwert kann festgelegt werden, wenn Sie eine Übertragung einfügen oder aktualisieren. Er kann jedoch nicht mehr aktualisiert werden, sobald sich die Übertragung im Status testing oder live befindet. Wenn du dieses Attribut auf true setzt, gibt die liveStream-Ressource, die an die Übertragung gebunden ist, die Aufnahme-URL an, die für die Untertitel der Übertragung verwendet werden soll.

  • Das Attribut snippet.scheduledEndTime der Ressource „liveBroadcast“ unterstützt jetzt Übertragungen, die so geplant sind, dass sie auf unbestimmte Zeit fortgesetzt werden. Durch diese Änderung ist die Property in liveBroadcasts.insert- und liveBroadcasts.update-Anfragen nicht mehr erforderlich.

    Wenn Sie eine liveBroadcast-Ressource abrufen, die keinen Wert für dieses Attribut angibt, wird die Übertragung auf unbestimmte Zeit fortgesetzt. Wenn Sie die Methode liveBroadcasts.insert oder liveBroadcasts.update aufrufen und keinen Wert für dieses Attribut angeben, wird die Übertragung auf unbestimmte Zeit fortgesetzt.

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

    Wenn dein Kanal keine Berechtigung zum Deaktivieren von Aufzeichnungen hat und du versuchst, eine Übertragung einzufügen, bei der die Eigenschaft recordFromStart auf false gesetzt ist, 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 zu setzen, gibt die API den Fehler modificationNotAllowed zurück.

  • Die Ressource liveBroadcast enthält keine enableArchive-Property mehr, die in den Beschreibungen der contentDetails.enableDvr- und contentDetails.enableEmbed-Properties 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 jedes Status.

  • Die neue settings.walltime-Eigenschaft der liveCuepoint-Ressource gibt das Datum und die Uhrzeit an, zu der der Cue-Punkt eingefügt werden soll. Die API gibt einen Fehler zurück, wenn eine Anfrage versucht, einen Cue-Punkt einzufügen, der einen Wert für dieses Attribut und für das Attribut 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. Damit wird die Aufnahme-URL für Untertitel angegeben, die mit dem Videostream verknüpft sind.

  • Die Liste der gültigen Werte für das Attribut status.streamStatus der Ressource liveStream wurde aktualisiert und enthält jetzt eine Beschreibung jedes Status.

  • Mit dem neuen Parameter walltime der Methode liveBroadcasts.control können Sie das Datum und die Uhrzeit für eine Slate-Änderung 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 wird.

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

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

  • Die Eigenschaft eventId wurde von liveBroadcastListResponse und liveStreamListResponse eingestellt.

  • 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 Sie versuchen, den Wert contentDetails.enableClosedCaptions zu aktualisieren, und der Übertragungsstatus nicht created oder ready lautet.
    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. Eine Anfrage kann entweder beide Attribute weglassen oder einen Wert für eines der beiden Attribute angeben.

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

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 wurden an der Ressource liveBroadcast geändert:

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

  • Die API unterstützt das Einfügen von In-Stream-Slates mit der Methode liveCuepoints.insert nicht mehr. Die folgenden Dokumente wurden zur Berücksichtigung dieser Änderung aktualisiert:

    • Auf der Indexseite, im Leitfaden Erste Schritte und in der Anleitung Life of a Broadcast wird diese Funktion nicht mehr erwähnt.

    • Das Attribut settings.cueType der Ressource liveCuepoint unterstützt slate nicht mehr als Attributwert. Der einzige unterstützte Wert ist ad.

    • Das Attribut settings.eventState der Ressource liveCuepoint wurde eingestellt und aus der Dokumentation entfernt.

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 bieten.

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

    • liveBroadcasts.insert: Das geplante Ende einer Übertragung muss nach dem geplanten Beginn liegen.
    • liveBroadcasts.insert: Die Übertragung weist einen ungültigen Datenschutzstatus auf.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für das Attribut contentDetails.enableArchive oder legt keinen Wert fest.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für das Attribut contentDetails.enableContentEncryption oder legt keinen Wert fest.
    • liveBroadcasts.update: Die Ressource enthält keinen Wert für das Attribut contentDetails.enableDvr oder legt keinen Wert fest.
    • liveStreams.insert: Der Snippet-Titel muss zwischen 1 und 128 Zeichen lang sein.
    • liveStreams.update: Die Ressource enthält keinen Wert für das Attribut snippet.title oder legt keinen Wert fest.

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