YouTube · Guide de configuration
Comment créer une clé YouTube de données API
StreamBruh utilise votre clé YouTube Data API v3 pour les recherches de vidéos publiques et les vérifications de mise en ligne des chaînes. Les quotas Google Cloud et les restrictions de clé API peuvent affecter ces vérifications planifiées.
Configuration étape par étape
Créer ou sélectionner un projet Google Cloud
Connectez-vous à Google Cloud Console avec un compte Google. Créez un projet pour ces notifications ou sélectionnez un projet que vous gérez. Vérifiez que le projet souhaité est actif dans l'en-tête de la console.
Activer YouTube Data API v3
Dans APIs & Services → Library, recherchez YouTube Data API v3 et activez-le pour ce projet. La création d'une clé seule n'active pas le API.
Créer une clé API
Ouvrez APIs & Services → Identifiants, choisissez Créer des informations d'identification → Clé API et copiez la clé générée. Restreindre son accès API à YouTube Data API v3. Gardez la clé hors des pages publiques et du contrôle de source.
StreamBruh appelle Google depuis son serveur, pas depuis le navigateur d'un visiteur. Une restriction de site Web ou de référent HTTP bloquera ces requêtes de serveur. Si la prise en charge de StreamBruh confirme une IP de sortie publique stable pour le VPS, vous pouvez en outre restreindre la clé à cette IP ; sinon, conservez la restriction YouTube API et surveillez l'utilisation.
Enregistrez la clé dans StreamBruh
Ouvrez le Bot et les intégrations, collez la clé dans la clé YouTube API et enregistrez. Une clé enregistrée est masquée. Laissez le champ vide lors de modifications ultérieures si vous souhaitez conserver la clé existante.
Choisissez des recherches ou des chaînes
Une notification de recherche YouTube suit les nouvelles vidéos publiques correspondant à un terme de recherche ; son paramètre linguistique est une préférence de pertinence plutôt qu'une garantie, et les mots bloqués séparés par des virgules excluent les titres contenant ces termes. Une notification de canal accepte un lien YouTube @handle, un lien d'ID de canal, un handle ou un ID de canal pris en charge par le formulaire.
Sélectionnez un canal de destination Discord, personnalisez le message et enregistrez. Les contrôles sont exécutés selon un calendrier. Les demandes de recherche et les vérifications de canaux consomment le quota YouTube API à des taux différents ; les résultats dépendent également de la disponibilité du YouTube.
Vérifiez votre configuration
- YouTube Data API v3 est activé dans le même projet que la clé.
- La restriction API de la clé inclut YouTube Data API v3 et sa restriction client autorise le VPS.
- Un lien de canal est résolu ou une configuration de recherche est enregistrée, et le bot peut envoyer au canal Discord sélectionné.
Dépannage
Clé API rejetée
Confirmez que la clé appartient au projet sélectionné, que YouTube Data API v3 est activé et que ses restrictions autorisent les requêtes du VPS. Les restrictions du référent du navigateur ne correspondent pas aux appels côté serveur.
Quota épuisé
Examinez l’utilisation et le quota des données YouTube API dans Google Cloud Console. Réduisez les recherches inutiles ou demandez une extension de quota via Google si vous êtes éligible ; réessayez une fois que le quota devient disponible.
Aucune vidéo postée
Vérifiez si une nouvelle vidéo publique correspond à la recherche ou à la chaîne depuis la dernière vérification, si les mots bloqués excluent son titre et si la chaîne Discord reste envoyable. Les contrôles programmés ne sont pas instantanés.