Limites de taxa da API do Gmail: por que uma grande limpeza pausa ou abranda

O que é realmente um limite de taxa da API do Gmail

Cada chamada que uma aplicação faz à API do Gmail — listar mensagens, verificar uma etiqueta, mover um email para o Lixo — é medida em unidades de quota e contabilizada face a um limite, e não simplesmente como um «pedido» genérico.

A Google aplica dois limites distintos sobre essas unidades ao mesmo tempo: um ligado especificamente à sua conta, outro partilhado por todas as contas ligadas à aplicação. Atingir qualquer um deles faz com que a Google abrande ou retenha brevemente os pedidos seguintes até o uso voltar a ficar abaixo do limite.

Os custos exatos em unidades e os limiares atuais são definidos pela Google e publicados na sua referência da API do Gmail, uma vez que podem ser ajustados ao longo do tempo.

Por que uma caixa de correio enorme não pode ser limpa num único pedido

Uma caixa de correio com dezenas ou centenas de milhares de emails não pode ser listada, verificada e movida para o Lixo numa única chamada à API. Os endpoints em lote do Gmail têm limites práticos sobre quanto pode caber num único pedido, e enviar tudo de uma vez também ultrapassaria imediatamente o limite de taxa por minuto.

Por isso, uma limpeza completa de uma caixa de correio muito grande tem de acontecer como uma série de pedidos mais pequenos, distribuídos ao longo do tempo, em vez de uma única operação gigante e instantânea.

Como o Clean Email divide uma grande limpeza em lotes

Em vez de tentar processar toda uma caixa de correio enorme de uma só vez, o Clean Email trata-a em lotes mais pequenos, um após o outro.

Cada lote é analisado e verificado segundo as mesmas regras de proteção de qualquer outra limpeza — emails marcados, importantes, com etiqueta, conversas bidirecionais, anexos e remetentes em lista branca nunca são tocados — antes de algo nesse lote ser movido para o Lixo.

Como a caixa de correio é dividida em lotes em vez de num único pedido massivo, uma caixa de correio enorme não monopoliza a quota partilhada por projeto da aplicação. As análises e limpezas de outros utilizadores continuam a decorrer em paralelo, e a grande limpeza simplesmente continua lote a lote até toda a caixa de correio ter sido processada.

• O progresso avança lote a lote em vez de tudo de uma vez
• Uma pausa entre lotes numa caixa de correio grande é esperada, não uma falha
• As regras de proteção são verificadas novamente em cada lote antes de algo ser eliminado
• As limpezas de outros utilizadores continuam a decorrer ao mesmo tempo

Uma limpeza pausada ou lenta é normal?

Sim, numa caixa de correio grande. Os limites de taxa fazem com que limpar uma caixa de entrada enorme demore mais do que uma pequena, e pode parecer que para entre lotes enquanto trabalha na caixa de correio.

O que não é normal é uma limpeza que deixa de progredir por completo em vez de continuar em lotes ao longo do tempo. Se isso acontecer, contacte contact@clean-email.com.

Perguntas frequentes

Por que é que a minha limpeza do Gmail pausou a meio?

O Gmail aplica um limite de taxa na sua API — um limite a quantos pedidos podem ocorrer por minuto, tanto para a sua conta como para a aplicação no seu todo. Numa caixa de correio grande, o Clean Email processa os emails em lotes em vez de todos de uma vez, por isso uma limpeza pode parecer pausada entre lotes. Este é um comportamento esperado numa caixa de correio grande, não um erro, e a limpeza vai continuar até terminar.

O que é um limite de taxa da API do Gmail?

É um limite que a Google impõe a quantos pedidos uma aplicação pode enviar à API do Gmail numa janela de tempo definida. Os pedidos são medidos em unidades de quota em vez de uma simples contagem — ações como listar mensagens ou mover emails para o Lixo consomem cada uma unidades — e a Google aplica ao mesmo tempo um limite por utilizador e um limite por projeto (em toda a aplicação).

Por que é que o Clean Email não consegue eliminar mais de 100 000 emails num único pedido?

A API do Gmail não permite que uma aplicação envie um número ilimitado de mensagens numa única chamada, e fazê-lo também quebraria de imediato o limite de taxa por minuto. Em vez disso, o Clean Email processa uma caixa de correio enorme em lotes mais pequenos, verificando regras de proteção como emails marcados, com etiqueta ou com anexos em cada lote antes de algo ser movido para o Lixo.

Limpar uma caixa de correio enorme vai bloquear as limpezas de outros utilizadores?

Não. O Clean Email processa as grandes limpezas em lotes, por isso uma caixa de correio muito grande avança na sua própria fila de lotes ao longo do tempo, em vez de esgotar de uma vez toda a quota partilhada da API do Gmail da aplicação. As análises e limpezas de outros utilizadores continuam a decorrer ao mesmo tempo.

Quanto tempo deve demorar a limpeza de uma caixa de correio muito grande?

Não há um número fixo — depende de quantos emails precisam de ser processados e de como a quota partilhada da API do Gmail da aplicação está a ser usada nesse momento. Uma caixa de correio com dezenas ou centenas de milhares de emails vai normalmente demorar bastante mais do que uma caixa de entrada pequena, porque é processada lote a lote em vez de numa única passagem instantânea.

Uma limpeza lenta ou pausada é sinal de que algo está avariado?

Não por si só. Uma limpeza que continua a progredir em lotes — mesmo que lentamente numa caixa de correio muito grande — é um comportamento normal causado pelos limites de taxa do Gmail, não uma avaria. Se uma limpeza deixar de progredir por completo em vez de continuar em lotes, vale a pena verificar contactando contact@clean-email.com.