Limites de débit de l'API Gmail : pourquoi un gros nettoyage fait une pause ou ralentit

Ce qu'est réellement une limite de débit de l'API Gmail

Chaque appel qu'une application fait à l'API Gmail — lister des messages, vérifier un libellé, déplacer un email vers la Corbeille — est mesuré en unités de quota et compté par rapport à une limite, et non simplement comme une « requête » générique.

Google applique deux plafonds distincts sur ces unités en même temps : l'un lié spécifiquement à votre compte, l'autre partagé entre tous les comptes connectés à l'application. Atteindre l'un ou l'autre pousse Google à ralentir ou à retenir brièvement les requêtes suivantes jusqu'à ce que l'usage repasse sous le plafond.

Les coûts exacts en unités et les seuils actuels sont fixés par Google et publiés dans sa référence de l'API Gmail, car ils peuvent évoluer avec le temps.

Pourquoi une immense boîte mail ne peut pas être nettoyée en une seule requête

Une boîte mail contenant des dizaines ou des centaines de milliers d'emails ne peut pas être listée, vérifiée puis déplacée vers la Corbeille en un seul appel API. Les points d'accès par lots de Gmail ont des limites pratiques sur ce qu'une seule requête peut contenir, et tout envoyer d'un coup dépasserait aussitôt la limite de débit par minute.

Un nettoyage complet d'une très grande boîte mail doit donc se faire sous forme d'une série de requêtes plus petites, étalées dans le temps, plutôt qu'en une seule opération géante et instantanée.

Comment Clean Email découpe un gros nettoyage en lots

Plutôt que d'essayer de traiter toute une immense boîte mail en une seule passe, Clean Email la traite par lots plus petits, les uns après les autres.

Chaque lot est analysé et vérifié selon les mêmes règles de protection que n'importe quel autre nettoyage — les emails suivis, importants, portant un libellé, les conversations à double sens, les pièces jointes et les expéditeurs en liste blanche ne sont jamais touchés — avant que quoi que ce soit dans ce lot soit déplacé vers la Corbeille.

Comme la boîte mail est découpée en lots plutôt qu'en une seule requête massive, une immense boîte mail ne monopolise pas le quota partagé par projet de l'application. Les analyses et nettoyages des autres utilisateurs continuent en parallèle, et le gros nettoyage se poursuit simplement lot après lot jusqu'à ce que toute la boîte mail ait été traitée.

• La progression avance lot par lot plutôt que d'un seul coup
• Une pause entre les lots sur une grande boîte mail est normale, pas un échec
• Les règles de protection sont revérifiées à chaque lot avant toute suppression
• Les nettoyages des autres utilisateurs continuent de tourner en même temps

Un nettoyage en pause ou lent est-il normal ?

Oui, sur une grande boîte mail. Les limites de débit signifient que nettoyer une immense boîte de réception prend plus de temps qu'une petite, et cela peut donner l'impression de s'arrêter entre les lots pendant qu'il traite la boîte mail.

Ce qui n'est pas normal, c'est un nettoyage qui cesse totalement de progresser au lieu de continuer par lots dans le temps. Si cela arrive, contactez contact@clean-email.com.

FAQ

Pourquoi mon nettoyage Gmail s'est-il mis en pause en plein milieu ?

Gmail applique une limite de débit sur son API — un plafond sur le nombre de requêtes possibles par minute, à la fois pour votre compte et pour l'application dans son ensemble. Sur une grande boîte mail, Clean Email traite les emails par lots plutôt que d'un coup, donc un nettoyage peut sembler en pause entre les lots. C'est un comportement normal sur une grande boîte mail, pas une erreur, et le nettoyage va continuer et se terminer.

Qu'est-ce qu'une limite de débit de l'API Gmail ?

C'est un plafond que Google impose sur le nombre de requêtes qu'une application peut envoyer à l'API Gmail sur une période donnée. Les requêtes sont mesurées en unités de quota plutôt qu'en simple nombre — des actions comme lister des messages ou déplacer un email vers la Corbeille consomment chacune des unités — et Google applique à la fois un plafond par utilisateur et un plafond par projet (pour toute l'application) en même temps.

Pourquoi Clean Email ne peut-il pas supprimer plus de 100 000 emails en une seule requête ?

L'API Gmail n'autorise pas une application à soumettre un nombre illimité de messages en un seul appel, et le faire dépasserait aussi immédiatement la limite de débit par minute. Clean Email traite plutôt une immense boîte mail par lots plus petits, en vérifiant les règles de protection comme les emails suivis, avec libellé ou pièces jointes à chaque lot avant que quoi que ce soit soit déplacé vers la Corbeille.

Nettoyer une immense boîte mail va-t-il bloquer les nettoyages des autres utilisateurs ?

Non. Clean Email traite les gros nettoyages par lots, donc une très grande boîte mail avance dans sa propre file de lots au fil du temps au lieu d'utiliser d'un coup tout le quota Gmail partagé de l'application. Les analyses et nettoyages des autres utilisateurs continuent de tourner en même temps.

Combien de temps devrait prendre le nettoyage d'une très grande boîte mail ?

Il n'y a pas de durée fixe — cela dépend du nombre d'emails à traiter et de la façon dont le quota Gmail partagé de l'application est utilisé à ce moment-là. Une boîte mail avec des dizaines ou des centaines de milliers d'emails prendra généralement bien plus de temps qu'une petite boîte de réception, car elle est traitée lot par lot plutôt qu'en une seule passe instantanée.

Un nettoyage lent ou en pause est-il un signe que quelque chose est cassé ?

Pas en soi. Un nettoyage qui continue de progresser par lots — même lentement sur une très grande boîte mail — est un comportement normal causé par les limites de débit de Gmail, pas un dysfonctionnement. Si un nettoyage cesse totalement de progresser au lieu de continuer par lots, cela vaut la peine de vérifier en contactant contact@clean-email.com.