Límites de solicitudes de la API de Gmail: por qué una limpieza grande se pausa o va más lenta

Qué es realmente un límite de solicitudes de la API de Gmail

Cada llamada que una app hace a la API de Gmail — listar mensajes, comprobar una etiqueta, mover un correo a la Papelera — se mide en unidades de cuota y se cuenta contra un límite, no simplemente como una «solicitud» genérica.

Google aplica dos topes distintos sobre esas unidades al mismo tiempo: uno vinculado específicamente a tu cuenta y otro compartido entre todas las cuentas conectadas a la app. Alcanzar cualquiera de los dos hace que Google ralentice o retenga brevemente las siguientes solicitudes hasta que el uso vuelva a bajar del tope.

Los costes exactos en unidades y los umbrales actuales los fija Google y se publican en su referencia de la API de Gmail, ya que pueden ajustarse con el tiempo.

Por qué un buzón enorme no se puede limpiar en una sola solicitud

Un buzón con decenas o cientos de miles de correos no se puede listar, comprobar y mover a la Papelera en una sola llamada a la API. Los endpoints por lotes de Gmail tienen límites prácticos sobre cuánto puede incluir una sola solicitud, y enviarlo todo de golpe también rebasaría de inmediato el límite de solicitudes por minuto.

Así que una limpieza completa de un buzón muy grande tiene que hacerse como una serie de solicitudes más pequeñas repartidas en el tiempo, en lugar de una única operación gigante e instantánea.

Cómo Clean Email divide en lotes una limpieza grande

En lugar de intentar procesar todo un buzón enorme de una sola vez, Clean Email lo va procesando en lotes más pequeños, uno tras otro.

Cada lote se analiza y se comprueba contra las mismas reglas de protección que cualquier otra limpieza — el correo destacado, importante, con etiqueta, las conversaciones bidireccionales, los adjuntos y los remitentes en la lista blanca nunca se tocan — antes de mover nada de ese lote a la Papelera.

Como el buzón se divide en lotes en lugar de en una sola solicitud masiva, un buzón enorme no acapara la cuota compartida por proyecto de la app. Los escaneos y limpiezas de otros usuarios siguen funcionando en paralelo, y la limpieza grande simplemente continúa lote a lote hasta que se ha procesado todo el buzón.

• El progreso avanza lote a lote en lugar de todo de golpe
• Una pausa entre lotes en un buzón grande es lo esperado, no un fallo
• Las reglas de protección se vuelven a comprobar en cada lote antes de eliminar nada
• Las limpiezas de otros usuarios siguen funcionando al mismo tiempo

¿Es normal que una limpieza esté pausada o vaya lenta?

Sí, en un buzón grande. Los límites de solicitudes hacen que limpiar una bandeja enorme tarde más que una pequeña, y puede parecer que se detiene entre lotes mientras va procesando el buzón.

Lo que no es normal es una limpieza que deja de avanzar por completo en lugar de seguir por lotes con el tiempo. Si eso ocurre, escribe a contact@clean-email.com.

Preguntas frecuentes

¿Por qué se pausó mi limpieza de Gmail a mitad de camino?

Gmail aplica un límite de solicitudes en su API — un tope de cuántas solicitudes pueden hacerse por minuto, tanto para tu cuenta como para la app en conjunto. En un buzón grande, Clean Email procesa los correos por lotes en lugar de todos a la vez, así que una limpieza puede parecer pausada entre lotes. Esto es un comportamiento esperado en un buzón grande, no un error, y la limpieza seguirá adelante hasta terminar.

¿Qué es un límite de solicitudes de la API de Gmail?

Es un tope que Google impone sobre cuántas solicitudes puede enviar una app a la API de Gmail en una ventana de tiempo determinada. Las solicitudes se miden en unidades de cuota en lugar de en un simple recuento — acciones como listar mensajes o mover correo a la Papelera consumen unidades cada una — y Google aplica a la vez un tope por usuario y un tope por proyecto (para toda la app).

¿Por qué Clean Email no puede eliminar más de 100.000 correos en una sola solicitud?

La API de Gmail no permite que una app envíe un número ilimitado de mensajes en una sola llamada, y hacerlo también rompería al instante el límite de solicitudes por minuto. Clean Email, en cambio, procesa un buzón enorme en lotes más pequeños, comprobando reglas de protección como correo destacado, con etiqueta o con adjuntos en cada lote antes de mover nada a la Papelera.

¿Limpiar un buzón enorme bloqueará las limpiezas de otros usuarios?

No. Clean Email procesa las limpiezas grandes por lotes, así que un buzón muy grande avanza en su propia cola de lotes con el tiempo en lugar de agotar de golpe toda la cuota compartida de la API de Gmail de la app. Los escaneos y limpiezas de otros usuarios siguen funcionando al mismo tiempo.

¿Cuánto debería tardar limpiar un buzón muy grande?

No hay un número fijo — depende de cuántos correos haya que procesar y de cómo se esté usando en ese momento la cuota compartida de la API de Gmail de la app. Un buzón con decenas o cientos de miles de correos normalmente tardará notablemente más que una bandeja pequeña, porque se procesa lote a lote en lugar de en una sola pasada instantánea.

¿Una limpieza lenta o pausada es señal de que algo está roto?

No por sí sola. Una limpieza que sigue avanzando por lotes — aunque sea lentamente en un buzón muy grande — es un comportamiento normal causado por los límites de solicitudes de Gmail, no un fallo. Si una limpieza deja de avanzar por completo en lugar de seguir por lotes, vale la pena comprobarlo escribiendo a contact@clean-email.com.