Module complémentaire Google Sheets

Validez vos listes d'e-mails directement dans Google Sheets. Vérification en masse en un clic de colonnes entières avec une validation complète au niveau SMTP.

Télécharger le script du module complémentaire

Téléchargez les fichiers source Google Apps Script. Installez-les manuellement depuis l'éditeur Apps Script ou déployez-les sous forme de module complémentaire partageable.

Télécharger le ZIP
email-validator-sheets.zip — 4 fichiers (Code.gs, sidebar.html, settings.html, appsscript.json)

Présentation

Le module complémentaire Email Validator pour Google Sheets apporte une vérification SMTP complète des e-mails directement dans vos feuilles de calcul. Sélectionnez une plage d'adresses e-mail, cliquez sur valider et obtenez des résultats codés par couleur inscrits à côté de vos données, le tout grâce à l'API email-validaton.com.

Idéal pour les équipes data, marketing et commerciales qui gèrent des listes d'e-mails dans Google Sheets. Plus besoin d'exporter vers des outils externes ni de vérifier les e-mails un par un.

Comment ça marche

1. Connecter votre clé API

Obtenez votre clé API depuis le Tableau de bord Email Validator, puis collez-la dans les paramètres de l'extension. La clé est stockée de manière sécurisée dans votre compte Google et n'est jamais partagée.

2. Sélectionnez vos e-mails

Sélectionnez une plage contenant des adresses e-mail, ou utilisez « Valider toute la colonne » pour trouver et traiter automatiquement chaque e-mail d'une colonne. L'extension détecte les e-mails dans les cellules à contenu mixte.

3. Validez en un clic

Cliquez sur Email Validator → Valider les e-mails sélectionnés dans le menu Sheets. Chaque e-mail est envoyé à l'API email-validaton.com pour une vérification SMTP complète (recherche MX, poignée de main SMTP, vérification de la boîte aux lettres).

4. Obtenez des résultats codés par couleur

Les résultats sont inscrits deux colonnes à droite de votre sélection. Chaque statut est codé par couleur pour une lecture visuelle immédiate.

Valide (vert) Invalide (rouge) Risqué (ambre) Catch-all (jaune) Jetable (orange) Inconnu (gris)

Statuts d'e-mail renvoyés

Chaque e-mail validé reçoit l'un des statuts suivants :

Statut Signification Coût en crédits
valid L'adresse accepte les e-mails (réponse SMTP 250 du serveur de destination) 1 crédit
invalid Adresse rejetée (SMTP 550), pas de MX, domaine incorrect, format invalide 1 crédit
risky Adresse à faible réputation, en liste grise, problèmes temporaires 1 crédit
catch_all Le serveur accepte tous les e-mails : impossible de vérifier chaque boîte aux lettres Gratuit
disposable Service d'e-mail temporaire/jetable (par ex. Mailinator) Gratuit
unknown Impossible à déterminer (délai dépassé, pas de réponse, erreur réseau) Gratuit
retry Défaillance temporaire du serveur : réessayez plus tard Gratuit

Installation

  1. Télécharger le fichier ZIP de la zone de téléchargement ci-dessus et extrayez-le.
  2. Ouvrez n'importe quelle Google Sheets feuille de calcul.
  3. Rendez-vous dans Extensions → Apps Script.
  4. Supprimez tout code de remplacement présent dans le Code.gs file.
  5. Copiez et collez le contenu de Code.gs from the extracted files.
  6. Créez de nouveaux fichiers dans l'éditeur Apps Script :
    • appsscript.json — copy the manifest
    • sidebar.html — copy the sidebar UI
    • settings.html — copy the settings dialog
  7. Cliquez sur l'icône Enregistrer ou appuyez sur Ctrl+S.
  8. Rechargez votre feuille Google Sheets — vous verrez Email Validator dans le menu principal.

Les prochaines versions seront disponibles directement sur la Google Workspace Marketplace.

Configuration

  1. Ouvrez Google Sheets là où vous avez installé le complément.
  2. Rendez-vous dans Email Validator → Paramètres dans le menu.
  3. Saisissez votre clé API depuis email-validaton.com/dashboard → Compte → Clés API.
  4. Cliquez sur Enregistrer et tester. Vous verrez le nom de votre forfait et votre solde de crédits en cas de connexion réussie.
  5. Vous êtes prêt à valider !

Utilisation

Valider les e-mails sélectionnés

  1. Sélectionnez les cellules contenant des adresses e-mail (plage quelconque).
  2. Rendez-vous dans Email Validator → Valider les e-mails sélectionnés.
  3. Confirmez le nombre de cellules à valider.
  4. Les résultats apparaissent 2 colonnes à droite : statut, niveau de confiance, serveur MX, motif.

Valider toute la colonne

  1. Cliquez sur n'importe quelle cellule de la colonne contenant des e-mails.
  2. Rendez-vous dans Email Validator → Valider toute la colonne.
  3. Le module complémentaire détecte automatiquement toutes les adresses e-mail de cette colonne et les valide.

Panneau de configuration latéral

Ouvrir Email Validator → Démarrer pour accéder au panneau latéral avec :

  • Solde de crédits en temps réel — consultez toujours les crédits restants
  • Informations sur le forfait — le forfait auquel vous êtes abonné
  • Validation en un clic — les mêmes options que dans le menu
  • Accès rapide aux paramètres — modifier la clé API

Prérequis

  • Un compte Google (personnel ou Workspace)
  • Un clé API sur email-validaton.com (inscription gratuite requise)
  • Crédits ou forfait d'abonnement pour la validation :
    • Offre gratuite — 100 vérifications unitaires par mois
    • Packs de crédits — paiement à l'utilisation, les crédits n'expirent jamais
    • Abonnement — renouvellement automatique mensuel

Architecture technique

Points de terminaison API utilisés

Point de terminaison Méthode Objectif
/api/v1/verify POST Valider une adresse e-mail
/api/v1/account GET Récupérer les détails du compte, le forfait et le solde de crédits
/api/v1/credits GET Vérification rapide des crédits (point de terminaison léger)

Flux de données

  1. L'utilisateur sélectionne une plage d'e-mails dans Google Sheets.
  2. Le module complémentaire extrait les adresses e-mail uniques de la sélection.
  3. Vérification des crédits via /api/v1/credits to ensure enough quota.
  4. Les e-mails sont validés un par un via /api/v1/verify (POST).
  5. Les résultats (statut, niveau de confiance, serveur MX, motif) sont réinscrits dans la feuille.
  6. Les cellules de statut sont codées par couleur pour une lecture visuelle immédiate.

Limitation du débit

Le module complémentaire traite les e-mails à un rythme d'environ 1,6 requête par seconde afin de respecter les limites de débit de l'API et d'assurer une livraison fiable. Pour les listes volumineuses (jusqu'à 5 000 e-mails), la validation peut prendre plusieurs minutes. La progression s'affiche dans la barre latérale.

Périmètres OAuth

  • spreadsheets.currentonly — read/write the current spreadsheet only
  • script.container.ui — display sidebar and modal dialogs
  • script.external_request — call the email-validaton.com API

Environnement d'exécution Google Apps Script

  • Environnement d'exécution : V8 (JavaScript moderne)
  • Durée d'exécution maximale : 6 minutes par invocation
  • Stockage de la clé API : UserProperties (sécurisé, par utilisateur)
  • Aucune dépendance externe requise

Assistance

← Retour à tous les add-ons