YouTube-API-Schlüssel erstellen

YouTube-Chat in Astral Overlay benötigt deinen eigenen YouTube Data API v3-Schlüssel. Für ein Twitch-Fenster ist diese Einrichtung nicht nötig.

1. Google Cloud öffnen

Öffne die Google Cloud Console und melde dich mit deinem Google-Konto an. Erstelle über die Projektauswahl oben ein Projekt oder wähle eines, das du bereits für diese Integration nutzt.

Ein Name wie Astral Overlay Chat erleichtert das Wiedererkennen. Dieses Projekt muss bei den folgenden Schritten ausgewählt bleiben.

2. YouTube Data API v3 aktivieren

Öffne die Seite von YouTube Data API v3 in der API-Bibliothek und wähle Aktivieren.

Ist sie bereits aktiviert, gehe zur Anmeldedatenseite. Eine andere YouTube-bezogene API zu aktivieren ersetzt diesen Schritt nicht.

3. API-Schlüssel erstellen

Öffne APIs und Dienste > Anmeldedaten und wähle Anmeldedaten erstellen > API-Schlüssel.

Wähle YouTube Data API v3, falls der Dialog nach der erlaubten API fragt. Kopiere den Schlüssel und gib ihm einen erkennbaren Namen.

Wähle einen API-Schlüssel, keine OAuth-Client-ID oder Dienstkonto-Anmeldedaten. Die aktuelle Chateinrichtung erwartet die Schlüsselzeichenfolge.

Falls die Konsole anders aussieht, lies Googles YouTube-Anleitung zu Anmeldedaten.

4. Passende Einschränkungen festlegen

Öffne die Schlüsseleinstellungen auf der Anmeldedatenseite:

Wähle unter API-Einschränkungen die Option Schlüssel einschränken und nur YouTube Data API v3.
Unter Anwendungseinschränkungen ist Keine für den aktuellen Windows-Client praktikabel, sofern du keine Einschränkung auf eine externe IP pflegst.
Speichere die Einstellungen.

Astral Overlay sendet Anfragen direkt von deinem Computer. Eine Websites-Einschränkung, auch auf diese Dokumentationsseite, passt nicht zu diesem Client. Android- und iOS-Einschränkungen sind ebenfalls ungeeignet.

Eine IP-Adressen-Einschränkung kann für engeren Zugriff die öffentliche Internet-IP deines Computers erlauben. Sie muss bei einem Wechsel der Verbindung oder des VPN aktuell gehalten werden. Trage weder 127.0.0.1 noch eine private Heimnetzadresse ein.

Ohne Anwendungseinschränkung ist der Schlüssel nicht an einen bestimmten Computer gebunden. Behalte die API-Einschränkung auf YouTube bei und halte den Schlüssel geheim. Googles Referenz zu Einschränkungen erklärt die Möglichkeiten.

5. In Astral Overlay einfügen

Öffne Bildschirme > Chat hinzufügen und wähle YouTube.
Füge den Livevideolink ins Videofeld ein.
Füge den Schlüssel ins API-Schlüsselfeld ein.
Füge das Chatfenster hinzu.

Nutze die URL des Livevideos, nicht die Kanalseite. Astral Overlay verdeckt den Schlüssel und speichert eine neue Eingabe, wenn du den Chat hinzufügst. Die Karte kann einen gespeicherten Schlüssel auch vergessen.

Wenn die Verbindung fehlschlägt

Meldung oder Symptom	Prüfen
API nicht aktiviert	Aktiviere YouTube Data API v3 in dem Projekt, zu dem der Schlüssel gehört.
Schlüssel ungültig	Kopiere den API-Schlüssel erneut; füge keine Client- oder Projekt-ID ein.
Schlüsseleinschränkungen blockieren die App	Prüfe die YouTube-API-Einschränkung und ob Website- oder externe IP-Einschränkungen diesen Computer ablehnen.
Kontingent aufgebraucht	Prüfe die API-Kontingente des Projekts. Ein neuer Schlüssel im selben Projekt erneuert dessen Kontingent nicht.
Kein Livechat	Prüfe, ob das Video live und sein Chat verfügbar ist.

YouTube-API-Anfragen verbrauchen Projektkontingent. Googles Kontingentdokumentation erläutert Anfragekosten und tägliches Zurücksetzen. Das tatsächliche Kontingent steht in der Konsole.

Veröffentliche den Schlüssel nicht in Screenshots, Quellcode oder Supportanfragen. Falls er bekannt wurde, ersetze ihn in Google Cloud und aktualisiere ihn in Astral Overlay.

Zurück zu Twitch- und YouTube-Chat.