Google Sheets Add-on

E-Mail-Listen direkt in Google Sheets validieren. Ganze Spalten mit einem Klick massenweise prüfen, mit vollständiger Validierung auf SMTP-Ebene.

Add-on-Skript herunterladen

Holen Sie sich die Quelldateien des Google Apps Script. Installieren Sie sie manuell im Apps-Script-Editor oder stellen Sie sie als teilbares Add-on bereit.

ZIP herunterladen
email-validator-sheets.zip — 4 Dateien (Code.gs, sidebar.html, settings.html, appsscript.json)

Überblick

Das Email Validator for Google Sheets Add-on bringt die vollständige SMTP-E-Mail-Verifizierung direkt in Ihre Tabellen. Wählen Sie einen beliebigen Bereich mit E-Mail-Adressen aus, klicken Sie auf Validieren und erhalten Sie farbcodierte Ergebnisse direkt neben Ihren Daten, alles über die API von email-validaton.com.

Ideal für Datenteams, Marketer und Vertriebsteams, die E-Mail-Listen in Google Sheets verwalten. Schluss mit dem Export in externe Tools und dem manuellen Prüfen einzelner E-Mails.

So funktioniert es

1. Ihren API-Schlüssel verbinden

Holen Sie sich Ihren API-Schlüssel im Email Validator-Dashboard, und fügen Sie ihn anschließend in die Add-on-Einstellungen ein. Der Schlüssel wird sicher in Ihrem Google-Konto gespeichert und niemals weitergegeben.

2. E-Mails auswählen

Wählen Sie einen beliebigen Bereich mit E-Mail-Adressen aus oder verwenden Sie "Gesamte Spalte validieren", um automatisch jede E-Mail-Adresse in einer Spalte zu finden und zu verarbeiten. Das Add-on erkennt E-Mails auch in Zellen mit gemischten Inhalten.

3. Mit einem Klick validieren

Klicke auf Email Validator → Ausgewählte E-Mails validieren im Sheets-Menü. Jede E-Mail wird zur vollständigen SMTP-Prüfung an die API von email-validaton.com gesendet (MX-Abfrage, SMTP-Handshake, Postfachprüfung).

4. Farbcodierte Ergebnisse erhalten

Die Ergebnisse werden zwei Spalten rechts neben Ihrer Auswahl eingetragen. Jeder Status ist farblich markiert, damit Sie sie auf einen Blick erfassen.

Gültig (grün) Ungültig (rot) Riskant (bernstein) Catch-All (gelb) Wegwerf-Adresse (orange) Unbekannt (grau)

Zurückgegebene E-Mail-Status

Jede validierte E-Mail erhält einen der folgenden Status:

Status Bedeutung Credit-Kosten
valid E-Mail nimmt Post an (SMTP-250-Antwort vom Zielserver) 1 Credit
invalid E-Mail abgelehnt (SMTP 550), kein MX, ungültige Domain, ungültiges Format 1 Credit
risky Adresse mit schlechtem Ruf, auf der Graylist, temporäre Probleme 1 Credit
catch_all Server akzeptiert alle E-Mails – einzelne Postfächer können nicht geprüft werden Kostenlos
disposable Temporärer Wegwerf-E-Mail-Dienst (z. B. Mailinator) Kostenlos
unknown Nicht ermittelbar (Zeitüberschreitung, keine Antwort, Netzwerkfehler) Kostenlos
retry Temporärer Serverfehler – bitte später erneut versuchen Kostenlos

Installation

  1. Download die ZIP-Datei aus dem Download-Feld oben und entpacke sie.
  2. Öffne eine beliebige Google Sheets Tabelle.
  3. Öffnen Sie Erweiterungen → Apps Script.
  4. Lösche jeglichen Platzhalter-Code in der Standard-Code.gs file.
  5. Kopiere den Inhalt von Code.gs from the extracted files.
  6. Erstelle neue Dateien im Apps-Script-Editor:
    • appsscript.json — copy the manifest
    • sidebar.html — copy the sidebar UI
    • settings.html — copy the settings dialog
  7. Klicke auf die Speichern Schaltfläche oder drücke Strg+S.
  8. Lade dein Google Sheet neu – dann siehst du Email Validator im Hauptmenü.

