API-Referenz

In dieser API-Referenz wird erläutert, wie du mit der YouTube Live Streaming API Liveübertragungen und Videostreams auf YouTube planst.

Ressourcentypen

Liveübertragungen

Eine liveBroadcast-Ressource repräsentiert ein Ereignis, das über Live-Videos auf YouTube gestreamt wird.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und 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 sein. Ein Videostream kann jedoch an mehrere Übertragungen gebunden sein.
delete DELETE /liveBroadcasts Löscht eine Übertragung.
insert POST /liveBroadcasts Erstellt eine Übertragung.
list GET /liveBroadcasts Gibt eine Liste der 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 du beispielsweise den Status einer Übertragung zu testing änderst, beginnt YouTube damit, ein Video an den Monitorstream dieser Übertragung zu senden. 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 lautet.
update PUT /liveBroadcasts Aktualisiert eine Übertragung. Sie können beispielsweise die Übertragungseinstellungen ändern, die im contentDetails-Objekt 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.

Livechat-Bans

Eine liveChatBan-Ressource gibt einen YouTube-Nutzer und einen YouTube-Livechat an, an denen der Nutzer nicht teilnehmen kann.

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

Methode HTTP-Anfrage Beschreibung
URIs relativ zu https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans Entfernt eine Sperre, die verhindert, dass ein bestimmter Nutzer zu einem Livechat beiträgt. Der Nutzer kann dann wieder am Chat teilnehmen. Die API-Anfrage muss vom Kanalinhaber oder vom Moderator des Livechats genehmigt werden, der mit der Sperre verknüpft ist.
insert POST /liveChat/bans Ein bestimmter Nutzer wird im Livechat gesperrt. Die API-Anfrage muss vom Kanalinhaber oder vom Moderator des Livechats genehmigt werden, der mit der Sperre verknüpft ist.

Livechat-Nachrichten

Eine liveChatMessage-Ressource stellt eine Chatnachricht in einem YouTube-Livechat dar. Die Ressource kann Details zu verschiedenen Arten von Nachrichten enthalten, einschließlich einer neu veröffentlichten SMS oder einer Finanzierung durch Fans.

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

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und 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 vom Moderator des Livechats genehmigt werden, der mit der Sperre verknüpft ist.
insert POST /liveChat/messages Einem Livechat wird eine Nachricht hinzugefügt.
list GET /liveChat/messages Listet Livechat-Nachrichten für einen bestimmten Chat auf.

Livechat-Moderatoren

Eine liveChatModerator-Ressource repräsentiert einen Moderator für einen YouTube-Livechat. Ein Chatmoderator kann Nutzer für einen Chat sperren oder deren Sperre aufheben, Nachrichten entfernen und andere administrative Aktionen für den Livechat ausführen.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und 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 einen neuen Moderator für den Chat 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 sendest. Der Stream enthält die Inhalte, die an YouTube-Nutzer gesendet 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 zugehörigen Ressourcendarstellung und 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. Mit dem Stream kannst du dein Video an YouTube senden und es dann an deine Zuschauer senden.
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.

Sponsoren

Eine sponsor-Ressource repräsentiert einen YouTube-Kanal. Ein Unterstützer bietet einem Creator regelmäßige finanzielle Unterstützung, z. B. in Form einer Abo- oder 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 zugehörigen Ressourcendarstellung und Liste der Attribute.

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

SuperChat-Ereignisse

Eine superChatEvent-Ressource repräsentiert eine Super Chat-Nachricht, die von einem Fan während eines YouTube-Livestreams gekauft wurde. Auf YouTube gibt es zwei Arten von Super Chats, die sich von anderen Nachrichten abheben:

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

Die Farbe des Super Chats, der Zeitraum, in dem er im Ticker angepinnt bleibt, und die maximale Nachrichtenlänge werden durch den Kaufbetrag bestimmt. Weitere Informationen zu Super Chats findest du in der YouTube-Hilfe.

Weitere Informationen zu dieser Ressource finden Sie in der zugehörigen Ressourcendarstellung und 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 in den letzten 30 Tagen auflisten.

Eingestellte Ressourcentypen

FanFunding-Veranstaltungen

Eine Ressource vom Typ fanFundingEvent steht für ein Ereignis zur Finanzierung durch Fans in einem YouTube-Kanal. Die Finanzierung durch Fans bietet eine Möglichkeit, YouTube-Creator finanziell zu unterstützen. Ein Ereignis zur Finanzierung durch Fans findet statt, wenn ein Nutzer eine einmalige, freiwillige Zahlung an einen Kanal ausführt. Weitere Informationen zur Finanzierung durch Fans findest du in der YouTube-Hilfe.

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

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