Rêvez-vous de pouvoir avoir toutes vos données Gmail sous forme de fichiers dans une feuille de calcul ? Cela peut être bénéfique de plusieurs façons, par exemple pour analyser vos abonnements par e-mail, suivre l’historique de communication avec vos clients dans votre propre CRM Google Sheets, ou simplement comme sauvegarde. Cependant, il n’y a pas de bouton qui permette d’extraire les e-mails Gmail vers Google Sheets en un ou deux clics. Cependant, vous avez quelques options et solutions de contournement pour accomplir cette tâche. Lisez la suite et choisissez celle qui vous convient le mieux.
Comment extraire des e-mails de Gmail vers Google Sheets ?
Commençons par une solution moyenne qui comprend trois étapes principales :
- Exporter les données de Gmail sous forme de fichier MBOX (e-mails) ou JSON (paramètres utilisateur).
- Convertir le fichier exporté en fichier CSV.
- Importer le fichier CSV dans Google Sheets.
N’hésitez pas à passer à la section suivante, « Exporter Gmail vers Google Sheets en utilisant l’API », si vous ne voulez pas vous embêter avec cela.
Étape 1 : Exporter les données de Gmail en utilisant Google Takeout
Sélectionner les données
Allez sur takeout.google.com et cliquez sur « Tout désélectionner ».
Maintenant, faites défiler vers le bas et sélectionnez « Courrier ».
Si vous ne souhaitez pas exporter toutes les données de votre boîte de réception Gmail, cliquez sur le bouton « Toutes les données de courrier incluses », désélectionnez « Inclure tous les messages dans Courrier » et sélectionnez l’étiquette spécifique pour votre exportation. Cliquez sur « OK » en haut à droite.
Après cela, vous pouvez cliquer sur le bouton « Étape suivante » en bas.
Sélectionner le type de fichier, la fréquence et la destination
Sélectionnez « Méthode de livraison » :
- Envoyer le lien de téléchargement par e-mail
- Ajouter à Google Drive
- Ajouter à Dropbox
- Ajouter à OneDrive
- Ajouter à Box
Sélectionnez « Fréquence » :
- Exporter une fois
- Exporter tous les deux mois pendant 1 an
Sélectionnez le « Type de fichier » (.zip ou .tgz) et sa « taille » (1, 2, 4, 10 ou 50 Go).
Créer l’exportation
Cliquez sur le bouton « Créer l’exportation », et Google commencera à créer une copie des fichiers de votre boîte de réception Gmail. Ce processus peut prendre du temps en fonction de la quantité de données à exporter. Vous recevrez un e-mail lorsque votre exportation sera terminée. Et voici à quoi cela ressemble une fois terminé.
Maintenant, vous devez télécharger le fichier MBOX sur votre appareil. Si vous avez sélectionné l’option d’exportation vers un stockage en ligne, vous pourrez l’ouvrir à partir de là. Par exemple, voici à quoi cela ressemble avec Google Drive :
Étape 2 : Convertir le fichier exporté en CSV
Malheureusement, vous ne pouvez pas importer de fichiers MBOX dans Google Sheets. Mais cela ne signifie pas que vous ne pouvez pas exporter les e-mails Gmail vers Google Sheets.
Étape 3 : Importer le CSV pour extraire les dates et le contenu des e-mails Gmail vers Google Sheets
La dernière étape consiste à importer le fichier CSV résultant dans Google Sheets. Ouvrez votre feuille de calcul, allez dans « Fichier » => « Importer » et téléchargez le fichier CSV avec vos données Gmail. Voici à quoi ressemble le résultat de notre exportation des e-mails Gmail vers Google Sheets :
Franchement, nous n’aimons pas cette option car elle est manuelle, fastidieuse et dépendante du convertisseur MBOX vers CSV. Voyons quelques autres solutions.
Exporter Gmail vers Google Sheets en utilisant l’API (SANS CODAGE)
Certaines personnes peuvent être effrayées par le terme « API », mais c’est l’option la plus pratique pour relier Gmail et Google Sheets. De plus, avec Coupler.io, vous n’aurez pas besoin de faire du codage. La solution se compose des étapes suivantes :
- Activer l’API Gmail et obtenir les informations d’identification.
- Obtenir un jeton d’accès OAuth Google.
- Extraire les données de Gmail vers Google Sheets.
Activer l’API Gmail et obtenir les informations d’identification
Nous avons besoin du jeton d’accès pour accéder à Gmail et aux autres services Google (si nécessaire) via l’API. Cela nous permettra de connecter Gmail à Google Sheets pour un flux de données direct. Suivez les instructions ci-dessous pour obtenir votre jeton d’accès en moins de 5 minutes. Cela peut sembler compliqué, car Google a mis beaucoup d’efforts pour protéger vos données, mais essayez d’imaginer que vous êtes un pirate essayant de pénétrer dans le Pentagone :)
Étape 1 : Nouveau projet sur Google API Console
Utilisez ce lien pour créer un nouveau projet sur la console API de Google (connectez-vous à votre compte Google si nécessaire). Nommez votre projet et cliquez sur « Créer ».
Étape 2 : Activer l’API
Sélectionnez votre projet dans la liste déroulante, puis cliquez sur « Activer les API et les services ».
Sélectionnez l’API Gmail dans la bibliothèque d’API, car nous devons exporter Gmail vers Google Sheets. Cliquez ensuite sur « Activer ».
Cliquez sur « Créer des identifiants », puis accédez à l’écran de consentement de l’API OAuth.
Étape 3 : Configurer l’écran de consentement OAuth
Sélectionnez « Externe » comme type d’utilisateur et cliquez sur « Créer ».
Configurez les paramètres suivants :
-
« Informations sur l’application »
- « Nom de l’application » – insérez le nom de l’application demandant le consentement (par exemple, Coupler.io ou Personnel)
- « Adresse e-mail d’assistance utilisateur » – sélectionnez votre adresse e-mail
-
« Informations de contact du développeur »
- « Adresse e-mail » – insérez votre adresse e-mail
Cliquez sur « Enregistrer et continuer ».
Sur la page « Portées », vous n’avez pas besoin de configurer quoi que ce soit, cliquez donc simplement sur « Enregistrer et continuer ».
Sur la page « Utilisateurs de test », cliquez sur « Ajouter des utilisateurs » et insérez votre adresse e-mail. Vous pouvez également spécifier d’autres utilisateurs si nécessaire, puis cliquez sur « Ajouter ». Ensuite, cliquez sur « Enregistrer et continuer ».
Sur la page « Résumé », cliquez sur « Retour au tableau de bord ».
Étape 4 : Créer les informations d’identification
Accédez au menu « Informations d’identification » et cliquez sur « Créer des informations d’identification ». Choisissez « ID client OAuth ».
Choisissez « Application Web » comme type d’application, nommez-la si vous le souhaitez (ou vous pouvez laisser le nom par défaut), et ajoutez une URL de redirection autorisée : https://coupler.io
Cliquez sur « Créer ». Vous obtiendrez votre « ID client » et votre « Secret client » :
Nous aurons besoin de ces informations d’identification, alors copiez-les dans un éditeur de texte et cliquez sur « OK ».
Comment obtenir un jeton d’accès OAuth Google pour connecter Gmail à Google Sheets
Étape 1 : Obtenir un code d’autorisation
Insérez votre « ID client » et votre « URL de redirection » dans l’URL suivante :
https://accounts.google.com/o/oauth2/auth?scope=https://www.googleapis.com/auth/gmail.readonly&response_type=code&access_type=offline&redirect_uri={insérez-votre-url-de-redirection}&client_id={insérez-votre-id-client}Assurez-vous d’insérer vos informations d’identification sans espaces.
Vous devriez obtenir quelque chose comme ceci :
https://accounts.google.com/o/oauth2/auth?scope=https://www.googleapis.com/auth/gmail.readonly&response_type=code&access_type=offline&redirect_uri=https://coupler.io&client_id=221534350000-6964132idj4haiu2vmrmuu58rccgl7k1.apps.googleusercontent.comCopiez l’URL et collez-la dans une fenêtre de navigation privée de votre navigateur, puis appuyez sur Entrée. Vous devrez vous connecter à votre compte Google et accorder à Coupler.io l’autorisation de voir vos messages et paramètres e-mail.
Cliquez sur « Autoriser » et vous serez redirigé vers la page d’accueil de Coupler.io. Copiez le code de l’URL dans la barre d’adresse.
Ne copiez pas l’intégralité de l’URL – extrayez simplement le code qui se trouve entre « code= » et « & ».
Voici ce à quoi cela peut ressembler :
4/0AY0e-g4nBNGM-JV6i2O3arpY-9T5LsfZWGCAvmU9Lzc8kYko7mBvyYmDTNX2Py-NXMtvWgLe code d’autorisation est nécessaire pour obtenir un jeton d’accès OAuth Google.
Étape 2 : Obtenir un jeton d’accès OAuth Google
Pour obtenir un jeton d’accès, vous devez envoyer une requête POST en utilisant le modèle d’URL suivant :
https://accounts.google.com/o/oauth2/token?grant_type=authorization_code&code={votre-code-d'autorisation}&client_id={votre-id-client}&client_secret={votre-secret-client}&redirect_uri={votre-url-de-redirection}{votre-code-d'autorisation}– Insérez le code d’autorisation obtenu à l’étape précédente{votre-id-client}– Insérez votre ID client{votre-secret-client}– Insérez votre secret client{votre-url-de-redirection}– Insérez votre URL de redirection
Voici à quoi doit ressembler l’URL :
https://accounts.google.com/o/oauth2/token?grant_type=authorization_code&code=4%2F0AY0e-g6N37embD-8RPXRk2D3cg6t8PoTmn37JOYj9TMAKPa5W289Q8hHY7t6pR3kBtRjQg&client_id=221534350000-6964132idj4haiu2vmrmuu58rccgl7k1.apps.googleusercontent.com&client_secret=Ol_dCEoCn1C168Eb91d9ERY7&redirect_uri=https://coupler.ioPour envoyer une requête POST, nous utiliserons Postman, une application Google Chrome permettant d’interagir avec les API HTTP. Procédez comme suit :
- Entrez l’URL de la requête dans le champ correspondant.
- Changez le type de requête de GET à POST.
- Cliquez sur « Envoyer ».
Voici la réponse avec votre jeton d’accès et votre jeton de rafraîchissement :
{
"access_token": "ya29.a0ARr...",
"expires_in": 3600,
"refresh_token": "1//09f...N",
"scope": "https://www.googleapis.com/auth/gmail.readonly",
"token_type": "Bearer"
}Remarque : Les jetons d’accès OAuth Google expirent au bout d’une heure !
Une fois qu’il a expiré, vous devrez répéter les étapes 1 et 2 pour en obtenir un nouveau. Vous pouvez également utiliser le jeton de rafraîchissement pour mettre à jour le jeton d’accès et l’obtenir directement dans vos feuilles de calcul Google, comme suit.
Étape 3 : Automatiser la mise à jour du jeton d’accès OAuth Google dans Google Sheets
Connectez-vous à Coupler.io, cliquez sur le bouton « + Ajouter un importateur » et choisissez « JSON Client » comme source d’application. Vous pouvez également nommer votre importateur comme vous le souhaitez. Cliquez sur « Continuer ».
Insérez l’URL JSON suivante dans le champ « URL JSON ». N’oubliez pas de spécifier les paramètres mis en évidence.
https://accounts.google.com/o/oauth2/token?grant_type=refresh_token&refresh_token={votre-jeton-de-rafraîchissement}&client_id={votre-id-client}&client_secret={votre-secret-client}&redirect_uri={votre-url-de-redirection}{votre-jeton-de-rafraîchissement}– Insérez le jeton de rafraîchissement obtenu à l’étape précédente{votre-id-client}– Insérez votre ID client{votre-secret-client}– Insérez votre secret client{votre-url-de-redirection}– Insérez votre URL de redirection
Cliquez sur « Continuer ».
Sélectionnez « POST » comme méthode HTTP et cliquez sur « Continuer vers les paramètres de destination ».
Dans la section « Destination », vous devez :
- Sélectionner votre compte Google
- Sélectionner une feuille de calcul existante et une feuille pour importer les données
Cliquez sur « Continuer vers les paramètres de planification ».
Comme le jeton d’accès OAuth Google expire en une heure, nous allons définir un intervalle d’une heure pour notre importateur afin de mettre à jour votre jeton d’accès toutes les heures.
La dernière chose à faire est de cliquer sur « Enregistrer et exécuter ». Vous aurez désormais toujours un jeton d’accès valide dans votre feuille de calcul.
Extraire des données de Gmail vers Google Sheets
En utilisant le jeton d’accès OAuth Google, nous pouvons exporter Gmail vers Google Sheets en utilisant Coupler.io, de la même manière que ci-dessus. Les données suivantes sont disponibles :
| Type de données | Ressource d’URL JSON |
|---|
Vous pouvez vous reporter à la documentation de l’API Gmail pour plus d’informations sur les ressources et les paramètres disponibles.
Vous devrez créer une URL JSON en utilisant l’URL de base de Gmail attachée à la ressource de la table :
https://gmail.googleapis.com/gmail/v1/users/{utilisateurId}/{ressource}{utilisateurId}: votre adresse e-mail{ressource}: type de données à exporter
Insérez l’URL JSON dans le champ JSON URL et cliquez sur « Continuer ».
Sélectionnez « GET » comme méthode HTTP et insérez la chaîne suivante dans le champ « URL de la requête » :
Authorization: Bearer {votre-jeton-d'accès}{votre-jeton-d'accès}: insérez votre jeton d’accès
Dans le champ « Chaîne de requête d’URL », vous pouvez utiliser le paramètre « q: ». Il vous permet de rechercher des e-mails spécifiques. Par exemple :
q: from:[email protected] is:unreadPour en savoir plus, consultez la documentation de l’API.
Ensuite, vous devrez choisir la destination et la planification de l’importation et exécuter votre importateur. Les données seront extraites de Gmail vers Google Sheets. Voyons cela dans l’exemple ci-dessous.
Exemple d’exportation d’e-mails Gmail vers Google Sheets
Nous allons connecter Gmail à Google Sheets pour exporter une liste d’e-mails provenant d’un expéditeur spécifique. Pour cela, nous aurons besoin des paramètres suivants :
URL JSON : https://gmail.googleapis.com/gmail/v1/users/{id-utilisateur}/messages/
Méthode HTTP : GET
En-têtes HTTP : Authorization: Bearer {votre-jeton-d'accès}
Chaîne de requête d’URL : q:from:{adresse-e-mail-de-l-expéditeur}
Voici à quoi ressemble le flux :
Pouvez-vous automatiser l’exportation de Gmail vers Google Sheets ?
La courte durée de validité du jeton d’accès OAuth ne vous permet pas de profiter de toutes les fonctionnalités de la mise à jour automatique des données par Coupler.io. Cependant, vous pouvez utiliser notre modèle d’exportation de Gmail vers Google Sheets avec les importateurs prédéfinis.
Pour cela, vous devez installer le complément Coupler.io depuis le Google Workspace Marketplace, obtenir les informations d’identification de l’API Gmail ainsi que le jeton de rafraîchissement, et suivre les instructions expliquées dans la feuille de présentation.
Si vous avez besoin de cette intégration Gmail vers Google Sheets prête à l’emploi, faites-le nous savoir en remplissant ce formulaire. Nous travaillons toujours sur de nouveaux importateurs et nous avons besoin de votre avis sur celui que nous devons sortir ensuite.
Exporter les contacts Gmail vers Google Sheets
L’API Gmail ne vous permet pas d’exporter les contacts. Pour cela, vous devez activer l’API People et ajouter une portée correspondante à votre application, et cela fonctionnera. Voici ce que vous devez faire brièvement :
Étape 1 : Activer l’API People
Le processus est identique à celui que nous avons suivi pour l’API Gmail. Sélectionnez l’API Google People dans la bibliothèque d’API et cliquez sur « Activer ».
Remarque : Vous n’avez pas besoin de créer de nouvelles informations d’identification, car vous les avez déjà.
Étape 2 : Obtenir un code d’autorisation
Insérez votre « ID client » et votre « URL de redirection » dans l’URL suivante, avec la portée mise à jour :
https://accounts.google.com/o/oauth2/auth?scope=https://www.googleapis.com/auth/contacts&response_type=code&access_type=offline&redirect_uri={votre-url-de-redirection}&client_id={votre-id-client}Le reste du processus est identique :
- Copiez l’URL et collez-la dans une fenêtre de navigation privée, puis appuyez sur Entrée.
- Obtenez le code d’autorisation et utilisez-le pour obtenir les jetons d’accès et de rafraîchissement OAuth Google, comme nous l’avons fait précédemment.
Étape 3 : Importer les adresses e-mail de Gmail vers Google Sheets
Avec un nouveau jeton d’accès, vous pouvez vous rendre sur Coupler.io, connecter Gmail à Google Sheets et utiliser les paramètres suivants pour obtenir vos contacts Gmail :
URL JSON : https://people.googleapis.com/v1/people/me/connections?personFields=names,emailAddresses
Méthode HTTP : GET
En-têtes HTTP : Authorization: Bearer {votre-jeton-d'accès}
Cliquez sur « Enregistrer et exécuter », et accueillez vos contacts Gmail dans votre feuille de calcul.
Autres options pour importer Gmail vers Google Sheets
Dans cet article de blog, nous n’avons pas abordé l’option « Script App », car nous avons promis d’expliquer comment importer Gmail vers Google Sheets sans codage. Cependant, si cette solution vous intéresse, nous pouvons l’ajouter ultérieurement. Faites-nous savoir si cela vous intéresse et bonne chance avec vos données !
