YouTube ist die aufwendigste der vier Anbindungen — nicht wegen NexPulse, sondern weil Google für den Zugriff auf den Live-Chat einen eigenen Schlüssel verlangt. Plane für das erste Mal zehn Minuten ein. Danach nie wieder.
Was du brauchst
- Einen API-Schlüssel aus der Google Cloud Console (kostenlos)
- Die Adresse deines laufenden Streams oder deine Kanal-ID
Schritt 1: API-Schlüssel anlegen
Du legst bei Google ein Projekt an und aktivierst darin die YouTube Data API. Das klingt nach mehr, als es ist — vier Schritte in der Google Cloud Console:
- Projekt anlegen — der Name ist egal, „NexPulse" tut es
- YouTube Data API v3 aktivieren — in der Bibliothek suchen, auf Aktivieren klicken
- Unter Anmeldedaten einen API-Schlüssel erstellen
- Den Schlüssel kopieren
Kein Abrechnungskonto, keine Kreditkarte, keine Überprüfung. Der Zugriff auf den Live-Chat liegt im kostenlosen Kontingent.
Der Schlüssel ist ein Passwort. Blende ihn nie im Stream ein und gib ihn nicht weiter. Falls es doch passiert: in der Console löschen und einen neuen erstellen.
TODO: Klickpfad an der laufenden App prüfen und Screenshot ergänzen.
Schritt 2: In NexPulse eintragen
Schlüssel einfügen, dazu eine Angabe zu deinem Kanal. Erkannt wird alles, was du zur Hand hast:
| Eingabe | Beispiel |
|---|---|
| Dein @Name | @meinkanal oder youtube.com/@meinkanal |
| Nur der Name | meinkanal |
| Kanal-ID | UC… oder youtube.com/channel/UC… |
| Die Adresse des laufenden Streams | youtube.com/watch?v=… |
TODO: Klickpfad an der laufenden App prüfen und Screenshot ergänzen.
Am besten den @Namen eintragen
NexPulse löst ihn einmalig zur technischen Kanal-ID auf und merkt sich diese. Ab dann findet es bei jedem Verbinden den gerade laufenden Stream von selbst.
Die Adresse eines laufenden Streams funktioniert auch, gilt aber nur für diese eine Übertragung — YouTube vergibt jedes Mal eine neue. Du müsstest sie also nach jedem Stream neu eintragen. Nimm den @Namen, dann ist das erledigt.
Deine Kanal-ID kannst du auch selbst nachschlagen: YouTube Studio → erweiterte Kanaleinstellungen.
Das Tageskontingent — bitte einmal lesen
Google gibt jedem Schlüssel ein Tagesbudget, und jeder Abruf des Live-Chats verbraucht davon etwas.
In der Praxis reicht das Standardbudget für ungefähr drei Stunden Stream pro Tag. Danach meldet YouTube „Kontingent erschöpft" und der Chat-Abruf endet — dein Stream läuft normal weiter, aber NexPulse sieht keine neuen Nachrichten mehr.
Das betrifft niemanden mit einem Zwei-Stunden-Stream und jeden bei einem Marathon.
Was hilft:
- YouTube erst verbinden, wenn du es brauchst, nicht schon Stunden vorher
- Bei langen Streams eine Kontingenterhöhung bei Google beantragen (Formular, dauert einige Tage)
- Das Budget wird täglich zurückgesetzt — nach kalifornischer Zeit, also am späten Nachmittag unserer Zeit
Was funktioniert — und was nicht
Funktioniert: Chat mitlesen, Zuschauerzahl, und alle Ereignisse lösen Alerts, Sounds und Overlays aus wie bei jeder anderen Plattform.
Funktioniert nicht: Der Bot kann nicht in den YouTube-Chat schreiben. Ansagen, Begrüßungen, Chat-Befehle und Shoutouts bleiben Twitch vorbehalten.
Wenn es klemmt
NexPulse nennt dir die Ursache im Klartext. Was die Meldungen bedeuten:
| Meldung | Was zu tun ist |
|---|---|
| Kanal gefunden, sendet aber gerade nicht | Erst den Stream starten, dann verbinden |
| Kein Kanal gefunden | Schreibweise prüfen oder die UC…-Kanal-ID eintragen |
| API nicht aktiviert | „YouTube Data API v3" im Google-Projekt aktivieren (Schritt 1, Punkt 2) |
| Schlüssel wird nicht akzeptiert | Tippfehler — oder in der Console einen neuen Schlüssel erstellen |
| Tageskontingent aufgebraucht | Morgen wieder da; bei langen Streams Erhöhung beantragen |
Der häufigste Fall ist der erste: Der Stream läuft noch gar nicht. NexPulse kann sich nur mit einer laufenden Übertragung verbinden, weil vorher kein Chat existiert.