Gmail-API-Ratenlimits und Kontingent erklärt

Die Gmail-API ist Googles offizielle Schnittstelle, kein IMAP- oder SMTP-Scraping

Die Gmail-API ist eine REST-Schnittstelle, die Google für Drittanbieter-Apps veröffentlicht und dokumentiert. Sie ist eine andere Technologie als IMAP oder SMTP, die älteren Mailprotokolle, die von generischen E-Mail-Clients verwendet werden.

Clean Email unterstützt nur Gmail (private @gmail.com-Konten und Google-Workspace-Konten), weil es speziell für diese API entwickelt wurde. Outlook, Yahoo Mail, iCloud Mail und andere generische IMAP-Postfächer werden aus demselben Grund nicht unterstützt.

• Der Zugriff wird über die Google-OAuth-2.0-Anmeldung gewährt — Clean Email sieht oder speichert niemals Ihr Google-Passwort.
• Jede Aktion (Scannen, Zählen, Löschen) läuft über einen dokumentierten Gmail-API-Endpunkt, nicht über eine rohe Protokollverbindung.
• Da es sich um dieselbe API handelt, die Google jedem Entwickler zur Verfügung stellt, unterliegt Clean Email denselben veröffentlichten Ratenlimits wie jede andere Gmail-API-App.

Welche Gmail-API-Endpunkte Clean Email aufruft

Eine Bereinigung nutzt eine kleine Anzahl von Endpunkten, die jeweils in Googles Gmail-API-Referenz dokumentiert sind.

• messages.list — findet die IDs von Nachrichten, die Clean Emails Scan-Suchanfrage entsprechen, also der Anfrage, die geschützte E-Mails ausschließt (zum Beispiel -is:starred -has:attachment -in:sent). Es werden nur IDs zurückgegeben, kein Nachrichteninhalt.
• messages.get (Format metadata) — ruft nur Header, Labels, Größe und Thread-ID jeder Nachricht ab. Clean Email fragt niemals den Nachrichtentext ab.
• messages.trash / batchModify — der Standard-Löschweg: verschiebt passende Nachrichten in den Gmail-Papierkorb, wo sie 30 Tage lang wiederherstellbar bleiben.
• messages.batchDelete — wird nur für die optionale, ausdrückliche Opt-in-Funktion zum endgültigen Löschen verwendet, wie im Batch-Delete-Leitfaden von Google dokumentiert. Dies ist unwiderruflich.

Kontingenteinheiten der Gmail-API und Sekundenlimits

Die Gmail-API zählt nicht nur Anfragen — sie berechnet jeden Aufruf in 'Kontingenteinheiten', und günstige Aufrufe kosten weniger als teure. Googles Gmail-API-Referenz ist die maßgebliche Quelle für aktuelle Werte; die folgenden Zahlen sind die dort veröffentlichten.

• Google kann diese Kosten pro Methode im Laufe der Zeit ändern — betrachten Sie immer die Gmail-API-Referenz als aktuelle Quelle der Wahrheit, nicht diese Seite.

Wie die blockweise Verarbeitung von Clean Email innerhalb des Kontingents bleibt

Ein Postfach mit Zehntausenden von E-Mails kann nicht in einem einzigen riesigen API-Aufruf bereinigt werden, ohne das Sekundenlimit des Kontingents zu riskieren. Clean Email teilt große Bereinigungen in kleinere Blöcke auf, statt alle Anfragen auf einmal abzufeuern.

Wenn Gmail bei einem bestimmten Aufruf mit einem Ratenlimit-Fehler antwortet, wiederholt Clean Email diesen Block, statt die gesamte Bereinigung abzubrechen. Deshalb kann ein sehr großes Postfach länger brauchen, um in sichtbaren Etappen fertig zu werden, statt sofort abgeschlossen zu sein — das ist erwartetes Verhalten, kein Fehler.

FAQ

Wie hoch ist das Ratenlimit der Gmail-API?

Googles veröffentlichter Standardwert liegt bei 250 Kontingenteinheiten pro Nutzer und Sekunde, gemessen als gleitender Durchschnitt, sodass kurze Spitzen über diesem Wert erlaubt sind. Jedes Google-Cloud-Projekt hat außerdem ein eigenes tägliches Gesamtkontingent, das in der Google Cloud Console eingesehen und erhöht werden kann. Die aktuellen Zahlen finden Sie in Googles Gmail-API-Referenz.

Nutzt Clean Email IMAP oder SMTP, um auf mein Gmail zuzugreifen?

Nein. Clean Email verbindet sich mit Gmail ausschließlich über Googles offizielle Gmail-API mit OAuth-Anmeldung. Es meldet sich nie bei einem IMAP- oder SMTP-Server an und durchsucht Ihr Postfach niemals direkt.

Wie viele Kontingenteinheiten kostet das Löschen von E-Mails?

Lesevorgänge wie messages.list und messages.get kosten jeweils wenige Kontingenteinheiten (5 Einheiten pro Aufruf, laut Googles veröffentlichter Tabelle), während eine Massenaktion wie messages.batchDelete pro Aufruf mehr kostet (50 Einheiten), weil sie viele Nachrichten gleichzeitig bearbeiten kann. Google kann diese Zahlen aktualisieren, daher ist die Gmail-API-Referenz die maßgebliche Quelle.

Warum dauert eine große Gmail-Bereinigung länger als erwartet?

Sehr große Postfächer werden in Blöcken statt in einer einzigen riesigen Anfrage verarbeitet, damit die Bereinigung innerhalb der Sekunden- und Projektkontingentlimits von Gmail bleibt. Das bedeutet, eine riesige Bereinigung wird in Etappen statt sofort abgeschlossen, verhindert aber auch, dass sie komplett fehlschlägt oder gedrosselt wird.

Was passiert, wenn Gmail eine Anfrage während einer Bereinigung drosselt?

Die Gmail-API gibt einen Ratenlimit-Fehler zurück, wenn ein Aufrufer sein Kontingent zu einem bestimmten Zeitpunkt überschreitet. Die blockweise Verarbeitung von Clean Email ist so konzipiert, dass sie innerhalb dieser Grenzen bleibt, und wiederholt den betroffenen Block automatisch, statt den Lauf abzubrechen, sodass eine vorübergehende Drosselung nicht zu einer fehlgeschlagenen Bereinigung oder Datenverlust führt.

Kann Clean Email Outlook, Yahoo Mail oder iCloud Mail genauso bereinigen?

Nein. Clean Email unterstützt nur Gmail — private @gmail.com-Konten und Google-Workspace-Konten — über die Gmail-API. Outlook, Yahoo Mail, iCloud Mail und andere generische IMAP-Postfächer werden nicht unterstützt.