Das Kontingent wird anhand eines 60-Sekunden-Bewegungsdurchschnitts geprüft, was Spitzen bei der Nutzung zulässt. Für die Classroom API gelten standardmäßig die Limits in der folgenden Tabelle:
| Limit | Kontingentstandard |
|---|---|
| Abfragen pro Tag und Kunde | 4.000.000 (Durchschn. 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 in Abhängigkeit von verschiedenen Betriebsfaktoren erhöht oder verringert werden.
Wenn Sie mehr Anfragen senden müssen, als für Ihr Projekt gelten, gehen Sie so vor:
- Achten Sie zuerst darauf, dass Sie auf wiederholbare Fehler reagieren, z. B. den Fehler
RESOURCE_EXHAUSTED, der zurückgegeben wird, wenn eine Anfrage Ihre Limits überschreitet. Wiederholen Sie die Anfrage, vorzugsweise mit exponentiellem Backoff. - Wenn Sie Änderungen an einem Endpunkt abfragen, an dem dies 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“ 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.