Componente aggiuntivo per Google Sheets

Valida elenchi di email direttamente in Google Sheets. Verifica in blocco con un solo clic di intere colonne con validazione completa a livello SMTP.

Scarica lo script dell'add-on

Ottieni i file sorgente di Google Apps Script. Installali manualmente dall'editor di Apps Script oppure distribuiscili come add-on condivisibile.

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

Panoramica

L'add-on Email Validator per Google Sheets porta la verifica SMTP completa delle email direttamente nei tuoi fogli di calcolo. Seleziona un intervallo di indirizzi email, clicca su valida e ottieni risultati con codice colore scritti accanto ai tuoi dati, il tutto alimentato dall'API di email-validaton.com.

Perfetto per team dati, marketer e team commerciali che gestiscono liste di email in Google Sheets. Niente più esportazioni verso strumenti esterni né controlli manuali email per email.

Come funziona

1. Collega la tua chiave API

Ottieni la tua chiave API dal Dashboard di Email Validator, poi incollala nelle impostazioni del componente aggiuntivo. La chiave viene archiviata in modo sicuro nel tuo account Google e non viene mai condivisa.

2. Seleziona le tue email

Seleziona un intervallo qualsiasi contenente indirizzi email, oppure usa "Valida intera colonna" per trovare ed elaborare automaticamente ogni email in una colonna. Il componente aggiuntivo rileva le email anche nelle celle con contenuti misti.

3. Valida con un clic

Fai clic su Email Validator → Valida email selezionate dal menu di Fogli. Ogni email viene inviata all'API di email-validaton.com per una verifica SMTP completa (ricerca MX, handshake SMTP, verifica della casella di posta).

4. Ottieni risultati con codice colore

I risultati vengono scritti due colonne a destra della selezione. Ogni stato è colorato per una lettura visiva immediata.

Valida (verde) Non valida (rosso) Rischiosa (ambra) Catch-all (giallo) Usa e getta (arancione) Sconosciuta (grigio)

Stati email restituiti

Ogni email convalidata riceve uno dei seguenti stati:

Stato Significato Costo in crediti
valid L'indirizzo accetta la posta (risposta SMTP 250 dal server di destinazione) 1 credito
invalid Email rifiutata (SMTP 550), nessun MX, dominio non valido, formato non valido 1 credito
risky Indirizzo a bassa reputazione, in greylist, problemi temporanei 1 credito
catch_all Il server accetta tutte le email — impossibile verificare le singole caselle Gratis
disposable Servizio di email temporanea/usa e getta (es. Mailinator) Gratis
unknown Impossibile determinare (timeout, nessuna risposta, errore di rete) Gratis
retry Errore temporaneo del server: riprova più tardi Gratis

Installazione

  1. Scarica il file ZIP dalla casella di download qui sopra ed estraine il contenuto.
  2. Apri un foglio Google Sheets qualsiasi.
  3. Vai a Estensioni → Apps Script.
  4. Elimina il codice segnaposto presente nel file predefinito Code.gs file.
  5. Copia e incolla il contenuto di Code.gs from the extracted files.
  6. Crea nuovi file nell'editor di Apps Script:
    • appsscript.json — copy the manifest
    • sidebar.html — copy the sidebar UI
    • settings.html — copy the settings dialog
  7. Fai clic sull'icona Salva oppure premi Ctrl+S.
  8. Ricarica il tuo foglio Google: vedrai Email Validator nel menu principale.

Le versioni future saranno disponibili direttamente dal Google Workspace Marketplace.

Configurazione

  1. Apri Google Sheets dove hai installato il componente aggiuntivo.
  2. Vai a Email Validator → Impostazioni dal menu.
  3. Inserisci la tua chiave API da email-validaton.com/dashboard → Account → Chiavi API.
  4. Fai clic su Salva e verifica. Se la connessione riesce, vedrai il nome del tuo piano e il saldo dei crediti.
  5. Sei pronto a validare!

Utilizzo

Valida le email selezionate

  1. Seleziona le celle che contengono indirizzi e-mail (qualsiasi intervallo).
  2. Vai a Email Validator → Valida email selezionate.
  3. Conferma il numero di celle da convalidare.
  4. I risultati compaiono 2 colonne a destra: stato, affidabilità, server MX, motivo.

Convalida intera colonna

  1. Fai clic su una cella qualsiasi della colonna che contiene e-mail.
  2. Vai a Email Validator → Convalida intera colonna.
  3. Il componente aggiuntivo rileva automaticamente tutti gli indirizzi e-mail di quella colonna e li convalida.

Pannello di controllo laterale

Apri Email Validator → Avvia per accedere alla barra laterale con:

  • Saldo crediti in tempo reale — visualizza sempre i crediti rimanenti
  • Informazioni sul piano — il piano tariffario che stai utilizzando
  • Convalida con un clic — le stesse opzioni del menu
  • Accesso rapido alle impostazioni — modifica la chiave API

Requisiti

  • Un account Google (personale o Workspace)
  • Una chiave API da email-validaton.com (è richiesta la registrazione gratuita)
  • Crediti o un piano di abbonamento per la convalida:
    • Piano gratuito — 100 verifiche singole al mese
    • Pacchetti di crediti— pagamento a consumo, i crediti non scadono
    • Abbonamento— rinnovo mensile automatico

Architettura tecnica

Endpoint API utilizzati

Endpoint Metodo Finalità
/api/v1/verify POST Convalida un singolo indirizzo e-mail
/api/v1/account GET Recupera i dettagli dell'account, il piano e il saldo crediti
/api/v1/credits GET Verifica rapida dei crediti (endpoint leggero)

Flusso dei dati

  1. L'utente seleziona un intervallo di e-mail in Google Sheets.
  2. L'add-on estrae gli indirizzi e-mail unici dalla selezione.
  3. Verifica dei crediti tramite /api/v1/credits to ensure enough quota.
  4. Le e-mail vengono convalidate una alla volta tramite /api/v1/verify (POST).
  5. I risultati (stato, livello di affidabilità, server MX, motivo) vengono riscritti nel foglio.
  6. Le celle di stato sono colorate per una consultazione visiva immediata.

Limitazione della frequenza

L'add-on elabora le e-mail con una cadenza di circa 1,6 richieste al secondo per rispettare i limiti di frequenza delle API e garantire una consegna affidabile. Per liste di grandi dimensioni (fino a 5.000 e-mail), la convalida può richiedere diversi minuti. L'avanzamento viene mostrato nella barra laterale.

Ambiti 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

Runtime di Google Apps Script

  • Runtime: V8 (JavaScript moderno)
  • Esecuzione massima: 6 minuti per invocazione
  • Archiviazione della chiave API: UserProperties (sicuro, per utente)
  • Nessuna dipendenza esterna richiesta

Supporto

← Torna a tutti gli add-on