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 in 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 an Ihre Übertragung gebundenen Stream 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 Livechats autorisiert werden, der mit dem Bann verknüpft ist.
insert POST /liveChat/bans Sperrt einen bestimmten Nutzer für die Teilnahme am Livechat. Die API-Anfrage muss vom Kanalinhaber oder einem Moderator des Livechats autorisiert werden, der mit dem Bann verknüpft ist.

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. 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 Livechats autorisiert werden, der mit dem Bann verknüpft ist.
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 die Sperrung aufheben, 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 auf YouTube ü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 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 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.