Das Kontingent wird anhand eines gleitenden 60-Sekunden-Durchschnitts überprüft, der Nutzungsspitzen zulässt. Standardmäßig unterliegt die Classroom API den Beschränkungen, die in der folgenden Tabelle aufgeführt sind:
| Limit | Standardkontingent |
|---|---|
| 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 je nach Betriebsfaktoren erhöht oder verringert werden.
Wenn Sie mehr Anfragen senden müssen, als für Ihr Projekt gelten, gehen Sie so vor:
- Zuerst müssen Sie auf wiederholbare Fehler reagieren (z. B. den Fehler
RESOURCE_EXHAUSTED, der zurückgegeben wird, wenn eine Anfrage Ihre Limits überschreitet), indem Sie die Anfrage wiederholen, vorzugsweise unter Verwendung eines exponentiellen Backoffs. - Wenn Sie Änderungen auf einem Endpunkt abfragen, an dem dies angeboten wird, sollten Sie stattdessen Push-Benachrichtigungen verwenden.
- Wenn Sie noch mehr Anfragen als die Ihrem Projekt zugewiesenen Limits senden müssen, 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-Konsole in der API-Bibliothek die Seite „Aktivierte APIs“ 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.