Nutzungsbeschränkungen

Da die Google Docs 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 Systemgesundheit von Google Workspace zu schützen.

Wenn Sie ein Kontingent überschreiten, erhalten Sie in der Regel eine 429: Too many requests Antwort mit dem HTTP-Statuscode. In diesem Fall sollten Sie einen exponentiellen Backoff-Algorithmus verwenden und es später noch einmal versuchen.

In der folgenden Tabelle sind die Anfragelimits aufgeführt:

Kontingente
Leseanfragen
Pro Minute und Projekt 3000
Pro Minute, Nutzer und Projekt 300
Schreibanfragen
Pro Minute und Projekt 600
Pro Minute, Nutzer und Projekt 60

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.

Ein exponentieller 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, müssen 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:

  1. Senden Sie eine Anfrage an die Google Docs API.
  2. Wenn die Anfrage fehlschlägt, warten Sie 1 + random_number_milliseconds und wiederholen Sie die Anfrage.
  3. Wenn die Anfrage fehlschlägt, warten Sie 2 + random_number_milliseconds und wiederholen Sie die Anfrage.
  4. Wenn die Anfrage fehlschlägt, warten Sie 4 + random_number_milliseconds und wiederholen Sie die Anfrage.
  5. Und so weiter bis zur maximum_backoff-Zeit.
  6. Warten Sie weiter und wiederholen Sie den Vorgang bis zu einer maximalen Anzahl von Wiederholungen, aber verlängern Sie die Warte zeit zwischen den Wiederholungen nicht.

Dabei gilt:

  • Die Wartezeit beträgt min(((2^n)+random_number_milliseconds), maximum_backoff), wobei n für jede Iteration (Anfrage) um 1 erhöht wird.
  • random_number_milliseconds ist eine zufällige Anzahl von Millisekunden,die kleiner oder gleich 1.000 ist. So lassen sich Situationen vermeiden, in denen viele Clients synchronisiert werden durch eine Situation und alle gleichzeitig Anfragen wiederholen und diese in synchronisierten Wellen senden. Der Wert von random_number_milliseconds wird nach jeder Wiederholungsanfrage neu berechnet.
  • maximum_backoff ist 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 nach Erreichen dieses Werts alle 64 Sekunden eine Wiederholung versuchen. Irgendwann sollten Clients daran gehindert werden, den Vorgang unbegrenzt zu wiederholen.

Die Wartezeit zwischen den Wiederholungen und der Anzahl der Wiederholungen hängt von Ihrem Anwendungsfall und den Netzwerkbedingungen ab.

Preise

Die Standardnutzung der Google Docs API ist kostenlos. Wenn Sie die Kontingent anfragelimits überschreiten, fallen voraussichtlich im Laufe des Jahres 2026 Gebühren für Ihr Google Cloud-Rechnungskonto an. Weitere Informationen finden Sie unter Standardisiertes Modell für Agent-Tools und APIs von Google Workspace.

Kontingenterhöhung anfordern

Abhängig von der Ressourcennutzung Ihres Projekts können Sie eine Kontingentanpassung anfordern. API-Aufrufe durch ein Dienstkonto werden als Nutzung eines einzelnen Kontos betrachtet. 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 im Laufe der Zeit immer häufiger nutzen, müssen Ihre Kontingentwerte möglicherweise erhöht werden. Falls Sie eine deutlich stärkere Auslastung erwarten, können Sie proaktiv eine Anpassung Ihres Kontingents anfordern auf der Seite Kontingente und Systemlimits der Google Cloud Console.

Weitere Informationen finden Sie in den folgenden Ressourcen:

Kontingente für den Docs MCP-Server

Der Docs MCP-Server verwendet Messwerte für Lese- und Schreibanfragen. In den folgenden Tabellen sind die Kontingente und Abfragekosten für jede Docs MCP-Servermethode nach Abschnitt aufgeführt:

Docs MCP-Kontingente

Es werden zwei Arten von Kontingenten erzwungen:

  • Pro Minute und Projekt: Dies ist die Anzahl der Anfragen, die Ihr Google Cloud-Projekt in einer Minute senden kann.
  • Pro Minute, Nutzer und Projekt: Dies ist die Anzahl der Anfragen, die ein bestimmter Nutzer in Ihrem Cloud-Projekt senden kann.

In der folgenden Tabelle sind diese Kontingente aufgeführt:

Kontingente
Leseanfragen
Pro Minute und Projekt 3.000
Pro Minute, Nutzer und Projekt 300
Schreibanfragen
Pro Minute und Projekt 600
Pro Minute, Nutzer und Projekt 60

Kontingente für das Docs MCP-Toolset

In der folgenden Tabelle sind die Abfragekosten für jedes docsmcp.googleapis.com Toolset aufgeführt:

Endpunkt Tool Abfragekosten
/mcp/v1 read_doc 1 Leseanfrage
update_doc 1 Schreibanfrage

Weitere Informationen finden Sie in der Docs MCP API-Referenz.