Límites de frecuencia y cuota de la API de Gmail, explicados

La API de Gmail es la interfaz oficial de Google, no scraping por IMAP o SMTP

La API de Gmail es una interfaz REST que Google publica y documenta para aplicaciones de terceros. Es una tecnología distinta de IMAP o SMTP, los protocolos de correo más antiguos que usan los clientes de correo genéricos.

Clean Email solo es compatible con Gmail (cuentas personales @gmail.com y cuentas de Google Workspace) porque está construido específicamente sobre esta API. Outlook, Yahoo Mail, iCloud Mail y otras bandejas IMAP genéricas no son compatibles por la misma razón.

• El acceso se concede mediante el inicio de sesión de Google OAuth 2.0: Clean Email nunca ve ni guarda tu contraseña de Google.
• Cada acción (escaneo, conteo, eliminación) pasa por un endpoint documentado de la API de Gmail, no por una conexión de protocolo directo.
• Como es la misma API que Google expone a cualquier desarrollador, Clean Email está sujeto a los mismos límites de frecuencia publicados que cualquier otra app que use la API de Gmail.

Qué endpoints de la API de Gmail usa Clean Email

Una limpieza usa un pequeño conjunto de endpoints, cada uno documentado en la referencia de la API de Gmail de Google.

• messages.list — encuentra los ID de los mensajes que coinciden con la consulta de búsqueda de Clean Email, la que excluye el correo protegido (por ejemplo -is:starred -has:attachment -in:sent). Solo devuelve ID, no el contenido de los mensajes.
• messages.get (formato metadata) — obtiene solo encabezados, etiquetas, tamaño e ID de hilo de cada mensaje. Clean Email nunca solicita el cuerpo del mensaje.
• messages.trash / batchModify — la vía de eliminación predeterminada: mueve los mensajes coincidentes a la Papelera de Gmail, donde permanecen recuperables durante 30 días.
• messages.batchDelete — se usa solo para la opción explícita y opcional de eliminación permanente, tal como se documenta en la guía de eliminación por lotes de Google. Esta acción es irreversible.

Unidades de cuota de la API de Gmail y límites por segundo

La API de Gmail no se limita a contar solicitudes: cobra cada llamada en 'unidades de cuota', y las llamadas baratas cuestan menos que las costosas. La referencia de la API de Gmail de Google es la fuente oficial de los valores actuales; las cifras siguientes son las que publica.

• Google puede revisar estos costes por método con el tiempo — considera siempre la referencia de la API de Gmail como la fuente de verdad actual, no esta página.

Cómo el procesamiento por lotes de Clean Email se mantiene dentro de la cuota

Una bandeja de entrada con decenas de miles de correos no se puede limpiar en una sola llamada API gigante sin arriesgarse a superar el límite de cuota por segundo. Clean Email divide las limpiezas grandes en bloques más pequeños en lugar de lanzar todas las solicitudes de golpe.

Si Gmail responde con un error de límite de frecuencia en una llamada concreta, Clean Email reintenta ese bloque en lugar de cancelar toda la limpieza. Por eso una bandeja de entrada muy grande puede tardar más en terminar, en etapas visibles, en lugar de completarse al instante — es el comportamiento esperado, no un fallo.

Preguntas frecuentes

¿Cuál es el límite de frecuencia de la API de Gmail?

El valor predeterminado publicado por Google es de 250 unidades de cuota por usuario y por segundo, medido como promedio móvil, por lo que se permiten picos breves por encima de esa cifra. Cada proyecto de Google Cloud también tiene su propia cuota diaria global, que se puede ver y aumentar en Google Cloud Console. Consulta la referencia de la API de Gmail de Google para conocer las cifras actuales.

¿Clean Email usa IMAP o SMTP para acceder a mi Gmail?

No. Clean Email se conecta a Gmail exclusivamente a través de la API oficial de Gmail de Google mediante inicio de sesión OAuth. Nunca inicia sesión en un servidor IMAP o SMTP ni hace scraping directo de tu bandeja de entrada.

¿Cuántas unidades de cuota cuesta eliminar correos?

Las llamadas de lectura como messages.list y messages.get cuestan pocas unidades de cuota cada una (5 unidades por llamada, según la tabla publicada por Google), mientras que una acción masiva como messages.batchDelete cuesta más por llamada (50 unidades) porque puede actuar sobre muchos mensajes a la vez. Google puede actualizar estas cifras, así que su referencia de la API de Gmail es la fuente oficial.

¿Por qué una limpieza grande de Gmail tarda más de lo esperado?

Las bandejas de entrada muy grandes se procesan por bloques en lugar de en una sola solicitud gigante, para que la limpieza se mantenga dentro de los límites de cuota por segundo y por proyecto de Gmail. Eso significa que una limpieza enorme termina por etapas en lugar de al instante, pero también evita que falle o sea bloqueada por completo.

¿Qué pasa si Gmail bloquea una solicitud durante una limpieza?

La API de Gmail devuelve un error de límite de frecuencia si quien llama supera su cuota en un momento dado. El procesamiento por lotes de Clean Email está diseñado para mantenerse dentro de esos límites y reintenta automáticamente el bloque afectado en lugar de cancelar la ejecución, de modo que un bloqueo temporal no provoca una limpieza fallida ni pérdida de datos.

¿Puede Clean Email limpiar Outlook, Yahoo Mail o iCloud Mail de la misma forma?

No. Clean Email solo es compatible con Gmail —cuentas personales @gmail.com y cuentas de Google Workspace— a través de la API de Gmail. Outlook, Yahoo Mail, iCloud Mail y otras bandejas IMAP genéricas no son compatibles.