Da die Google Forms API ein gemeinsam genutzter Dienst ist, wenden wir Kontingente und Einschränkungen an, um eine faire Nutzung durch alle Nutzer zu gewährleisten und die allgemeine Integrität des Google Workspace-Systems zu schützen.
Wenn Sie ein Kontingent überschreiten, erhalten Sie in der Regel eine Antwort mit dem HTTP-Statuscode 429: Too many requests. In diesem Fall sollten Sie einen exponentiellen Backoff-Algorithmus verwenden und es später noch einmal versuchen. Solange Sie die unten aufgeführten Kontingente pro Minute einhalten, gibt es keine Beschränkung für die Anzahl der Anfragen, die Sie pro Tag stellen können.
Hinweis: Für Formularbeobachtungen gelten zusätzliche Einschränkungen. Weitere Informationen finden Sie unter Push-Benachrichtigungen einrichten und empfangen.
In der folgenden Tabelle sind die Anfragelimits aufgeführt:
| Kontingente | |||||||
|---|---|---|---|---|---|---|---|
| Leseanfragen |
|
||||||
|
Ressourcenintensive Leseanfragen
(Wird für |
|
||||||
| Schreibanfragen |
|
||||||
Zeitbasierte Kontingentfehler beheben
Bei allen zeitbasierten Fehlern (maximal N Anfragen pro X Minuten) empfehlen wir, dass Ihr Code die Ausnahme abfängt und einen abgeschnittenen exponentiellen Backoff verwendet, damit Ihre Geräte keine übermäßige Last erzeugen.
Der exponentielle Backoff ist eine Standardstrategie zur Fehlerbehandlung für Netzwerkanwendungen. Ein exponentieller Backoff-Algorithmus wiederholt Anfragen mit exponentiell zunehmenden Wartezeiten zwischen den Anfragen bis zur maximalen Backoff-Zeit. Wenn Anfragen weiterhin fehlschlagen, ist es wichtig, dass die Verzögerungen zwischen den Anfragen im Laufe der Zeit zunehmen, bis die Anfrage erfolgreich ist.
Beispielalgorithmus
Ein exponentieller Backoff-Algorithmus wiederholt Anfragen exponentiell und verlängert dabei die Wartezeit zwischen zwei Wiederholungen bis zur maximalen Backoff-Zeit. Beispiel:
- Anfrage an die Google Forms API senden
- Wenn die Anfrage fehlschlägt, wartet das System 1 +
random_number_millisecondsund wiederholt dann die Anfrage. - Wenn die Anfrage fehlschlägt, wartet das System 2 +
random_number_millisecondsSekunden und wiederholt dann die Anfrage. - Wenn die Anfrage fehlschlägt, wartet das System 4 +
random_number_millisecondsSekunden und wiederholt dann die Anfrage. - Und so weiter bis zur
maximum_backoff-Zeit. - Setzen Sie die Wartezeit fort und wiederholen Sie den Vorgang bis zu einer maximalen Anzahl an Wiederholungsversuchen. Erhöhen Sie jedoch nicht die Wartezeit zwischen den Wiederholungsversuchen.
Dabei gilt:
- Die Wartezeit beträgt
min(((2^n)+random_number_milliseconds), maximum_backoff), wobeinbei jeder Ausführung (Anfrage) um 1 erhöht wird. random_number_millisecondssteht für eine zufällige Anzahl von Millisekunden,deren Wert kleiner oder gleich 1.000 ist. So wird vermieden, dass viele Clients durch eine bestimmte Situation synchronisiert werden und alle gleichzeitig Wiederholungsversuche starten und Anfragen in synchronisierten Wellen senden. Der Wert vonrandom_number_millisecondswird nach jeder Anfragewiederholung neu berechnet.maximum_backoffist normalerweise 32 oder 64 Sekunden lang. Der geeignete Wert hängt vom jeweiligen Anwendungsfall ab.
Der Client kann den Vorgang wiederholen, nachdem er die maximum_backoff-Zeit erreicht hat.
Die Backoff-Zeit muss dabei nicht mehr verlängert werden. Wenn ein Client beispielsweise eine maximum_backoff-Zeit von 64 Sekunden verwendet, kann er den Vorgang nach Erreichen dieses Werts alle 64 Sekunden noch einmal versuchen. Sie sollten jedoch dafür sorgen, dass er dies nicht unbegrenzt tut.
Die Wartezeit zwischen den Wiederholungen und der Anzahl der Wiederholungen hängt von Ihrem Anwendungsfall und den Netzwerkbedingungen ab.
Preise
Die Standardnutzung der Google Forms API ist ohne zusätzliche Kosten möglich. Wenn Sie die Kontingentlimits für Anfragen überschreiten, fallen voraussichtlich im Laufe des Jahres 2026 Gebühren für Ihr Google Cloud-Rechnungskonto an. Weitere Informationen finden Sie unter Standardisiertes Google Workspace-Modell für Agent-Tools und APIs.
Kontingenterhöhung anfordern
Abhängig von der Ressourcennutzung Ihres Projekts möchten Sie möglicherweise eine Kontingentanpassung anfordern. API-Aufrufe durch ein Dienstkonto werden so behandelt, als würden sie von einem einzelnen Konto stammen. Wenn Sie ein angepasstes Kontingent beantragen, bedeutet dies nicht, dass Ihr Antrag auch genehmigt wird. Anfragen zur Kontingentanpassung, die den Kontingentwert erheblich erhöhen würden, können länger dauern, bis sie genehmigt werden.
Es gelten nicht für alle Projekte dieselben Kontingente. Wenn Sie Google Cloud mit der Zeit stärker nutzen, müssen Ihre Kontingentwerte möglicherweise erhöht werden. Falls Sie eine deutlich stärkere Auslastung erwarten, können Sie auf der Seite Kontingente und Systemlimits der Google Cloud Console eine Anpassung Ihres Kontingents anfordern.
Weitere Informationen finden Sie in folgenden Dokumenten: