Obtenir une clé API YouTube

Le chat YouTube d’Astral Overlay nécessite votre propre clé YouTube Data API v3. Un panneau Twitch ne nécessite pas cette configuration.

1. Ouvrir Google Cloud

Ouvrez la Google Cloud Console et connectez-vous avec votre compte Google. Utilisez le sélecteur de projet en haut pour créer un projet, ou choisissez celui que vous utilisez déjà pour cette intégration.

Un nom comme Astral Overlay Chat vous aidera à le reconnaître. Vérifiez que ce projet reste sélectionné pendant les étapes suivantes.

2. Activer YouTube Data API v3

Ouvrez la page YouTube Data API v3 dans la bibliothèque d’API et choisissez Activer.

Si elle est déjà activée, passez à la page des identifiants. Activer une autre API liée à YouTube ne remplace pas cette étape.

3. Créer une clé API

Ouvrez API et services > Identifiants, puis choisissez Créer des identifiants > Clé API.

Sélectionnez YouTube Data API v3 si la boîte de dialogue demande à quelle API la clé peut accéder. Copiez la clé obtenue et donnez-lui un nom reconnaissable.

Choisissez une clé API, pas un identifiant client OAuth ni des identifiants de compte de service. La configuration actuelle du chat Astral Overlay attend la chaîne de la clé.

Consultez les instructions YouTube sur les identifiants de Google si la console a une autre présentation.

4. Définir des restrictions compatibles

Ouvrez les paramètres de la clé sur la page des identifiants :

Dans Restrictions relatives aux API, choisissez Restreindre la clé, puis sélectionnez uniquement YouTube Data API v3.
Dans Restrictions relatives aux applications, Aucune est l’option pratique pour le client Windows actuel d’Astral Overlay, sauf si vous maintenez une restriction par IP externe.
Enregistrez les paramètres.

Astral Overlay envoie les requêtes directement depuis votre ordinateur. Une restriction Sites Web, y compris pour ce site de documentation, ne correspond pas à ce client. Les restrictions Android et iOS ne conviennent pas non plus.

Pour limiter davantage l’accès, une restriction Adresses IP peut autoriser l’IP Internet publique de votre ordinateur. Elle doit rester à jour si votre connexion ou votre VPN change. Ne saisissez pas 127.0.0.1 ni une adresse privée du réseau domestique.

Laisser les restrictions d’application sur Aucune signifie que la clé n’est pas liée à un ordinateur précis. Conservez la restriction API à YouTube seul et gardez la clé privée. La référence des restrictions de Google explique les choix disponibles.

5. Coller la clé dans Astral Overlay

Ouvrez Écrans > Ajouter un chat et choisissez YouTube.
Collez le lien de la vidéo en direct dans le champ vidéo.
Collez la clé dans le champ de clé API.
Ajoutez le panneau de chat.

Utilisez l’URL de la vidéo en direct, pas la page d’accueil de la chaîne. Astral Overlay masque la clé dans l’interface et enregistre une nouvelle clé quand vous ajoutez le chat. La carte peut aussi oublier une clé enregistrée.

Si la connexion échoue

Message ou symptôme	Points à vérifier
API non activée	Activez YouTube Data API v3 dans le projet auquel appartient la clé.
Clé non valide	Copiez à nouveau la clé API ; ne collez pas un identifiant client ou de projet.
Restrictions de clé bloquant l’application	Vérifiez la restriction API YouTube et si les restrictions de site Web ou d’IP externe rejettent cet ordinateur.
Quota épuisé	Consultez les quotas API du projet. Recréer une clé dans le même projet ne lui attribue pas un nouveau quota.
Aucun chat en direct	Vérifiez que la vidéo est en direct et que son chat est disponible.

Les requêtes API YouTube consomment le quota du projet. La documentation des quotas de Google explique le coût des requêtes et la réinitialisation quotidienne ; consultez la console pour connaître le quota réel de votre projet.

Ne publiez pas la clé dans des captures d’écran, du code source ou des demandes d’aide. Si elle est exposée, remplacez-la dans Google Cloud et mettez Astral Overlay à jour avec la nouvelle clé.

Retour aux chats Twitch et YouTube.