Complemento para Google Sheets

Valida listas de correos electrónicos directamente en Google Sheets. Verificación masiva con un solo clic de columnas completas con validación SMTP completa.

Descarga el script del complemento

Obtén los archivos fuente de Google Apps Script. Instálalos manualmente desde el editor de Apps Script o impleméntalos como complemento compartible.

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

Descripción general

El complemento Email Validator para Google Sheets lleva la verificación SMTP completa de correos electrónicos directamente a tus hojas de cálculo. Selecciona cualquier rango de direcciones de correo, haz clic en validar y obtén resultados codificados por colores junto a tus datos, todo impulsado por la API de email-validaton.com.

Ideal para equipos de datos, marketing y ventas que gestionan listas de correos electrónicos en Google Sheets. Se acabó exportar a herramientas externas o comprobar los correos uno por uno.

Cómo funciona

1. Conecta tu clave de API

Obtén tu clave de API desde el Panel de Email Validator, y luego pégala en la configuración del complemento. La clave se guarda de forma segura en tu cuenta de Google y nunca se comparte.

2. Selecciona tus correos

Selecciona cualquier rango que contenga direcciones de correo electrónico, o usa "Validar columna completa" para encontrar y procesar automáticamente todos los correos de una columna. El complemento detecta correos en celdas con contenido mixto.

3. Valida con un solo clic

Haz clic en Email Validator → Validar correos seleccionados en el menú de Sheets. Cada correo se envía a la API de email-validaton.com para una verificación SMTP completa (búsqueda MX, protocolo SMTP y comprobación del buzón).

4. Obtén resultados codificados por colores

Los resultados se escriben dos columnas a la derecha de tu selección. Cada estado tiene un color para una lectura visual inmediata.

Válido (verde) No válido (rojo) Arriesgado (ámbar) Catch-all (amarillo) Desechable (naranja) Desconocido (gris)

Estados de correo devueltos

Cada correo validado recibe uno de los siguientes estados:

Estado Significado Coste en créditos
valid El correo acepta mensajes (respuesta SMTP 250 del servidor de destino) 1 crédito
invalid Correo rechazado (SMTP 550), sin MX, dominio incorrecto, formato no válido 1 crédito
risky Dirección de baja reputación, en lista gris o con problemas temporales 1 crédito
catch_all El servidor acepta todos los correos: no se pueden verificar buzones individuales Gratis
disposable Servicio de correo temporal o desechable (p. ej., Mailinator) Gratis
unknown No se pudo determinar (tiempo de espera agotado, sin respuesta o error de red) Gratis
retry Fallo temporal del servidor: inténtalo de nuevo más tarde Gratis

Instalación

  1. Descarga el archivo ZIP desde el cuadro de descarga de arriba y extráelo.
  2. Abre cualquier Google Sheetsspreadsheet.
  3. Ve a Extensiones → Apps Script.
  4. Elimina cualquier código de marcador de posición en el Code.gs file.
  5. Copia y pega el contenido de Code.gs from the extracted files.
  6. Crea archivos nuevos en el editor de Apps Script:
    • appsscript.json — copy the manifest
    • sidebar.html — copy the sidebar UI
    • settings.html — copy the settings dialog
  7. Haz clic en el icono Guardar o pulsa Ctrl+S.
  8. Vuelve a cargar tu hoja de Google Sheets: verás Email Validator en el menú principal.

Las próximas versiones estarán disponibles directamente desde Google Workspace Marketplace.

Configuración

  1. Abre Google Sheets donde instalaste el complemento.
  2. Ve a Email Validator → Configuración en el menú.
  3. Introduce tu clave de API desde email-validaton.com/dashboard → Cuenta → Claves de API.
  4. Haz clic en Guardar y probar. Si la conexión se realiza correctamente, verás el nombre de tu plan y el saldo de créditos.
  5. ¡Estás listo para validar!

Uso

Validar correos seleccionados

  1. Selecciona las celdas que contienen direcciones de correo electrónico (cualquier rango).
  2. Ve a Email Validator → Validar correos seleccionados.
  3. Confirma el número de celdas que se van a validar.
  4. Los resultados aparecen 2 columnas a la derecha: estado, nivel de confianza, servidor MX y motivo.

Validar columna completa

  1. Haz clic en cualquier celda de la columna que contiene correos electrónicos.
  2. Ve a Email Validator → Validar columna completa.
  3. El complemento detecta automáticamente todas las direcciones de correo electrónico de esa columna y las valida.

Panel de control lateral

Abre Email Validator → Iniciar para acceder a la barra lateral con:

  • Saldo de créditos en tiempo real — consulta siempre los créditos restantes
  • Información del plan — en qué nivel te encuentras
  • Validación con un clic — las mismas opciones que el menú
  • Acceso rápido a la configuración — cambiar la clave de API

Requisitos

  • Una cuenta de Google (personal o de Workspace)
  • Una clave API de email-validaton.com (se requiere registro gratuito)
  • Créditos o un plan de suscripción para la validación:
    • Plan gratuito — 100 verificaciones individuales al mes
    • Paquetes de Créditos — pago por uso, los créditos nunca caducan
    • Suscripción — renovación mensual automática

Arquitectura técnica

Endpoints de API utilizados

Endpoint Método Propósito
/api/v1/verify POST Validar una dirección de correo electrónico individual
/api/v1/account GET Obtener los detalles de la cuenta, el plan y el saldo de créditos
/api/v1/credits GET Comprobación rápida de créditos (endpoint ligero)

Flujo de datos

  1. El usuario selecciona un rango de correos electrónicos en Google Sheets.
  2. El complemento extrae las direcciones de correo electrónico únicas de la selección.
  3. Comprobación de créditos mediante /api/v1/credits to ensure enough quota.
  4. Los correos electrónicos se validan uno a uno mediante /api/v1/verify (POST).
  5. Los resultados (estado, confianza, servidor MX, motivo) se escriben de nuevo en la hoja.
  6. Las celdas de estado están codificadas por colores para una lectura visual instantánea.

Limitación de velocidad

El complemento procesa los correos electrónicos a un ritmo de ~1,6 solicitudes por segundo para respetar los límites de velocidad de la API y garantizar una entrega fiable. En listas grandes (hasta 5.000 correos electrónicos), la validación puede tardar varios minutos. El progreso se muestra en la barra lateral.

Ámbitos de 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

Entorno de ejecución de Google Apps Script

  • Entorno de ejecución: V8 (JavaScript moderno)
  • Ejecución máxima: 6 minutos por invocación
  • Almacenamiento de la clave de API: UserProperties (seguro, por usuario)
  • No se requieren dependencias externas

Soporte

← Volver a todos los complementos