Limites de débit et quota de l'API Gmail expliqués

L'API Gmail est l'interface officielle de Google, pas du scraping IMAP ou SMTP

L'API Gmail est une interface REST publiée et documentée par Google pour les applications tierces. C'est une technologie différente d'IMAP ou SMTP, les anciens protocoles de messagerie utilisés par les clients mail génériques.

Clean Email ne prend en charge que Gmail (comptes personnels @gmail.com et comptes Google Workspace) car il est conçu spécifiquement pour cette API. Outlook, Yahoo Mail, iCloud Mail et les autres boîtes IMAP génériques ne sont pas pris en charge pour la même raison.

• L'accès est accordé via la connexion Google OAuth 2.0 — Clean Email ne voit ni ne stocke jamais votre mot de passe Google.
• Chaque action (analyse, comptage, suppression) passe par un endpoint documenté de l'API Gmail, et non par une connexion en protocole brut.
• Comme il s'agit de la même API que Google expose à tout développeur, Clean Email est soumis aux mêmes limites de débit publiées que toute autre application utilisant l'API Gmail.

Quels endpoints de l'API Gmail Clean Email utilise

Un nettoyage utilise un petit nombre d'endpoints, chacun documenté dans la référence de l'API Gmail de Google.

• messages.list — trouve les identifiants des messages correspondant à la requête de recherche de Clean Email, celle qui exclut les emails protégés (par exemple -is:starred -has:attachment -in:sent). Il renvoie uniquement des identifiants, pas le contenu des messages.
• messages.get (format metadata) — récupère uniquement les en-têtes, libellés, taille et identifiant de fil de discussion de chaque message. Clean Email ne demande jamais le corps du message.
• messages.trash / batchModify — le mode de suppression par défaut : déplace les messages correspondants vers la Corbeille Gmail, où ils restent récupérables pendant 30 jours.
• messages.batchDelete — utilisé uniquement pour l'option facultative et explicite de suppression définitive, comme documenté dans le guide de suppression par lot de Google. Cette action est irréversible.

Unités de quota de l'API Gmail et limites par seconde

L'API Gmail ne se contente pas de compter les requêtes — elle facture chaque appel en « unités de quota », et les appels peu coûteux comptent moins que les appels coûteux. La référence de l'API Gmail de Google fait autorité pour les valeurs actuelles ; les chiffres ci-dessous sont ceux qu'elle publie.

• Google peut réviser ces coûts par méthode au fil du temps — considérez toujours la référence de l'API Gmail comme la source de vérité actuelle, pas cette page.

Comment le traitement par lots de Clean Email reste dans les limites du quota

Une boîte mail contenant des dizaines de milliers d'e-mails ne peut pas être nettoyée en un seul appel API géant sans risquer de dépasser la limite de quota par seconde. Clean Email divise les gros nettoyages en lots plus petits au lieu d'envoyer toutes les requêtes d'un coup.

Si Gmail répond avec une erreur de limite de débit sur un appel donné, Clean Email retente ce lot plutôt que d'annuler tout le nettoyage. C'est pourquoi une très grosse boîte mail peut prendre plus de temps à se terminer, par étapes visibles, plutôt que de se terminer instantanément — c'est un comportement attendu, pas un échec.

FAQ

Quelle est la limite de débit de l'API Gmail ?

La valeur par défaut publiée par Google est de 250 unités de quota par utilisateur et par seconde, mesurée en moyenne glissante, donc de brefs pics au-dessus de ce chiffre sont autorisés. Chaque projet Google Cloud dispose aussi de son propre quota quotidien global, consultable et modifiable dans la console Google Cloud. Consultez la référence de l'API Gmail de Google pour les chiffres actuels.

Clean Email utilise-t-il IMAP ou SMTP pour accéder à mon Gmail ?

Non. Clean Email se connecte à Gmail exclusivement via l'API Gmail officielle de Google, avec une connexion OAuth. Il ne se connecte jamais à un serveur IMAP ou SMTP et ne scrape jamais votre boîte mail directement.

Combien d'unités de quota coûte la suppression d'e-mails ?

Les appels de lecture comme messages.list et messages.get coûtent peu d'unités de quota chacun (5 unités par appel, selon le tableau publié par Google), tandis qu'une action en masse comme messages.batchDelete coûte plus par appel (50 unités) car elle peut agir sur de nombreux messages à la fois. Google peut mettre à jour ces chiffres, donc sa référence de l'API Gmail fait autorité.

Pourquoi un gros nettoyage Gmail prend-il plus de temps que prévu ?

Les très grosses boîtes mail sont traitées par lots plutôt qu'en une seule requête géante, afin que le nettoyage reste sous les limites de quota par seconde et par projet de Gmail. Cela signifie qu'un nettoyage volumineux se termine par étapes plutôt qu'instantanément, mais cela évite aussi qu'il échoue ou soit bloqué.

Que se passe-t-il si Gmail bloque une requête pendant un nettoyage ?

L'API Gmail renvoie une erreur de limite de débit si un appelant dépasse son quota à un moment donné. Le traitement par lots de Clean Email est conçu pour rester sous ces limites et retente automatiquement le lot concerné plutôt que d'annuler l'exécution, de sorte qu'un blocage temporaire n'entraîne ni échec du nettoyage ni perte de données.

Clean Email peut-il nettoyer Outlook, Yahoo Mail ou iCloud Mail de la même façon ?

Non. Clean Email ne prend en charge que Gmail — comptes personnels @gmail.com et comptes Google Workspace — via l'API Gmail. Outlook, Yahoo Mail, iCloud Mail et les autres boîtes IMAP génériques ne sont pas pris en charge.