Gmail API-snelheidslimieten en quotum uitgelegd

De Gmail API is Googles officiële interface, geen IMAP- of SMTP-scraping

De Gmail API is een REST-interface die Google publiceert en documenteert voor apps van derden. Dit is een andere technologie dan IMAP of SMTP, de oudere mailprotocollen die door generieke e-mailclients worden gebruikt.

Clean Email ondersteunt alleen Gmail (persoonlijke @gmail.com-accounts en Google Workspace-accounts) omdat het specifiek voor deze API is gebouwd. Outlook, Yahoo Mail, iCloud Mail en andere generieke IMAP-postvakken worden om dezelfde reden niet ondersteund.

• Toegang wordt verleend via het inloggen met Google OAuth 2.0 — Clean Email ziet of bewaart nooit je Google-wachtwoord.
• Elke actie (scannen, tellen, verwijderen) verloopt via een gedocumenteerd Gmail API-endpoint, niet via een rechtstreekse protocolverbinding.
• Omdat dit dezelfde API is die Google aan elke ontwikkelaar beschikbaar stelt, gelden voor Clean Email dezelfde gepubliceerde snelheidslimieten als voor elke andere app die de Gmail API gebruikt.

Welke Gmail API-endpoints Clean Email aanroept

Een opschoning gebruikt een klein aantal endpoints, elk gedocumenteerd in Googles Gmail API-referentie.

• messages.list — vindt de ID's van berichten die overeenkomen met Clean Email's scanquery, de query die beschermde e-mail uitsluit (bijvoorbeeld -is:starred -has:attachment -in:sent). Er worden alleen ID's teruggegeven, geen berichtinhoud.
• messages.get (metadata-formaat) — haalt alleen headers, labels, grootte en thread-ID van elk bericht op. Clean Email vraagt nooit de berichttekst zelf op.
• messages.trash / batchModify — het standaard verwijderpad: verplaatst overeenkomende berichten naar de Prullenbak van Gmail, waar ze 30 dagen herstelbaar blijven.
• messages.batchDelete — wordt alleen gebruikt voor de optionele, expliciete opt-in voor permanent verwijderen, zoals gedocumenteerd in Googles handleiding voor batchgewijs verwijderen. Dit is onomkeerbaar.

Gmail API-quotum-eenheden en limieten per seconde

De Gmail API telt niet alleen verzoeken — elke aanroep wordt in rekening gebracht in 'quotum-eenheden', en goedkope aanroepen kosten minder dan dure. Googles Gmail API-referentie is de gezaghebbende bron voor actuele waarden; onderstaande cijfers zijn wat daar gepubliceerd wordt.

• Google kan deze kosten per methode na verloop van tijd aanpassen — beschouw altijd de Gmail API-referentie als de actuele bron van waarheid, niet deze pagina.

Hoe de verwerking in blokken van Clean Email binnen het quotum blijft

Een postvak met tienduizenden e-mails kan niet in één gigantische API-aanroep worden opgeschoond zonder het risico op overschrijding van de quotumlimiet per seconde. Clean Email splitst grote opschoningen op in kleinere blokken in plaats van alle verzoeken in één keer te versturen.

Als Gmail bij een bepaalde aanroep reageert met een snelheidslimiet-fout, probeert Clean Email dat blok opnieuw in plaats van de hele opschoning af te breken. Daarom kan een zeer groot postvak langer duren om af te ronden, in zichtbare fasen, in plaats van meteen klaar te zijn — dat is verwacht gedrag, geen storing.

Veelgestelde vragen

Wat is de snelheidslimiet van de Gmail API?

De standaardwaarde die Google publiceert is 250 quotum-eenheden per gebruiker per seconde, gemeten als voortschrijdend gemiddelde, waardoor korte pieken daarboven zijn toegestaan. Elk Google Cloud-project heeft ook zijn eigen totale dagelijkse quotum, dat je kunt bekijken en verhogen in Google Cloud Console. Raadpleeg Googles Gmail API-referentie voor de actuele cijfers.

Gebruikt Clean Email IMAP of SMTP om toegang te krijgen tot mijn Gmail?

Nee. Clean Email maakt uitsluitend verbinding met Gmail via Googles officiële Gmail API met OAuth-login. Het logt nooit in op een IMAP- of SMTP-server en doorzoekt je postvak nooit rechtstreeks.

Hoeveel quotum-eenheden kost het verwijderen van e-mails?

Leesaanroepen zoals messages.list en messages.get kosten elk een klein aantal quotum-eenheden (5 eenheden per aanroep, volgens Googles gepubliceerde tabel), terwijl een bulkactie zoals messages.batchDelete meer per aanroep kost (50 eenheden) omdat er in één keer op veel berichten actie kan worden ondernomen. Google kan deze cijfers bijwerken, dus de Gmail API-referentie is de gezaghebbende bron.

Waarom duurt een grote Gmail-opschoning langer dan verwacht?

Zeer grote postvakken worden in blokken verwerkt in plaats van in één gigantisch verzoek, zodat de opschoning binnen de limieten per seconde en per project van Gmail blijft. Dat betekent dat een enorme opschoning in fasen wordt afgerond in plaats van meteen, maar het voorkomt ook dat deze volledig mislukt of wordt vertraagd.

Wat gebeurt er als Gmail een verzoek vertraagt tijdens een opschoning?

De Gmail API geeft een snelheidslimiet-fout terug als een aanroeper op een bepaald moment zijn quotum overschrijdt. De verwerking in blokken van Clean Email is zo gebouwd dat deze binnen die limieten blijft en probeert het getroffen blok automatisch opnieuw in plaats van de run af te breken, zodat een tijdelijke vertraging niet leidt tot een mislukte opschoning of gegevensverlies.

Kan Clean Email Outlook, Yahoo Mail of iCloud Mail op dezelfde manier opschonen?

Nee. Clean Email ondersteunt alleen Gmail — persoonlijke @gmail.com-accounts en Google Workspace-accounts — via de Gmail API. Outlook, Yahoo Mail, iCloud Mail en andere generieke IMAP-postvakken worden niet ondersteund.