API-Referenz

In dieser API-Referenz wird erläutert, wie Liveübertragungen und -Videostreams auf YouTube mithilfe der YouTube Live Streaming API geplant werden.

Ressourcentypen

LiveBroadcasts

Eine liveBroadcast-Ressource steht für ein Ereignis, das per Live-Video auf YouTube gestreamt wird.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind Bindet eine YouTube-Übertragung an einen Stream oder entfernt eine bestehende Bindung zwischen einer Übertragung und einem Stream. Eine Übertragung kann nur an einen Videostream gebunden sein, während ein Videostream an mehrere Übertragungen gebunden sein kann.
delete DELETE /liveBroadcasts Löscht eine Übertragung.
insert POST /liveBroadcasts Erstellt eine Übertragung.
list GET /liveBroadcasts Gibt eine Liste von YouTube-Broadcasts zurück, die den API-Anfrageparametern entsprechen.
transition POST /liveBroadcasts/transition Ändert den Status einer YouTube-Live-Übertragung und initiiert alle Prozesse im Zusammenhang mit dem neuen Status. Wenn du beispielsweise den Status einer Übertragung auf testing änderst, beginnt YouTube mit der Übertragung von Videos an den Monitorstream dieser Übertragung. Bevor Sie diese Methode aufrufen, sollten Sie prüfen, ob der Wert des Attributs status.streamStatus für den an Ihre Übertragung gebundenen Stream active ist.
update PUT /liveBroadcasts Aktualisiert eine Übertragung. Beispielsweise haben Sie die Möglichkeit, die Broadcast-Einstellungen zu ändern, die im Objekt contentDetails der Ressource liveBroadcast definiert sind.
cuepoint POST /liveBroadcasts/cuepoint Fügt einen Cue-Punkt in eine Liveübertragung ein. Der Cue-Punkt kann eine Werbeunterbrechung auslösen.

LiveChatBans

Eine liveChatBan-Ressource identifiziert einen YouTube-Nutzer und einen YouTube-Livechat, an dem der Nutzer gesperrt wurde.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Damit wird eine Sperre entfernt, die verhindert, dass ein bestimmter Nutzer am Livechat teilnimmt. Dadurch kann der Nutzer dem Chat wieder beitreten. Die API-Anfrage muss vom Kanalinhaber oder Moderator des mit der Sperre verknüpften Livechats autorisiert werden.
insert POST /liveChat/bans Damit wird ein bestimmter Nutzer von der Teilnahme am Livechat ausgeschlossen. Die API-Anfrage muss vom Kanalinhaber oder Moderator des mit der Sperre verknüpften Livechats autorisiert werden.

LiveChatMessages

Eine liveChatMessage-Ressource steht für eine Chatnachricht in einem YouTube-Livechat. Die Ressource kann Details zu verschiedenen Arten von Nachrichten enthalten, z. B. eine neu gepostete Textnachricht oder eine Veranstaltung zum Fan-Funding.

Die Livechat-Funktion ist für Liveübertragungen standardmäßig aktiviert und steht während der Live-Veranstaltung zur Verfügung. Nach dem Ende der Veranstaltung steht der Livechat für diese Veranstaltung nicht mehr zur Verfügung.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages Löscht eine Chatnachricht. Die API-Anfrage muss vom Kanalinhaber oder Moderator des mit der Sperre verknüpften Livechats autorisiert werden.
insert POST /liveChat/messages Fügt einem Livechat eine Nachricht hinzu.
list GET /liveChat/messages Listet Livechat-Nachrichten für einen bestimmten Chat auf.

LiveChatModerators

Eine liveChatModerator-Ressource steht für einen Moderator in einem YouTube-Livechat. Ein Chatmoderator kann Nutzer in Chats sperren oder wieder aufnehmen, Nachrichten entfernen und andere administrative Aktionen für den Livechat ausführen.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators Entfernt einen Chatmoderator. Die Anfrage muss vom Inhaber des Kanals der Liveübertragung genehmigt werden.
insert POST /liveChat/moderators Fügt dem Chat einen neuen Moderator hinzu. Die Anfrage muss vom Inhaber des Kanals der Liveübertragung genehmigt werden.
list GET /liveChat/moderators Listet Moderatoren für einen Livechat auf. Die Anfrage muss vom Inhaber des Kanals der Liveübertragung genehmigt werden.

LiveStreams

Eine liveStream-Ressource enthält Informationen zum Videostream, den du an YouTube überträgst. Der Stream stellt die Inhalte bereit, die für YouTube-Nutzer übertragen werden. Nach der Erstellung kann eine liveStream-Ressource an eine oder mehrere liveBroadcast-Ressourcen gebunden werden.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams Löscht einen Video-Stream.
insert POST /liveStreams Erstellt einen Videostream. Über den Stream kannst du dein Video an YouTube senden, wo es dann unter deinem Publikum übertragen werden kann.
list GET /liveStreams Gibt eine Liste von Videostreams zurück, die den API-Anfrageparametern entsprechen.
update PUT /liveStreams Aktualisiert einen Videostream. Wenn die Attribute, die Sie ändern möchten, nicht aktualisiert werden können, müssen Sie einen neuen Stream mit den richtigen Einstellungen erstellen.

SuperChatEvents

Eine superChatEvent-Ressource steht für eine Super Chat-Nachricht, die ein Fan während eines YouTube-Livestreams gekauft hat. Im Livechat-Stream von YouTube heben sich Super Chats in zweierlei Hinsicht von anderen Nachrichten ab:

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

Die Farbe des Super Chats, der Zeitraum, in dem 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.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /superChatEvents Du kannst Super Chat-Ereignisse aus den Livestreams eines Kanals der letzten 30 Tage auflisten.

Eingestellte Ressourcentypen

FanFundingEvents

Eine fanFundingEvent-Ressource steht für eine Veranstaltung zur Finanzierung durch Fans auf einem YouTube-Kanal. Mit der Finanzierung durch Fans kannst du YouTube-Creator finanziell unterstützen. Eine Finanzierung durch Fans findet statt, wenn ein Nutzer eine einmalige, freiwillige Zahlung an einen Kanal vornimmt. Weitere Informationen zur Finanzierung durch Fans findest du in der YouTube-Hilfe.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents Listet Fan-Funding-Ereignisse für einen Kanal auf. Die API-Anfrage muss vom Kanalinhaber autorisiert werden.

LiveCuepoints

Eine liveCuepoint-Ressource startet eine Werbeunterbrechung im Videostream.

Hinweis:Der API-Befehl zum Steuern von Cue-Punkten ist Teil der YouTube Content ID API und hat andere Autorisierungsanforderungen als Anfragen zur Verwaltung von liveBroadcast- und liveStream-Ressourcen.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/
insert POST /liveCuepoints Fügt einen Cue-Punkt in eine Liveübertragung ein. Derzeit müssen Anfragen für diese Methode über ein Konto autorisiert werden, das mit einem YouTube-Rechteinhaber verknüpft ist.

Sponsoren

Eine sponsor-Ressource steht für einen Sponsor eines YouTube-Kanals. Ein Sponsor bietet einem Creator regelmäßige finanzielle Unterstützung, z. B. in Form eines Abos oder einer Mitgliedschaftsgebühr, und erhält besondere Vorteile. Unterstützer können beispielsweise chatten, wenn der Creator den Unterstützer-Modus für einen Chat aktiviert.

Weitere Informationen zu dieser Ressource finden Sie in der Ressourcendarstellung und in der Liste der Attribute.

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
list GET /sponsors Listet die Unterstützer eines Kanals auf. Die API-Anfrage muss vom Kanalinhaber autorisiert werden.