GUIDE COMPLET : Créer un projet Google Cloud OAuth pour une application Excel/VBA

[dysorthographie]

Bonsoir,

---

PARTIE 1 : CRÉATION DU PROJET GOOGLE CLOUD​

Étape 1.1 : Accéder à Google Cloud Console

• Ouvrez votre navigateur.
• Allez sur : https://console.cloud.google.com
• Connectez-vous avec votre compte Google.

Étape 1.2 : Créer un nouveau projet

• En haut de la page, cliquez sur le nom du projet actuel (ou "Sélectionner un projet").
• Cliquez sur NOUVEAU PROJET (en haut à droite).
• Remplissez les informations :
  • Nom du projet : Macro Gmail Excel (ou un nom de votre choix)
  • Organisation : Laissez vide (sauf si vous en avez une)
  • Emplacement : Aucune organisation
• Cliquez sur CRÉER.
• Attendez la notification « Projet créé ».

---

PARTIE 2 : ACTIVER L'API GMAIL​

Étape 2.1 : Accéder à la bibliothèque d'API

• Dans le menu hamburger (≡), cliquez sur APIs et services.
• Cliquez sur Bibliothèque.

Étape 2.2 : Activer Gmail API

• Dans la barre de recherche, tapez Gmail API.
• Sélectionnez Gmail API dans les résultats.
• Cliquez sur ACTIVER.
• Attendez que l’API soit activée.

---

PARTIE 3 : CONFIGURER L'ÉCRAN DE CONSENTEMENT OAUTH​

Étape 3.1 : Accéder à l'écran de consentement

• Dans APIs et services, cliquez sur Écran de consentement OAuth.

Étape 3.2 : Choisir le type d'utilisateur

• Sélectionnez Externe.
• Cliquez sur CRÉER.

Étape 3.3 : Configuration de l'écran de consentement (Page 1/4)

• Nom de l'application : Macro Excel Gmail
• E-mail d’assistance utilisateur : votre email
• Logo, domaine, page d’accueil : facultatif
• Adresse e-mail du développeur : votre email
• Cliquez sur ENREGISTRER ET CONTINUER.

Étape 3.4 : Ajouter les scopes (Page 2/4)

• Cliquez sur AJOUTER OU SUPPRIMER DES CHAMPS D'APPLICATION.
• Tapez gmail dans le filtre.
• Cochez : https://mail.google.com/ (Gérer vos emails).
• Cliquez sur METTRE À JOUR, puis ENREGISTRER ET CONTINUER.

Étape 3.5 : Ajouter des utilisateurs test (Page 3/4)

• Cliquez sur + AJOUTER DES UTILISATEURS.
• Entrez votre email et ceux de vos testeurs.
• Cliquez sur AJOUTER, puis ENREGISTRER ET CONTINUER.

⚠️ Seuls ces utilisateurs peuvent utiliser l’application en mode Test.
Étape 3.6 : Résumé (Page 4/4)

• Vérifiez les informations et cliquez sur RETOUR AU TABLEAU DE BORD.

---

PARTIE 4 : CRÉER LES IDENTIFIANTS OAUTH (CLIENT ID)​

Étape 4.1 : Accéder aux identifiants

• Dans APIs et services, cliquez sur Identifiants.

Étape 4.2 : Créer un ID client OAuth

• Cliquez sur + CRÉER DES IDENTIFIANTS.
• Sélectionnez ID client OAuth.

Étape 4.3 : Configurer le client

• Type d'application : Application de bureau
• Nom : Client Excel VBA
• Cliquez sur CRÉER.

Étape 4.4 : Récupérer vos identifiants

• ID client et Secret client s’affichent.
• ⚠️ Sauvegardez-les immédiatement.
• Cliquez sur TÉLÉCHARGER JSON pour garder une copie.
• OU copiez manuellement les deux valeurs dans un fichier texte sécurisé.
• Cliquez sur OK.

Conservez ces identifiants en lieu sûr !

---

PARTIE 5 : INTÉGRER LES IDENTIFIANTS DANS VOTRE CODE VBA​

Étape 5.1 : Modifier votre code
Remplacez les constantes fictives par vos identifiants :

Public Const OAUTH_CLIENT_ID As String = "123456789-xxxxxxxxx.apps.googleusercontent.com"
Public Const OAUTH_CLIENT_SECRET As String = "GOCSPX-xxxxxxxxxxxxxxxx"
Public Const OAUTH_SCOPE As String = "https://mail.google.com/"
Public Const OAUTH_REDIRECT As String = "http://localhost"

---

PARTIE 6 : TESTER VOTRE APPLICATION​

Étape 6.1 : Premier test

• Lancez la macro TestToken.
• Connectez-vous avec un compte Google présent dans la liste des testeurs.
• Cliquez sur Continuer malgré l’avertissement Google.
• Acceptez les autorisations demandées.
• Copiez l’URL affichée dans le navigateur et collez-la dans Excel.
• Si tout va bien : Access Token récupéré avec succès !

Étape 6.2 : Test suivant

• Le refresh token est utilisé automatiquement, plus besoin de se reconnecter.

---

PARTIE 7 : PASSER EN PRODUCTION (Optionnel)​

• Complétez l’écran de consentement avec toutes les informations obligatoires.
• Cliquez sur PUBLIER L'APPLICATION > PRÉPARER LA VALIDATION.
• Fournissez :
  • Justification pour accéder à Gmail
  • Vidéo de démonstration (YouTube)
  • Captures d’écran
• La validation peut prendre plusieurs semaines.

---

RÉCAPITULATIF DES FICHIERS ET INFORMATIONS​

Élément	Où le trouver	Utilité
Client ID	Google Cloud Console > Identifiants	Pour le code VBA
Client Secret	Google Cloud Console > Identifiants	Pour le code VBA
Fichier JSON	Téléchargé lors de la création	Backup des identifiants
Refresh Token	%TEMP%\gmail_token.txt	Pour éviter de se reconnecter
Access Token	Généré à chaque exécution	Pour accéder à Gmail

---

DÉPANNAGE COURANT​

• Erreur 403 : access_denied
  → L’utilisateur n’est pas dans la liste des testeurs.
  → Solution : Ajoutez son email dans Audience > Utilisateurs test.
• Erreur 400 : invalid_request
  → Le redirect_uri n’est pas correct.
  → Solution : Vérifiez que OAUTH_REDIRECT = "http://localhost" dans votre code.
• Erreur : invalid_grant
  → Le code d’autorisation a expiré ou a déjà été utilisé.
  → Solution : Recommencez l’authentification et collez le code rapidement.
• Refresh token non récupéré
  → L’application a déjà été autorisée une fois.
  → Solution : Révoquez l’accès sur Google Permissions et réessayez.

---