Gmail API-snelheidslimieten: waarom een grote opschoning pauzeert of vertraagt

Wat een Gmail API-snelheidslimiet eigenlijk is

Elke aanroep die een app doet naar de Gmail API — berichten opsommen, een label controleren, mail naar de Prullenbak verplaatsen — wordt gemeten in quota-eenheden en meegeteld voor een limiet, niet zomaar als één generieke „aanvraag”.

Google hanteert tegelijk twee aparte grenzen op die eenheden: één die specifiek aan jouw account is gekoppeld, en één die wordt gedeeld door alle accounts die met de app verbonden zijn. Wordt een van beide bereikt, dan vertraagt Google verdere aanvragen of houdt ze even tegen totdat het gebruik weer onder de grens zakt.

De exacte huidige kosten per eenheid en drempels worden door Google vastgesteld en gepubliceerd in de Gmail API-referentie, omdat ze in de loop van de tijd kunnen veranderen.

Waarom een enorme mailbox niet in één aanvraag kan worden opgeschoond

Een mailbox met tienduizenden of honderdduizenden e-mails kan niet in één API-aanroep worden opgesomd, gecontroleerd en naar de Prullenbak verplaatst. De batch-endpoints van Gmail hebben praktische grenzen aan hoeveel er in één aanvraag past, en alles in één keer versturen zou ook meteen de snelheidslimiet per minuut overschrijden.

Een volledige opschoning van een zeer grote mailbox moet daarom plaatsvinden als een reeks kleinere aanvragen, verspreid over tijd, in plaats van als één gigantische, directe actie.

Hoe Clean Email een grote opschoning in batches verdeelt

In plaats van te proberen een hele enorme mailbox in één keer te verwerken, werkt Clean Email deze in kleinere batches af, één voor één.

Elke batch wordt gescand en gecontroleerd volgens dezelfde beschermingsregels als elke andere opschoning — met een ster gemarkeerde, belangrijke, gelabelde mail, tweerichtingsgesprekken, bijlagen en afzenders op de witte lijst worden nooit aangeraakt — voordat er iets uit die batch naar de Prullenbak wordt verplaatst.

Omdat de mailbox in batches wordt opgedeeld in plaats van in één massale aanvraag, legt één enorme mailbox geen beslag op het volledige gedeelde projectquotum van de app. De scans en opschoningen van andere gebruikers blijven ondertussen gewoon doorlopen, en de grote opschoning gaat simpelweg batch voor batch door totdat de hele mailbox is verwerkt.

• De voortgang beweegt batch voor batch vooruit in plaats van in één keer
• Een pauze tussen batches bij een grote mailbox is normaal, geen storing
• Beschermingsregels worden bij elke batch opnieuw gecontroleerd voordat iets wordt verwijderd
• Opschoningen van andere gebruikers blijven tegelijkertijd doorlopen

Is een gepauzeerde of trage opschoning normaal?

Ja, bij een grote mailbox. Snelheidslimieten zorgen ervoor dat het opschonen van een enorme inbox langer duurt dan bij een kleine, en het kan lijken alsof het tussen batches stilvalt terwijl de mailbox wordt verwerkt.

Wat niet normaal is, is een opschoning die volledig stopt met vooruitgang boeken in plaats van na verloop van tijd in batches door te gaan. Als dat gebeurt, neem dan contact op via contact@clean-email.com.

Veelgestelde vragen

Waarom is mijn Gmail-opschoning halverwege gepauzeerd?

Gmail hanteert een snelheidslimiet op zijn API — een grens aan hoeveel aanvragen er per minuut mogen plaatsvinden, zowel voor jouw account als voor de app als geheel. Bij een grote mailbox verwerkt Clean Email e-mails in batches in plaats van allemaal tegelijk, waardoor een opschoning tussen batches gepauzeerd kan lijken. Dit is normaal gedrag bij een grote mailbox, geen fout, en de opschoning gaat gewoon door tot hij klaar is.

Wat is een Gmail API-snelheidslimiet?

Het is een grens die Google stelt aan hoeveel aanvragen een app binnen een bepaalde tijdspanne naar de Gmail API mag sturen. Aanvragen worden gemeten in quota-eenheden in plaats van een simpel aantal — acties zoals het opsommen van berichten of het verplaatsen van mail naar de Prullenbak verbruiken elk eenheden — en Google hanteert tegelijk zowel een grens per gebruiker als een grens per project (app-breed).

Waarom kan Clean Email niet meer dan 100.000 e-mails in één aanvraag verwijderen?

De Gmail API staat een app niet toe om een onbeperkt aantal berichten in één aanroep in te dienen, en dat zou ook meteen de snelheidslimiet per minuut breken. Clean Email verwerkt een enorme mailbox in plaats daarvan in kleinere batches, waarbij bij elke batch beschermingsregels zoals met een ster gemarkeerde, gelabelde en mail met bijlagen worden gecontroleerd voordat er iets naar de Prullenbak wordt verplaatst.

Blokkeert het opschonen van een enorme mailbox de opschoningen van andere gebruikers?

Nee. Clean Email verwerkt grote opschoningen in batches, zodat één zeer grote mailbox na verloop van tijd zijn eigen wachtrij van batches afwerkt in plaats van in één keer het volledige gedeelde Gmail API-quotum van de app op te gebruiken. De scans en opschoningen van andere gebruikers blijven tegelijkertijd doorlopen.

Hoe lang zou het opschonen van een zeer grote mailbox moeten duren?

Er is geen vast getal — het hangt af van hoeveel e-mails er verwerkt moeten worden en hoe het gedeelde Gmail API-quotum van de app op dat moment wordt gebruikt. Een mailbox met tienduizenden of honderdduizenden e-mails duurt doorgaans merkbaar langer dan een kleine inbox, omdat deze batch voor batch wordt verwerkt in plaats van in één directe doorloop.

Is een trage of gepauzeerde opschoning een teken dat er iets kapot is?

Niet op zichzelf. Een opschoning die batch voor batch vooruitgang blijft boeken — zelfs traag bij een zeer grote mailbox — is normaal gedrag veroorzaakt door de snelheidslimieten van Gmail, geen storing. Als een opschoning volledig stopt met vooruitgang boeken in plaats van in batches door te gaan, is het de moeite waard om dat te checken door contact op te nemen via contact@clean-email.com.