Auf dieser Seite werden Änderungen an der YouTube Live Streaming API und Aktualisierungen der Dokumentation aufgeführt. Dieses Änderungsprotokoll 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 einmonetizationDetails
-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 MethodeliveBroadcast.list
unterstützt den WertmonetizationDetails
. - 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 MethodeliveCuepoints.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 MethodeliveCuepoints.insert
wird am oder nach dem 1. Mai 2023 eingestellt. API-Nutzer sollten ihre Anwendungen so aktualisieren, dass stattdessen die MethodeliveBroadcasts.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 neuesnippet.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 neuesnippet.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 Ressourcestatus.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
auftrue
setzen, wenn du zum Erstellen der Übertragung die MethodeliveBroadcasts.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 AttributcontentDetails.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
odercontentDetails.enableAutoStop
auftrue
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
- undliveBroadcast
-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 RessourceisDefaultBroadcast
. Diese Eigenschaft wird nach dem Einstellungsdatum nicht mehr zurückgegeben. - Sie prüft den Wert der Eigenschaft
liveStream
der RessourceisDefaultStream
. Diese Eigenschaft wird nach dem Einstellungsdatum nicht mehr zurückgegeben. - Sie ruft die Methode
liveBroadcasts.list
auf und legt den Wert des ParametersbroadcastType
aufpersistent
oderall
fest. Dieser Parameter wird im Rahmen dieser Änderungen verworfen. Ab dem Einstellungsdatum:- Wenn der Wert des Parameters
broadcastType
aufpersistent
gesetzt ist, gibt die MethodeliveBroadcasts.list
keine Ergebnisse zurück. - Wenn der Parameterwert
broadcastType
aufall
gesetzt ist, gibt die MethodeliveBroadcasts.list
keine persistenten Broadcasts zurück, die vor diesem Zeitpunkt vorhanden waren.
- Wenn der Wert des Parameters
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
- undliveStream
-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.
- Sie prüft den Wert der Eigenschaft
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 MethodeliveBroadcasts.insert
festgelegt werden. Dieses Attribut ist nur dann in API-Antworten mitliveBroadcast
-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 PropertyselfDeclaredMadeForKids
bestimmt werden. Weitere Informationen zum Festlegen der Zielgruppe für deinen Kanal, deine Videos oder deine Übertragungen findest du in der YouTube-Hilfe.
-
Mit der Property
-
In der YouTube Data API unterstützt die Ressource
channel
auch die neuen PropertiesselfDeclaredMadeForKids
undmadeForKids
.
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 Attributsnippet.type
jetzt aufsuperStickerEvent
gesetzt, um anzuzeigen, dass die Ressource Informationen zu einem Super Sticker enthält. In diesem Fall enthält die Ressource auch das Objektsnippet.superStickerDetails
, das zusätzliche Informationen zum Super Sticker enthält. - In einer
superChatEvent
-Ressource gibt der booleschesnippet.isSuperStickerEvent
-Wert an, ob die Super Chat-Nachricht auch ein Super Sticker ist. In diesem Fall enthält dassnippet.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 ParameteronBehalfOfContentOwner
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 MethodesuperChatEvents.list
können Sie angeben, dass der Attributwertsnippet.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 isten
. 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 WertsuperChatEvent
, 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 RessourceliveStream
unterstützt jetzt den Wert2160p
.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt die folgenden neuen Fehler:
Fehlerdetails liveBroadcasts.insert
,liveBroadcasts.update
Die Methoden liveBroadcasts.insert
undliveBroadcasts.update
geben den Fehler400
(Bad Request
) zurück, um anzugeben, dass die eingefügte oder aktualisierte RessourceliveBroadcast
einen ungültigen Wert für das AttributcontentDetails.enableEmbed
oder das AttributcontentDetails.projection
enthält. Die Fehlerursachen für die beiden neuen Fehler sindinvalidEmbedSetting
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:
- Die Methode
liveChatMessages.list
gibt keine Nachrichten mit demsnippet.type
mehrfanFundingEvent
zurück. Ebenso enthaltenliveChatMessage
-Ressourcen dassnippet.fanFundingEventDetails
-Objekt nicht mehr. - Die Methode
fanFundingEvents.list
gibt keine Daten mehr zurück.
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
und60fps
.cdn.resolution
Die Auflösung der eingehenden Videodaten. Gültige Attributwerte sind 1440p
,1080p
,720p
,480p
,360p
und240p
. -
Gemäß der Einführung der Attribute
cdn.frameRate
undcdn.resolution
der RessourceliveStream
wurde dascdn.format
der Ressource verworfen. Mit der Eigenschaftcdn.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 Propertycdn.format
oder die Propertiescdn.frameRate
undcdn.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 Werte1440p
und1440p_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 sind360
undrectangular
. -
Die Definition des Attributs
statistics.totalChatCount
derliveBroadcast
-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
unduserBannedEvent
–, die den neuen Eigenschaften entsprechen, die im folgenden Aufzählungspunkt beschrieben werden. Die Definition des Attributssnippet.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 Attributwertsnippet.type
userBannedEvent
ist.
-
-
Neue und aktualisierte Fehler
-
Die API unterstützt die folgenden neuen Fehler:
Fehlerdetails liveBroadcasts.bind
Die Methode liveBroadcasts.bind
gibt den Fehler403
(Forbidden
) zurück, um anzuzeigen, dass der Nutzer zu viele Anfragen innerhalb eines bestimmten Zeitraums gesendet hat. Die Fehlerursache istuserRequestsExceedRateLimit
.
Die MethodenliveBroadcasts.insert
undliveBroadcasts.update
unterstützen denselben Fehler bereits.liveStreams.insert
Die Methode liveStreams.insert
unterstützt vier neue400
-Fehler (Bad Request
), die einen ungültigen Attributwert in der RessourceliveStream
identifizieren, den die Anfrage einfügen wollte. In der folgenden Liste sind die Fehlerursachen und die zugehörigen Attribute aufgeführt:
invalidFormat
:cdn.format
invalidFrameRate
:cdn.frameRate
invalidIngestionType
:cdn.ingestionType
invalidResolution
:cdn.resolution
liveStreams.insert
Die Methode liveStreams.insert
unterstützt zwei neue Fehler vom Typ400
(Bad Request
), die jeweils darauf hinweisen, dass in der RessourceliveStream
, 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:
frameRateRequired
:cdn.frameRate
resolutionRequired
:cdn.resolution
liveStream
-Ressource einen Wert für das Attributcdn.format
oder für die Attributecdn.frameRate
undcdn.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ürcdn.resolution
einen Wert angeben, aber nicht fürcdn.frameRate
. - Die API gibt den Fehler
resolutionRequired
zurück, wenn Sie fürcdn.frameRate
einen Wert angeben, aber nicht fürcdn.resolution
.
liveStreams.update
Die Methode liveStreams.update
gibt den Fehler403
(Forbidden
) zurück, wenn mit der Anfrage versucht wird, den Wert eines der folgenden nicht änderbaren Attribute zu ändern:cdn.format
cdn.frameRate
cdn.ingestionType
cdn.resolution
reason
in der Fehlerantwort istliveStreamModificationNotAllowed
.
-
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-MethodefanFundingEvents.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 einefanFundingEvent
-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-Methodesponsors.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 einenewSponsorEvent
-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 AttributscontentDetails.closedCaptionsType
aufclosedCaptionsHttpPost
. - Das Festlegen des Attributwerts auf
false
entspricht dem Festlegen des AttributscontentDetails.closedCaptionsType
aufclosedCaptionsDisabled
.
-
Mit dem neuen
broadcastType
-Parameter derliveBroadcasts.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 RessourceliveStream
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 fps oder weniger ein.%(framerate)s
-
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-Antwortcode forbidden (403)
Grund closedCaptionsTypeModificationNotAllowed
Beschreibung Der Wert für contentDetails.closedCaptionsType
kann nur geändert werden, wenn die Übertragung den Statuscreated
oderready
hat.liveBroadcasts.update
HTTP-Antwortcode invalidValue (400)
Grund invalidEnableClosedCaptions
Beschreibung In der liveBroadcast-Ressource ist der Wert des Attributs contentDetails.enableClosedCaptions
nicht mit dem Wert der EinstellungcontentDetails.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 Objektstatus.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-Antwortcode forbidden (403)
Grund liveStreamModificationNotAllowed
Beschreibung Mit 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 RessourceliveStream
unterstützt zwei neue Werte für dieses Feature:720p_hfr
und1080p_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 MethodeliveBroadcasts.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
undliveStream
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
undliveStreams.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 derliveBroadcasts.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
derliveBroadcast
-Ressource wurde aktualisiert. Wenn der Wert des Attributstrue
lautet, musst du deine Übertragung in dentesting
-Status umwandeln, bevor du sie in denlive
-Status umwandeln kannst. Wenn der Wert des Attributsfalse
lautet, darf deine Übertragung keinetesting
-Phase haben, sodass du die Übertragung direkt in denlive
-Status umwandeln kannst. -
Das Attribut
settings.offsetTimeMs
der RessourceliveCuepoint
wurde aktualisiert. Du solltest keinen Wert für das Attribut angeben, wenn deine Übertragung keinen Überwachungsstream hat. -
Alle Methoden für die Ressourcen
liveBroadcast
undliveStream
unterstützen jetzt die ParameteronBehalfOfContentOwner
undonBehalfOfContentOwnerChannel
. 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 Attributsettings.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
undliveStreams.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 MethodeliveBroadcasts.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
derliveBroadcast
-Ressource gibt den aktuellen Status der Übertragung an. -
Die neue
contentDetails.enableClosedCaptions
-Eigenschaft derliveBroadcast
-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 Statustesting
oderlive
befindet. Wenn du dieses Attribut auftrue
setzt, gibt dieliveStream
-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 inliveBroadcasts.insert
- undliveBroadcasts.update
-Anfragen nicht mehr erforderlich.
Wenn Sie eineliveBroadcast
-Ressource abrufen, die keinen Wert für dieses Attribut angibt, wird die Übertragung auf unbestimmte Zeit fortgesetzt. Wenn Sie die MethodeliveBroadcasts.insert
oderliveBroadcasts.update
aufrufen und keinen Wert für dieses Attribut angeben, wird die Übertragung auf unbestimmte Zeit fortgesetzt. -
Das Attribut
contentDetails.recordFromStart
derliveBroadcast
-Ressource, das bereits den Standardwerttrue
hatte, kann jetzt nur noch auffalse
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
auffalse
gesetzt ist, gibt die API den FehlerForbidden
zurück. Wenn dein Kanal nicht über diese Berechtigung verfügt und du versuchst, eine Übertragung zu aktualisieren, um die EigenschaftrecordFromStart
auffalse
zu setzen, gibt die API den FehlermodificationNotAllowed
zurück. -
Die Ressource
liveBroadcast
enthält keineenableArchive
-Property mehr, die in den Beschreibungen dercontentDetails.enableDvr
- undcontentDetails.enableEmbed
-Properties erwähnt wurde. -
Die Liste der gültigen Werte für das Attribut
status.lifeCycleStatus
der RessourceliveBroadcast
wurde aktualisiert und enthält jetzt eine Beschreibung jedes Status. -
Die neue
settings.walltime
-Eigenschaft derliveCuepoint
-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 Attributsettings.offsetTimeMs
angibt. -
Das neue
contentDetails
-Objekt in einerliveStream
-Ressource enthält Informationen zum Stream. Derzeit ist die einzige Eigenschaft des ObjektscontentDetails.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 RessourceliveStream
wurde aktualisiert und enthält jetzt eine Beschreibung jedes Status. -
Mit dem neuen Parameter
walltime
der MethodeliveBroadcasts.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 ParameteroffsetTimeMs
angegeben wird. -
In der API-Antwort auf eine
liveBroadcasts.list
-Anfrage wurde der Wert des Attributskind
vonyoutube#liveBroadcastList
inyoutube#liveBroadcastListResponse
geändert. -
In der API-Antwort auf eine
liveStreams.list
-Anfrage wurde der Wert des Attributskind
vonyoutube#liveStreamList
inyoutube#liveStreamListResponse
geändert. -
Die Eigenschaft
eventId
wurde vonliveBroadcastListResponse
undliveStreamListResponse
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 ParameteroffsetTimeMs
undwalltime
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 Parameterswalltime
ungültig ist.forbidden
enableClosedCaptionsModificationNotAllowed
Die Methode liveBroadcasts.update
gibt diesen Fehler zurück, wenn Sie versuchen, den WertcontentDetails.enableClosedCaptions
zu aktualisieren, und der Übertragungsstatus nichtcreated
oderready
lautet.invalidValue
conflictingTimeFields
Die Methode liveCuepoints.insert
gibt diesen Fehler zurück, wenn in Ihrer Anfrage Werte für die Attributesettings.offsetTimeMs
undsettings.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 keinencdnRequired
-Fehler mehr, der dem ähnelt, der von derliveStreams.insert
-Methode unterstützt wird.
10. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
YouTube identifiziert keine experimentellen API-Funktionen und -Dienste mehr. Stattdessen stellen wir jetzt eine Liste der YouTube APIs bereit, die der Richtlinie zur Einstellung von Produkten und Diensten unterliegen.
2. Mai 2013
Dieses Update enthält die folgenden Änderungen:
-
Mit der neuen
liveBroadcasts.control
-Methode können Sie die Anzeigeeinstellungen für ein Slate ändern, das im Übertragungsstream für eine bereits laufende Übertragung angezeigt wird. Wenn Ihr Übertragungsstream verzögert ist, können Sie mit dieser Methode auch einen Zeitversatz für die angeforderte Slate-Änderung angeben. -
Die Definitionen der folgenden Attribute wurden aktualisiert, um zu verdeutlichen, dass die Attributwerte festgelegt werden müssen, wenn Sie den
contentDetails
-Teil einerliveBroadcast
-Ressource aktualisieren: -
Der Wert
deleted
als möglicher Streamstatus wird vomstatus.streamStatus
der Ressource „liveStream
“ nicht mehr unterstützt. -
Die Informationen, die die API für viele Fehlermeldungen zurückgibt, wurden überarbeitet, um besser zu erklären, warum bestimmte Fehler aufgetreten sind. Die API unterstützt auch mehrere neue Fehler.
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 instartWithSlate
umbenannt. - Die Property
enableArchive
wurde inrecordFromStart
umbenannt. - Das Objekt
slateSettings
wurde verworfen und aus der Dokumentation entfernt. Fehlermeldungen im Zusammenhang mit demslateSettings
-Objekt oder seinen Eigenschaften wurden ebenfalls entfernt. Außerdem wurde der Abschnitt "Slates anzeigen" im Startleitfaden entfernt.
- Die Property
-
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 RessourceliveCuepoint
unterstütztslate
nicht mehr als Attributwert. Der einzige unterstützte Wert istad
. -
Das Attribut
settings.eventState
der RessourceliveCuepoint
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 AttributcontentDetails.enableArchive
oder legt keinen Wert fest.liveBroadcasts.update
: Die Ressource enthält keinen Wert für das AttributcontentDetails.enableContentEncryption
oder legt keinen Wert fest.liveBroadcasts.update
: Die Ressource enthält keinen Wert für das AttributcontentDetails.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 Attributsnippet.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 Attributcdn.format
wurde entsprechend aktualisiert und das Objektcdn.multicastIngestionInfo
sowie seine untergeordneten Eigenschaften wurden aus der Dokumentation der Ressource entfernt. Außerdem wurdehttp
aus der Liste der unterstütztencdn.ingestionType
-Werte entfernt.