Passer au contenu principal

Obtenir les identifiants YouTube

Ce 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 arrière-plan sans demander votre accord à chaque exécution.

📝 Étapes à suivre

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

  1. Rendez-vous sur la Console Google Cloud et connectez-vous avec le compte Google lié à votre chaîne YouTube.
  2. 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.
  3. 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

  1. Dans le menu latéral de gauche, allez dans API et services > Écran de consentement OAuth.
  2. Choisissez le type d'utilisateur Externe et cliquez sur Créer.
  3. 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.
  4. À l'étape des Champs d'application (Scopes), passez directement en cliquant sur Enregistrer et continuer.
  5. À 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

  1. Dans le menu de gauche, allez dans Identifiants (Credentials).
  2. Cliquez sur + CRÉER DES IDENTIFIANTS en haut, puis sur ID client OAuth.
  3. Sélectionnez le type d'application Application Web.
  4. 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.
  5. 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

  1. Ouvrez un nouvel onglet et allez sur le Google OAuth 2.0 Playground.
  2. Cliquez sur l'icône Engrenage ⚙️ en haut à droite. Cochez la case Use your own OAuth credentials.
  3. Collez votre ID client et votre Code secret du client dans les champs correspondants. Fermez le petit menu d'engrenage.
  4. 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.
  5. Connectez-vous avec votre compte Google et acceptez les avertissements de sécurité.
  6. Vous serez redirigé vers le Playground. Dans la colonne de gauche (Step 2), cliquez sur le bouton bleu Exchange authorization code for tokens.
  7. 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

⚠️ Points d'attention

  • Expiration en mode Test : Tant que votre application Google Cloud est en mode "Test" (Phase 2), votre Refresh Token expirera après 7 jours. Pour qu'il soit permanent, retournez sur l'écran de consentement OAuth dans Google Cloud et cliquez sur le bouton Publier l'application (vous n'aurez pas besoin de faire valider l'application par Google tant que vous êtes le seul utilisateur).
  • Quotas de publication : L'API YouTube impose des limites. Mettre en ligne une vidéo consomme environ 1 600 unités sur un quota quotidien de 10 000 unités (soit environ 6 vidéos maximum par jour).
  • Rappel : Comme indiqué dans le fichier de configuration principal, cette intégration n'a peut-être pas d'utilité immédiate pour Podcast Utilities, mais ces identifiants seront prêts pour une utilisation future.