API-Referenz

In dieser API-Referenz wird beschrieben, wie du mit der YouTube Live Streaming API Livestreams und Videostreams auf YouTube planen kannst.

Ressourcentypen

LiveBroadcasts

Eine liveBroadcast-Ressource stellt eine Veranstaltung dar, die 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 vorhandene Bindung zwischen einer Übertragung und einem Stream. Eine Übertragung kann nur an einen Videostream gebunden werden, ein Videostream kann jedoch an mehrere Übertragungen gebunden werden.
delete DELETE /liveBroadcasts Löscht eine Übertragung.
insert POST /liveBroadcasts Erstellt eine Broadcast-Nachricht.
list GET /liveBroadcasts Gibt eine Liste von YouTube-Übertragungen zurück, die den API-Anfrageparametern entsprechen.
transition POST /liveBroadcasts/transition Ändert den Status einer YouTube-Liveübertragung und initiiert alle Prozesse, die mit dem neuen Status verknüpft sind. Wenn Sie beispielsweise den Status einer Übertragung auf testing ändern, beginnt YouTube mit der Übertragung von Video an den Monitorstream dieser Übertragung. Bevor Sie diese Methode aufrufen, sollten Sie prüfen, ob der Wert der Eigenschaft status.streamStatus für den Stream, der an Ihre Übertragung gebunden ist, active ist.
update PUT /liveBroadcasts Aktualisiert eine Übertragung. Sie können beispielsweise die in der contentDetails-Ressource definierten Broadcast-Einstellungen im liveBroadcast-Objekt ändern.
cuepoint POST /liveBroadcasts/cuepoint Fügt einen Cuepoint in eine Liveübertragung ein. Der Cuepoint löst möglicherweise eine Werbeunterbrechung aus.

LiveChatBans

Eine liveChatBan-Ressource identifiziert einen YouTube-Nutzer und einen YouTube-Livechat, in dem der Nutzer nicht mehr teilnehmen darf.

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 Entfernt eine Sperre, die einen bestimmten Nutzer daran hindert, an einem Livechat teilzunehmen. Der Nutzer kann dem Chat dann wieder beitreten. Die API-Anfrage muss vom Kanalinhaber oder einem Moderator des mit dem Bann verknüpften Livechats autorisiert werden.
insert POST /liveChat/bans Sperrt einen bestimmten Nutzer für die Teilnahme am Livechat. Die API-Anfrage muss vom Kanalinhaber oder einem Moderator des mit dem Bann verknüpften Livechats autorisiert werden.

LiveChatMessages

Eine liveChatMessage-Ressource stellt eine Chatnachricht in einem YouTube-Livechat dar. Die Ressource kann Details zu verschiedenen Arten von Nachrichten enthalten, z. B. zu einer neu geposteten Textnachricht oder einer Fan-Finanzierungsveranstaltung.

Die Livechat-Funktion ist standardmäßig für Livestreams aktiviert und während der Liveveranstaltung verfügbar. Nach dem Ende der Veranstaltung ist der Livechat für diese Veranstaltung nicht mehr verfügbar.

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 einem Moderator des mit dem Bann 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.
streamList Ermöglicht eine Server-Streaming-Verbindung zum Empfangen von Livechat-Nachrichten für einen bestimmten Chat mit geringer Latenz.

LiveChatModerators

Eine liveChatModerator-Ressource stellt einen Moderator für einen YouTube-Livechat dar. Chatmoderatoren können Nutzer in einem Chat sperren oder entsperren, 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 Chat-Moderator. Der Antrag muss vom Inhaber des Kanals der Liveübertragung autorisiert werden.
insert POST /liveChat/moderators Fügt dem Chat einen neuen Moderator hinzu. Der Antrag muss vom Inhaber des Kanals der Liveübertragung autorisiert werden.
list GET /liveChat/moderators Listet Moderatoren für einen Livechat auf. Der Antrag muss vom Inhaber des Kanals der Liveübertragung autorisiert werden.

LiveStreams

Eine liveStream-Ressource enthält Informationen zum Videostream, den du an YouTube überträgst. Über den Stream werden die Inhalte bereitgestellt, die für YouTube-Nutzer übertragen werden. Nachdem eine liveStream-Ressource erstellt wurde, kann sie 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 Videostream.
insert POST /liveStreams Erstellt einen Videostream. Über den Stream kannst du dein Video an YouTube senden, wo es dann für deine Zuschauer übertragen wird.
list GET /liveStreams Gibt eine Liste von Videostreams zurück, die den API-Anfrageparametern entsprechen.
update PUT /liveStreams Aktualisiert einen Videostream. Wenn die Eigenschaften, 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 stellt eine Super Chat-Nachricht dar, die von einem Fan während eines YouTube-Livestreams gekauft wurde. Im YouTube-Livechat-Stream heben sich Super Chats gleich doppelt von anderen Nachrichten ab:

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

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

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 Listet Super Chat-Ereignisse aus den Livestreams eines Kanals in den letzten 30 Tagen auf.

Eingestellte Ressourcentypen

FanFundingEvents

Eine fanFundingEvent-Ressource stellt ein Fan-Funding-Ereignis auf einem YouTube-Kanal dar. Mit der Finanzierung durch Fans können YouTube-Creator finanziell unterstützt werden. Ein Fan-Funding-Ereignis tritt auf, wenn ein Nutzer eine einmalige, freiwillige Zahlung an einen Kanal leistet. Weitere Informationen zu Fan-Finanzierung 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

Mit einer liveCuepoint-Ressource wird eine Werbeunterbrechung im übertragenen Videostream gestartet.

Hinweis:Der API-Befehl zum Steuern von Cuepoints ist eigentlich Teil der YouTube Content ID API und hat andere Autorisierungsanforderungen als Anfragen zum Verwalten 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 Cuepoint in eine Liveübertragung ein. Derzeit müssen Anfragen an diese Methode von einem Konto autorisiert werden, das mit einem YouTube-Rechteinhaber verknüpft ist.

Sponsoren

Eine sponsor-Ressource stellt einen Sponsor für einen YouTube-Kanal dar. Ein Sponsor unterstützt einen Creator regelmäßig finanziell, z. B. durch eine Abo- oder Mitgliedschaftsgebühr, und erhält dafür besondere Vorteile. Unterstützer können beispielsweise chatten, wenn der Creator den Modus „Nur Unterstützer“ 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 Sponsoren eines Kanals auf. Die API-Anfrage muss vom Kanalinhaber autorisiert werden.