Complemento para Google Sheets

Valide listas de e-mails diretamente no Google Sheets. Verificação em massa com um clique de colunas inteiras, com validação completa ao nível SMTP.

Transferir o script do complemento

Obtenha os ficheiros de origem do Google Apps Script. Instale manualmente a partir do editor do Apps Script ou implemente como complemento partilhável.

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

Visão geral

O Email Validator para Google Sheetscomplemento traz verificação SMTP completa de e-mails diretamente para as suas planilhas. Selecione qualquer intervalo de endereços de e-mail, clique em validar e obtenha resultados com código de cores escritos ao lado dos seus dados — tudo com a tecnologia da API do email-validaton.com.

Ideal para equipes de dados, profissionais de marketing e equipes de vendas que gerenciam listas de e-mail no Google Sheets. Chega de exportar para ferramentas externas ou verificar e-mails um a um manualmente.

Como Funciona

1. Conecte Sua Chave de API

Obtenha sua chave de API no Painel do Email Validator, depois cole-a nas configurações do complemento. A chave é armazenada com segurança na sua conta do Google e nunca é compartilhada.

2. Selecione Seus E-mails

Selecione qualquer intervalo que contenha endereços de e-mail ou use "Validar Coluna Inteira" para encontrar e processar automaticamente todos os e-mails de uma coluna. O complemento detecta e-mails em células com conteúdo misto.

3. Valide com um Clique

Clique em Email Validator → Validar E-mails Selecionados no menu do Sheets. Cada e-mail é enviado à API do email-validaton.com para verificação SMTP completa (consulta MX, handshake SMTP, verificação da caixa de entrada).

4. Obtenha Resultados com Código de Cores

Os resultados são escritos duas colunas à direita da sua seleção. Cada status recebe uma cor para facilitar a leitura visual instantânea.

Válido (verde) Inválido (vermelho) Arriscado (âmbar) Catch-all (amarelo) Descartável (laranja) Desconhecido (cinza)

Status de E-mail Retornados

Cada e-mail validado recebe um dos seguintes status:

Status Significado Custo em créditos
valid O e-mail aceita mensagens (resposta SMTP 250 do servidor de destino) 1 Credit
invalid E-mail rejeitado (SMTP 550), sem registro MX, domínio inválido, formato inválido 1 Credit
risky Endereço de baixa reputação, em greylist, problemas temporários 1 Credit
catch_all O servidor aceita todos os e-mails — não é possível verificar caixas individuais Grátis
disposable Serviço de e-mail temporário/descartável (ex.: Mailinator) Grátis
unknown Não foi possível determinar (tempo esgotado, sem resposta, erro de rede) Grátis
retry Falha temporária do servidor — tente novamente mais tarde Grátis

Instalação

  1. Descarregar o ficheiro ZIP na caixa de download acima e extraia-o.
  2. Abra qualquer Google Sheets folha de cálculo.
  3. Acesse Extensões → Apps Script.
  4. Elimine qualquer código de exemplo no Code.gs file.
  5. Copie e cole o conteúdo de Code.gs from the extracted files.
  6. Crie novos ficheiros no editor do Apps Script:
    • appsscript.json — copy the manifest
    • sidebar.html — copy the sidebar UI
    • settings.html — copy the settings dialog
  7. Clique no ícone Guardar ou prima Ctrl+S.
  8. Recarregue a sua folha do Google Sheets — verá Email Validator no menu principal.

As versões futuras estarão disponíveis diretamente no Google Workspace Marketplace.

Configuração

  1. Abra o Google Sheets onde instalou o add-on.
  2. Acesse Email Validator → Definições no menu.
  3. Introduza a sua chave de API de email-validaton.com/dashboard → Conta → Chaves de API.
  4. Clique em Guardar e testar. Verá o nome do seu plano e o saldo de créditos se a ligação for bem-sucedida.
  5. Está pronto para validar!

Utilização

Validar e-mails selecionados

  1. Selecione as células que contêm endereços de e-mail (qualquer intervalo).
  2. Acesse Email Validator → Validar E-mails Selecionados.
  3. Confirme o número de células a validar.
  4. Os resultados aparecem 2 colunas à direita — estado, confiança, servidor MX, motivo.

Validar coluna inteira

  1. Clique em qualquer célula da coluna que contém e-mails.
  2. Acesse Email Validator → Validar coluna inteira.
  3. O complemento deteta automaticamente todos os endereços de e-mail dessa coluna e valida-os.

Painel de controlo lateral

Abra Email Validator → Iniciar para aceder à barra lateral com:

  • Saldo de créditos em tempo real — veja sempre os créditos restantes
  • Informações do plano — o escalão em que se encontra
  • Validação com um clique — as mesmas opções do menu
  • Acesso rápido às definições — alterar a chave de API

Requisitos

  • Uma conta Google (pessoal ou Workspace)
  • Uma chave de API de email-validaton.com (é necessário registo gratuito)
  • Créditos ou um plano de subscrição para validação:
    • Plano Gratuito— 100 verificações individuais por mês
    • Pacotes de Créditos — pagamento por uso, os créditos nunca expiram
    • Subscrição — renovação automática mensal

Arquitetura Técnica

Endpoints da API Utilizados

Endpoint Método Finalidade
/api/v1/verify POST Validar um único endereço de e-mail
/api/v1/account GET Obter detalhes da conta, plano e saldo de créditos
/api/v1/credits GET Verificação rápida de créditos (endpoint leve)

Fluxo de Dados

  1. O usuário seleciona um intervalo de e-mails no Google Sheets.
  2. O complemento extrai os endereços de e-mail únicos da seleção.
  3. Verificação de créditos via /api/v1/credits to ensure enough quota.
  4. Os e-mails são validados um a um via /api/v1/verify (POST).
  5. Os resultados (status, confiabilidade, servidor MX, motivo) são gravados de volta na planilha.
  6. As células de status são codificadas por cores para facilitar a leitura visual imediata.

Limite de Requisições

O complemento processa os e-mails em um ritmo de ~1,6 requisição por segundo para respeitar os limites de taxa da API e garantir uma entrega confiável. Para listas grandes (até 5.000 e-mails), a validação pode levar vários minutos. O progresso é exibido na barra lateral.

Escopos 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

Ambiente de Execução do Google Apps Script

  • Runtime: V8 (JavaScript moderno)
  • Execução máxima: 6 minutos por invocação
  • Armazenamento da chave de API: UserProperties (seguro, por utilizador)
  • Não requer dependências externas

Suporte

← Voltar a todos os add-ons