Zukünftige Versionen werden direkt im Google Workspace Marketplace verfügbar sein.

Einrichtung

  1. Öffne Google Sheets, in dem du das Add-on installiert hast.
  2. Öffnen Sie Email Validator → Einstellungen aus dem Menü.
  3. Gib deinen API-Schlüssel von email-validaton.com/dashboard → Konto → API-Schlüssel.
  4. Klicke auf Speichern & Testen. Bei erfolgreicher Verbindung siehst du deinen Tarifnamen und dein Credit-Guthaben.
  5. Du kannst jetzt validieren!

Verwendung

Ausgewählte E-Mails validieren

  1. Markieren Sie Zellen, die E-Mail-Adressen enthalten (beliebiger Bereich).
  2. Öffnen Sie Email Validator → Ausgewählte E-Mails validieren.
  3. Bestätigen Sie die Anzahl der zu validierenden Zellen.
  4. Die Ergebnisse erscheinen 2 Spalten weiter rechts – Status, Konfidenz, MX-Server, Grund.

Gesamte Spalte validieren

  1. Klicken Sie auf eine beliebige Zelle in der Spalte mit E-Mail-Adressen.
  2. Öffnen Sie Email Validator → Gesamte Spalte validieren.
  3. Das Add-on erkennt automatisch alle E-Mail-Adressen in dieser Spalte und validiert sie.

Seitenleisten-Steuerungsfeld

Öffne Email Validator → Start um die Seitenleiste aufzurufen mit:

  • Aktueller Guthabenstand – verbleibende Guthaben stets im Blick
  • Tarifinformationen – welchen Tarif Sie nutzen
  • Validierung mit einem Klick— dieselben Optionen wie im Menü
  • Schneller Zugriff auf die Einstellungen — API-Schlüssel ändern

Voraussetzungen

  • Ein Google-Konto (privat oder Workspace)
  • Ein API-Schlüssel von email-validaton.com (kostenlose Registrierung erforderlich)
  • Guthaben oder ein Abonnementtarif für die Validierung:
    • Kostenloser Tarif — 100 Einzelprüfungen pro Monat
    • Credit-Pakete — Zahlung nach Verbrauch, Guthaben verfällt nie
    • Abonnement — monatliche automatische Verlängerung

Technische Architektur

API-Endpunkte im Einsatz

Endpunkt Methode Zweck
/api/v1/verify POST Eine einzelne E-Mail-Adresse validieren
/api/v1/account GET Kontodetails, Tarif und Guthaben abrufen
/api/v1/credits GET Schnelle Guthabenprüfung (schlanker Endpunkt)

Datenablauf

  1. Nutzer wählt einen E-Mail-Bereich in Google Sheets aus.
  2. Das Add-on extrahiert eindeutige E-Mail-Adressen aus der Auswahl.
  3. Guthabenprüfung über /api/v1/credits to ensure enough quota.
  4. E-Mails werden nacheinander über /api/v1/verify (POST).
  5. Ergebnisse (Status, Konfidenz, MX-Server, Grund) werden zurück in das Tabellenblatt geschrieben.
  6. Statuszellen sind farblich markiert, damit sie auf einen Blick erfasst werden können.

Ratenbegrenzung

Das Add-on verarbeitet E-Mails mit einer Taktung von ca. 1,6 Anfragen pro Sekunde, um die API-Ratenlimits einzuhalten und eine zuverlässige Zustellung zu gewährleisten. Bei großen Listen (bis zu 5.000 E-Mails) kann die Validierung mehrere Minuten dauern. Der Fortschritt wird in der Seitenleiste angezeigt.

OAuth-Bereiche

  • 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

Google Apps Script Runtime

  • Laufzeit: V8 (modernes JavaScript)
  • Maximale Ausführungsdauer: 6 Minuten pro Aufruf
  • Speicherung des API-Schlüssels: UserProperties (sicher, pro Benutzer)
  • Keine externen Abhängigkeiten erforderlich

Support

← Zurück zu allen Add-ons