Das Kontingent wird anhand eines gleitenden Durchschnitts über 60 Sekunden geprüft, was Spitzen bei der Nutzung ermöglicht. Standardmäßig unterliegt die Classroom API den Limits in der folgenden Tabelle:
| Limit | Kontingentstandard |
|---|---|
| Abfragen pro Tag und Client | 4.000.000 (durchschnittlich 46 Abfragen pro Sekunde) |
| Abfragen pro Minute und Client | 3.000 (50 Abfragen pro Sekunde) |
| Abfragen pro Minute und Nutzer | 1.200 (20 Abfragen pro Sekunde) |
Die zulässige Anzahl von Abfragen pro Sekunde kann je nach einer Reihe von betrieblichen Faktoren erhöht oder verringert werden.
Wenn Sie mehr Anfragen stellen müssen, als die für Ihr Projekt geltenden Limits zulassen, haben Sie folgende Möglichkeiten:
- Achten Sie zuerst darauf, dass Sie auf wiederholbare Fehler (z. B. den Fehler
RESOURCE_EXHAUSTED, der zurückgegeben wird, wenn eine Anfrage Ihre Limits überschreitet) reagieren, indem Sie die Anfrage noch einmal senden, vorzugsweise mit exponentiellem Backoff. - Wenn Sie Änderungen an einem Endpunkt abrufen, an dem diese Funktion angeboten wird, sollten Sie stattdessen Push-Benachrichtigungen verwenden.
- Wenn Sie mehr Anfragen stellen müssen, als die Ihrem Projekt zugewiesenen Limits zulassen, finden Sie unten eine Anleitung zum Anfordern höherer Limits.
Wenn Sie die Nutzungslimits für Ihr Projekt aufrufen oder ändern bzw. eine Erhöhung Ihres Kontingents anfragen möchten, gehen Sie so vor:
- Wenn Sie für Ihr Projekt noch kein Rechnungskonto haben, erstellen Sie dieses.
- Rufen Sie in der API Console die Seite „Aktivierte APIs“ in der API-Bibliothek auf und wählen Sie eine API aus der Liste aus.
- Klicken Sie auf Kontingente, um die Einstellungen zum Kontingent aufzurufen und zu ändern. Klicken Sie auf Nutzung, um die Nutzungsstatistik einzublenden.