Limits und Kontingente schützen die Google-Infrastruktur vor einem automatisierten Prozess, der die Reports API auf unzulässige Weise verwendet. Übermäßig viele Anfragen von einer API können auf einen harmlosen Tippfehler zurückzuführen sein oder auf 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 notwendig, den Traffic von einer bestimmten Quelle zu blockieren, sobald er ein bestimmtes Niveau erreicht. Es wird sichergestellt, dass sich die Handlungen eines Entwicklers nicht negativ auf die gesamte Community auswirken.
Für den unwahrscheinlichen Fall, dass Ihre API-Anfrage fehlschlägt, erhalten Sie einen HTTP-Statuscode. Der Statuscode 403 enthält Fehlerinformationen über eine falsche Eingabe und der HTTP-Statuscode 503 Fehlerinformationen, die angeben, welche API-Kontingente überschritten wurden. Anhand dieser Antworten kann Ihre benutzerdefinierte Anwendung diese Fehler erkennen und entsprechende Maßnahmen ergreifen.
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. Ein Beispiel für parallele Anfragen besteht darin, kleine Batches von E-Mails von verschiedenen Nutzern anzufordern, anstatt viele E-Mails von einem Nutzer gleichzeitig hinzuzufügen oder zu entfernen. Beginnen Sie bei Threads mit zehn Threads – einem Thread pro Nutzer-E-Mail. Hinweis: 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.
Bei allen Fehlern, die zeitbasiert sind (maximal N Dinge für N Sekunden pro Thread), insbesondere die Fehler des Statuscodes 503, sollte der Code die Ausnahme abfangen und mithilfe eines exponentiellen Backoff-Algorithmus eine kleine Verzögerung warten, bevor der fehlgeschlagene Aufruf wiederholt wird. Ein Reports API-Beispiel für einen Thread besteht darin, fünf 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 Anforderung nicht erfolgreich ist, sollte Ihre Anwendung die Häufigkeit der Anforderung reduzieren, bis der 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 die Wiederholung fest. Sie können beispielsweise eine Anfrage fünf- bis siebenmal mit unterschiedlichen Verzögerungszeiten wiederholen, bevor Ihre Anwendung einen Fehler an den Nutzer zurückgibt.
| API-Grenzwertkategorien | Einschränkungen |
|---|---|
| QPS- und QPD-Raten melden | Die API begrenzt die Anzahl der Anfragen für Ihr Google Cloud-Projekt.
Der Standardwert in der Google Cloud Console ist 2.400 Abfragen pro Minute,Nutzer und Google Cloud-Projekt.
Sie können dieses Limit in Ihrem Google Cloud-Projekt auf der Seite Kontingente für die Admin SDK API erhöhen.
Werden diese Limits überschritten, gibt der Server den HTTP-Statuscode 503 zurück. Verwenden Sie beim Wiederholen Ihrer Anfragen den Algorithmus für exponentiellen Backoff. |
| API-Kontingentkategorien | Kontingente |
| Ergebnisse | Die Anzahl der Datensätze, die auf jeder Seite der Antwort einer API aufgeführt sind, liegt zwischen 1 und 1.000 Ereignissen. Der Standardwert ist 1.000 Datensätze. |
| Andere Arten von Limits | Einschränkungen und Richtlinien |
|---|---|
| Datenformat, Standard | Das Standarddatenformat ist JSON. Die API unterstützt auch das Atom-Format. |
| Nicht autorisierte Anfragen | Google gestattet keine nicht autorisierten Anfragen an die API. Eine Anfrage gilt als nicht autorisiert, wenn kein Autorisierungstoken angegeben wird. Weitere Informationen finden Sie unter Anfragen autorisieren. |
| Warnmeldungen |
|