Obtenir les identifiants YouTube

PageCe guide explique pas à pas comment configurer un projet Google Cloud et générer les identifiants OAuth 2.0 (Client ID, Secret et Refresh Token) nécessaires pour permettre à Podcast Utilities de publier des vidéos sur YouTube.

🎯 Objectif

Dans l'écosystème de Podcast Utilities, l'intégration YouTube a pour but de publier automatiquement vos épisodes (convertis au format vidéo) sur votre chaîne.

Cette procédure est la plus complexe car elle nécessite de créer une application sur la console Google Cloud, d'approuver des autorisations (via OAuth 2.0) et de générer manuellement un jeton de rafraîchissement (YOUTUBE_REFRESH_TOKEN). Ce jeton est indispensable pour que votre script puisse publier en coursarrière-plan sans demander votre accord à chaque exécution.

📝 Étapes à suivre

Phase 1 : Création du projet et activation de créationl'API

Rendez-vous sur la Console Google Cloud et connectez-vous avec le compte Google lié à votre chaîne YouTube. Cliquez sur le menu déroulant des projets en haut à gauche de la barre de recherche et sélectionnez Nouveau projet. Nommez-le "Podcast Utilities" et cliquez sur Créer. Dans la barre de recherche en haut au centre, tapez YouTube Data API v3 et sélectionnez-la dans les résultats. Cliquez sur le bouton bleu Activer.

Phase 2 : Configuration de l'écran de consentement

Dans le menu latéral de gauche, allez dans API et services > Écran de consentement OAuth. Choisissez le type d'utilisateur Externe et cliquez sur Créer. Remplissez les informations obligatoires (Nom de l'application, adresse e-mail d'assistance, et adresse e-mail du développeur tout en bas). Le reste peut être laissé vide. Cliquez sur Enregistrer et continuer. À l'étape des Champs d'application (Scopes), passez directement en cliquant sur Enregistrer et continuer. À l'étape Utilisateurs tests, cliquez sur Ajouter users et saisissez impérativement l'adresse e-mail de votre propre chaîne YouTube. Enregistrez.

Phase 3 : Création des identifiants

Dans le menu de gauche, allez dans Identifiants (Credentials). Cliquez sur + CRÉER DES IDENTIFIANTS en haut, puis sur ID client OAuth. Sélectionnez le type d'application Application Web. Dans la section URI de redirection autorisés, ajoutez très exactement cette URL : https://developers.google.com/oauthplayground (cela nous servira pour la phase 4). Cliquez sur Créer. Une fenêtre s'affiche avec votre ID client (YOUTUBE_CLIENT_ID) et votre Code secret du client (YOUTUBE_CLIENT_SECRET). Copiez-les temporairement dans un bloc-notes.

Phase 4 : Obtention du Refresh Token

Ouvrez un nouvel onglet et allez sur le Google OAuth 2.0 Playground. Cliquez sur l'icône Engrenage ⚙️ en haut à droite. Cochez la case Use your own OAuth credentials. Collez votre ID client et votre Code secret du client dans les champs correspondants. Fermez le petit menu d'engrenage. Dans la colonne de gauche (Step 1), cherchez YouTube Data API v3, déroulez le menu, cochez https://www.googleapis.com/auth/youtube.upload et cliquez sur le bouton bleu Authorize APIs. Connectez-vous avec votre compte Google et acceptez les avertissements de sécurité. Vous serez redirigé vers le Playground. Dans la colonne de gauche (Step 2), cliquez sur le bouton bleu Exchange authorization code for tokens. Dans la zone de texte qui s'affiche, repérez la ligne "refresh_token" et copiez la longue chaîne de caractères associée. C'est votre YOUTUBE_REFRESH_TOKEN.

⚙️ Intégration dans le fichier .env

Retournez dans votre fichier ..env à la racine de votre dossier de déploiement, et renseignez vos trois clés fraîchement générées :

YOUTUBE_CLIENT_ID=collez_le_client_id_ici
YOUTUBE_CLIENT_SECRET=collez_le_client_secret_ici
YOUTUBE_REFRESH_TOKEN=collez_le_refresh_token_ici