Gmail API-Ratenlimits: Warum eine große Aufräumaktion pausiert oder langsamer wird

Was ein Gmail API-Ratenlimit eigentlich ist

Jeder Aufruf, den eine App an die Gmail-API richtet — Nachrichten auflisten, ein Label prüfen, E-Mails in den Papierkorb verschieben — wird in Kontingenteinheiten gemessen und auf ein Limit angerechnet, nicht einfach als eine generische „Anfrage“ gezählt.

Google setzt für diese Einheiten gleichzeitig zwei getrennte Obergrenzen durch: eine, die speziell an dein Konto gebunden ist, und eine, die sich alle mit der App verbundenen Konten teilen. Wird eine der beiden erreicht, verlangsamt Google weitere Anfragen oder hält sie kurz zurück, bis die Nutzung wieder unter die Grenze fällt.

Die genauen aktuellen Kosten pro Einheit und Schwellenwerte legt Google fest und veröffentlicht sie in seiner Gmail-API-Referenz, da sie sich im Laufe der Zeit ändern können.

Warum ein riesiges Postfach nicht in einer einzigen Anfrage bereinigt werden kann

Ein Postfach mit Zehntausenden oder Hunderttausenden E-Mails kann nicht in einem einzigen API-Aufruf aufgelistet, geprüft und in den Papierkorb verschoben werden. Die Batch-Endpunkte von Gmail haben praktische Grenzen dafür, wie viel in eine einzelne Anfrage passt, und alles auf einmal zu senden würde außerdem sofort das Ratenlimit pro Minute sprengen.

Eine vollständige Bereinigung eines sehr großen Postfachs muss deshalb als eine Reihe kleinerer, über die Zeit verteilter Anfragen ablaufen, statt als eine einzige riesige, sofortige Aktion.

Wie Clean Email eine große Aufräumaktion in Etappen aufteilt

Statt zu versuchen, ein ganzes riesiges Postfach in einem Durchgang zu verarbeiten, arbeitet Clean Email es in kleineren Etappen ab, eine nach der anderen.

Jede Etappe wird gescannt und gegen dieselben Schutzregeln geprüft wie jede andere Aufräumaktion — markierte, wichtige, mit Label versehene E-Mails, zweiseitige Konversationen, Anhänge und Absender auf der Positivliste werden nie angetastet — bevor irgendetwas aus dieser Etappe in den Papierkorb verschoben wird.

Weil das Postfach in Etappen statt in einer einzigen riesigen Anfrage aufgeteilt wird, beansprucht ein einzelnes riesiges Postfach nicht das gesamte gemeinsame Kontingent der App pro Projekt. Die Scans und Aufräumaktionen anderer Nutzer laufen währenddessen weiter, und die große Aufräumaktion setzt sich einfach Etappe für Etappe fort, bis das gesamte Postfach durchgearbeitet ist.

• Der Fortschritt bewegt sich Etappe für Etappe voran statt auf einen Schlag
• Eine Pause zwischen den Etappen bei einem großen Postfach ist zu erwarten, kein Fehler
• Die Schutzregeln werden bei jeder Etappe erneut geprüft, bevor etwas gelöscht wird
• Die Aufräumaktionen anderer Nutzer laufen gleichzeitig weiter

Ist eine pausierte oder langsame Aufräumaktion normal?

Ja, bei einem großen Postfach. Ratenlimits bedeuten, dass das Bereinigen eines riesigen Posteingangs länger dauert als bei einem kleinen, und es kann so wirken, als würde es zwischen den Etappen stocken, während das Postfach abgearbeitet wird.

Nicht normal ist eine Aufräumaktion, die komplett aufhört, Fortschritte zu machen, statt über die Zeit in Etappen weiterzulaufen. Wenn das passiert, wende dich an contact@clean-email.com.

FAQ

Warum ist meine Gmail-Aufräumaktion mittendrin pausiert?

Gmail setzt ein Ratenlimit für seine API durch — eine Obergrenze dafür, wie viele Anfragen pro Minute möglich sind, sowohl für dein Konto als auch für die App insgesamt. Bei einem großen Postfach verarbeitet Clean Email E-Mails in Etappen statt auf einmal, deshalb kann eine Aufräumaktion zwischen den Etappen pausiert wirken. Das ist bei einem großen Postfach zu erwartendes Verhalten, kein Fehler, und die Aufräumaktion läuft weiter, bis sie abgeschlossen ist.

Was ist ein Gmail API-Ratenlimit?

Es ist eine Obergrenze, die Google dafür festlegt, wie viele Anfragen eine App in einem bestimmten Zeitfenster an die Gmail-API senden darf. Anfragen werden in Kontingenteinheiten gemessen statt einfach gezählt — Aktionen wie das Auflisten von Nachrichten oder das Verschieben von E-Mails in den Papierkorb verbrauchen jeweils Einheiten — und Google setzt gleichzeitig eine Obergrenze pro Nutzer und eine Obergrenze pro Projekt (app-weit) durch.

Warum kann Clean Email nicht über 100.000 E-Mails in einer Anfrage löschen?

Die Gmail-API erlaubt es einer App nicht, eine unbegrenzte Anzahl von Nachrichten in einem einzigen Aufruf einzureichen, und das würde außerdem sofort das Ratenlimit pro Minute sprengen. Clean Email arbeitet ein riesiges Postfach stattdessen in kleineren Etappen ab und prüft bei jeder Etappe Schutzregeln wie markierte, mit Label versehene oder E-Mails mit Anhang, bevor irgendetwas in den Papierkorb verschoben wird.

Blockiert das Bereinigen eines riesigen Postfachs die Aufräumaktionen anderer Nutzer?

Nein. Clean Email verarbeitet große Aufräumaktionen in Etappen, sodass ein sehr großes Postfach über die Zeit seine eigene Warteschlange an Etappen abarbeitet, statt das gesamte gemeinsame Gmail-API-Kontingent der App auf einmal aufzubrauchen. Die Scans und Aufräumaktionen anderer Nutzer laufen gleichzeitig weiter.

Wie lange sollte das Bereinigen eines sehr großen Postfachs dauern?

Es gibt keine feste Zahl — es hängt davon ab, wie viele E-Mails verarbeitet werden müssen und wie das gemeinsame Gmail-API-Kontingent der App gerade genutzt wird. Ein Postfach mit Zehntausenden oder Hunderttausenden E-Mails braucht in der Regel spürbar länger als ein kleiner Posteingang, weil es Etappe für Etappe statt in einem einzigen sofortigen Durchgang abgearbeitet wird.

Ist eine langsame oder pausierte Aufräumaktion ein Zeichen dafür, dass etwas kaputt ist?

Nicht von sich aus. Eine Aufräumaktion, die weiterhin in Etappen voranschreitet — selbst langsam bei einem sehr großen Postfach — ist normales Verhalten, das durch Gmails Ratenlimits verursacht wird, keine Fehlfunktion. Wenn eine Aufräumaktion komplett aufhört, Fortschritte zu machen, statt in Etappen weiterzulaufen, lohnt es sich, das über contact@clean-email.com zu klären.