Groups Migration API: Limits und Kontingente

Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, der die Groups Migration API auf unangemessene Weise verwendet. Übermäßig viele Anfragen von einer API können auf einen harmlosen Tippfehler oder ein ineffizient gestaltetes System zurückzuführen sein, das unnötige API-Aufrufe durchführt. Unabhängig von der Ursache ist es für den Gesamtzustand des Google Workspace-Systems erforderlich, Traffic von einer bestimmten Quelle zu blockieren, sobald dieser ein bestimmtes Niveau erreicht.

Fehler bei API-Anfragen

Für den unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhält Ihre Anwendung eine Antwort mit dem HTTP-Statuscode. Der HTTP-Statuscode 403 enthält Fehlerinformationen zu falschen Eingaben. Der HTTP-Statuscode 503 enthält Fehlerinformationen, die angeben, welche API-Kontingente überschritten wurden. Mit diesen Antworten kann Ihre benutzerdefinierte Anwendung diese Fehler erkennen und entsprechende Maßnahmen ergreifen.

Zeitkritische Anfragen

Wenn Ihre Anfragen in einem bestimmten Zeitraum abgeschlossen werden müssen, senden Sie sie parallel oder verwenden Sie mehrere Threads in Ihrer Java- oder C#-Anwendung. Unterteilen Sie Ihre Anfragen beispielsweise nach Monaten oder einem anderen Zeitraum. Beginnen Sie bei Threads mit 10 Threads, einem Thread pro Anfrage. Die Thread-Empfehlung hat Nachteile und ist nicht für alle API-Situationen nützlich. Wenn die Anzahl der Anfragen zu hoch wird, treten Kontingentfehler auf.

Zeitbasierte Fehler

Bei allen zeitbasierten Fehlern (maximal N Dinge für X Sekunden pro Thread), insbesondere bei Fehlern im Statuscode 503, sollte der Code die Ausnahme abfangen und mithilfe eines exponentiellen Backoff-Algorithmus eine kleine Verzögerung warten, bevor Sie den fehlgeschlagenen Aufruf wiederholen. Ein Beispiel für die Groups Migration API für einen Thread besteht darin, 5 Sekunden zu warten und den fehlgeschlagenen Aufruf zu wiederholen. Wenn die Anfrage erfolgreich ist, wiederholen Sie dieses Muster für die anderen Threads. Wenn die zweite Anfrage nicht erfolgreich ist, sollte Ihre Anwendung die Häufigkeit der Anfrage so lange herunterskalieren, bis ein Aufruf erfolgreich ist. Erhöhen Sie beispielsweise die anfängliche Verzögerung von 5 Sekunden auf 10 Sekunden und wiederholen Sie den fehlgeschlagenen Aufruf. Legen Sie außerdem ein Limit für Wiederholungen fest. Beispiel: Wiederholen Sie eine Anfrage fünf bis siebenmal mit unterschiedlichen Verzögerungszeiten, bevor die Anwendung einen Fehler an den Nutzer zurückgibt.

Einschränkungen

API-Limitkategorien	Einschränkungen
Abfragen pro Sekunde (Queries per second, QPS)	Das Limit für Entwicklerprojekte liegt bei 10 Abfragen pro Sekunde pro Konto.

Kontingente

API-Kontingentkategorien	Kontingente
Maximale API-Anfragen pro Tag	Die maximale Anzahl von API-Anfragen pro Tag beträgt 500.000.
Archivierung, Ablauf von Nachrichten	Gruppenarchive laufen nicht ab. Nachrichten verbleiben in einem Archiv, bis die Gruppe gelöscht wird. Die Aufbewahrungsrichtlinie für E-Mails wirkt sich nicht auf Nachrichten im Archiv einer Gruppe aus.
Größe der E-Mail-Nachricht	Die maximale Größe einer E-Mail-Nachricht beträgt 25 MB. Dieses Limit umfasst die Metadatenheader, den Textkörper und alle Anhänge der Nachricht.

Andere Arten von Limits

Sonstige Limits	Einschränkungen und Richtlinien
Formate für Inhaltstypen	Eine E-Mail-Nachricht muss im standardmäßigen RFC 822-Textformat vorliegen. Beim Hochladen migrierter E-Mails muss der Inhaltstyp einer Anfrage den Header Content-type: message/rfc822 verwenden.
Datenformat in API-Antworten	Das Datenformat der Antwort ist JavaScript Object Notation (JSON).
Richtlinien für Speicherorte von Daten	Die Groups Migration API unterstützt keine Richtlinien für Speicherorte von Daten, die vorschreiben, dass Daten aus vertraglichen Gründen in bestimmten geografischen oder politischen Grenzen gespeichert werden müssen. Verwenden Sie die Groups Migration API nicht, wenn der Datenspeicherort für Ihr Konto erforderlich ist.
Parallele Einfügen von Nachrichten	Die Groups Migration API unterstützt parallele Anfragen zum Einfügen von E-Mails in verschiedene Gruppenarchive. Die Groups Migration API unterstützt jedoch nicht das parallele Einfügen von Nachrichten in dasselbe Gruppenarchiv. Außerdem werden Batchanfragen in dieser Version der Groups Migration API nicht unterstützt.
Nicht autorisierte Anfragen	Die Groups Migration API akzeptiert keine nicht autorisierten Anfragen. Eine Anfrage gilt als nicht autorisiert, wenn kein Autorisierungstoken angegeben ist. Weitere Informationen finden Sie unter Authentifizierung und Autorisierung.