YouTube · Einrichtungsanleitung
So erstellen Sie einen YouTube-Datenschlüssel API
StreamBruh verwendet Ihren YouTube Data API v3-Schlüssel für öffentliche Videosuchen und Kanal-Upload-Prüfungen. Google Cloud-Kontingente und API Schlüsseleinschränkungen können sich auf diese geplanten Prüfungen auswirken.
Schritt-für-Schritt-Einrichtung
Erstellen Sie ein Google Cloud-Projekt oder wählen Sie es aus
Melden Sie sich mit einem Google-Konto bei Google Cloud Console an. Erstellen Sie ein Projekt für diese Benachrichtigungen oder wählen Sie ein von Ihnen verwaltetes Projekt aus. Überprüfen Sie, ob das gewünschte Projekt im Konsolenheader aktiv ist.
Aktivieren Sie YouTube Data API v3
Suchen Sie in APIs & Services → Bibliothek nach YouTube Data API v3 und aktivieren Sie es für dieses Projekt. Durch das alleinige Erstellen eines Schlüssels wird API nicht aktiviert.
Erstellen Sie einen API-Schlüssel
Öffnen Sie APIs & Services → Anmeldeinformationen, wählen Sie Anmeldeinformationen erstellen → API-Schlüssel und kopieren Sie den generierten Schlüssel. Beschränken Sie den API-Zugriff auf YouTube Data API v3. Halten Sie den Schlüssel von öffentlichen Seiten und der Quellcodeverwaltung fern.
StreamBruh ruft Google von seinem Server aus auf, nicht vom Browser eines Besuchers. Eine Website- oder HTTP-Referrer-Einschränkung blockiert diese Serveranfragen. Wenn der StreamBruh-Support eine stabile öffentliche Ausgangs-IP für den VPS bestätigt, können Sie den Schlüssel zusätzlich auf diese IP beschränken; Andernfalls behalten Sie die YouTube API-Beschränkung bei und überwachen Sie die Nutzung.
Speichern Sie den Schlüssel in StreamBruh
Öffnen Sie „Bot & Integrations“, fügen Sie den Schlüssel in „YouTube API Key“ ein und speichern Sie ihn. Ein gespeicherter Schlüssel wird maskiert. Lassen Sie das Feld bei späteren Bearbeitungen leer, wenn Sie den vorhandenen Schlüssel beibehalten möchten.
Wählen Sie Suchanfragen oder Kanäle
Eine YouTube-Suchbenachrichtigung folgt neuen öffentlichen Videos, die einem Suchbegriff entsprechen; Die Spracheinstellung ist eher eine Relevanzpräferenz als eine Garantie, und durch Kommas getrennte blockierte Wörter schließen Titel aus, die diese Begriffe enthalten. Eine Kanalbenachrichtigung akzeptiert einen YouTube @handle-Link, einen Kanal-ID-Link, ein Handle oder eine vom Formular unterstützte Kanal-ID.
Wählen Sie einen Discord-Zielkanal aus, passen Sie die Nachricht an und speichern Sie sie. Die Prüfungen erfolgen nach einem Zeitplan. Suchanfragen und Kanalprüfungen verbrauchen das Kontingent YouTube API unterschiedlich schnell; Die Ergebnisse hängen auch von der Verfügbarkeit von YouTube ab.
Überprüfen Sie Ihr Setup
- YouTube Data API v3 ist im selben Projekt wie der Schlüssel aktiviert.
- Die API-Einschränkung des Schlüssels umfasst YouTube Data API v3 und seine Client-Einschränkung lässt den VPS zu.
- Eine Kanalverknüpfung wird aufgelöst oder eine Suchkonfiguration gespeichert, und der Bot kann an den ausgewählten Discord-Kanal senden.
Fehlerbehebung
API-Schlüssel abgelehnt
Bestätigen Sie, dass der Schlüssel zum ausgewählten Projekt gehört, YouTube Data API v3 aktiviert ist und seine Einschränkungen Anfragen vom VPS zulassen. Browser-Referrer-Einschränkungen gelten nicht für serverseitige Aufrufe.
Kontingent ausgeschöpft
Überprüfen Sie die Nutzung und das Kontingent der YouTube-Daten API in Google Cloud Console. Reduzieren Sie unnötige Suchvorgänge oder beantragen Sie eine Kontingentverlängerung über Google, sofern berechtigt; Versuchen Sie es erneut, sobald das Kontingent verfügbar ist.
Kein Video gepostet
Überprüfen Sie, ob ein neues öffentliches Video mit der Suche oder dem Kanal seit der letzten Prüfung übereinstimmt, ob blockierte Wörter seinen Titel ausschließen und ob der Discord-Kanal weiterhin sendbar ist. Geplante Prüfungen erfolgen nicht sofort.