Nutzungsbeschränkungen

Die Google Sheets API ist ein gemeinsamer Dienst. Wir wenden Kontingente und Einschränkungen an, um die Gesamtleistung des Google Workspace-Systems für alle Nutzer zu schützen.

Kontingentlimits

Die Sheets API hat keine festen Größenlimits für eine API-Anfrage. Nutzer können jedoch auf Limits von verschiedenen Verarbeitungskomponenten stoßen, die nicht von Google Sheets kontrolliert werden. Um Anfragen zu beschleunigen, empfehlen wir eine maximale Nutzlast von 2 MB.

Die Sheets API hat Minutenkontingente, die jede Minute wieder aufgefüllt werden. Es gibt beispielsweise ein Limit von 300 Leseanfragen pro Minute und Projekt. Wenn Ihre App 350 Anfragen in einer Minute sendet, überschreiten die zusätzlichen 50 Anfragen das Kontingent und es wird ein 429: Too many requests HTTP-Statuscode zurückgegeben. In diesem Fall sollten Sie einen exponentiellen Backoff-Algorithmus verwenden. Nach einer Minute können Sie wieder Anfragen ausführen.

In der folgenden Tabelle sind die Anfragelimits aufgeführt:

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

Weitere Informationen zu Dateilimits finden Sie im Hilfeartikel In Google Drive speicherbare Dateien.

Verhalten und Einschränkungen

Beachten Sie bei der Arbeit mit der Sheets API die folgenden Verhaltensweisen und Einschränkungen, die sich auf Ihre Kontingente auswirken:

  • Leseanfragen sind Aufrufe einer Methode, die Daten aus einer Tabelle abruft, z. B. get oder search. Schreibanfragen sind Aufrufe einer Methode, die eine Tabelle ändert, z. B. update, clear oder copyTo.

  • Nutzer können mehrere Anfragen gleichzeitig senden, solange sie das Kontingentlimit nicht überschreiten. Jede Batchanfrage, einschließlich aller Unteranfragen, wird als eine API-Anfrage auf Ihr Nutzungslimit angerechnet.

  • Alle Sheets-Anfragen werden in kleinstmöglichen Schritten angewendet. Wenn eine Anfrage ungültig ist, schlägt die gesamte Aktualisierung fehl und keine der (potenziell abhängigen) Änderungen wird angewendet.

  • Für die Verarbeitung einer API-Anfrage gilt ein maximales Zeitlimit. Wenn Sheets eine Anfrage länger als 180 Sekunden verarbeitet, wird ein Zeitlimitfehler zurückgegeben.

  • Solange Sie die Minutenkontingente nicht überschreiten, gibt es keine Begrenzung für die Anzahl der Anfragen, die Sie pro Tag senden können.

Zeitbasierte Kontingentfehler beheben

Bei allen zeitbasierten Fehlern (maximal N Anfragen pro X Minuten) empfehlen wir Ihnen, dass Ihr Code die Ausnahme abfängt und einen abgeschnittenen exponentiellen Backoff verwendet, um zu verhindern, dass Ihre Geräte eine ü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, ist es wichtig, dass die Verzögerungen zwischen den Anfragen mit 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 Sheets 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, verlängern Sie aber nicht die Warte zeit zwischen den Wiederholungen.

Dabei gilt:

  • Die Wartezeit beträgt min(((2^n)+random_number_milliseconds), maximum_backoff), wobei n bei jeder Ausführung (Anfrage) um 1 erhöht wird.
  • random_number_milliseconds ist eine zufällige Anzahl von Millisekunden,die kleiner oder gleich 1.000 ist. So wird verhindert, dass viele Clients durch eine bestimmte Situation synchronisiert werden und alle gleichzeitig wiederholen und Anfragen in synchronisierten Wellen senden. Der Wert von random_number_milliseconds wird nach jeder Anfragewiederholung 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 wiederholen. 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 Sheets API ist kostenlos. Wenn Sie die Kontingent anfragelimits überschreiten, fallen voraussichtlich später im Jahr 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. Bei Anfragen zur Kontingentanpassung, die den Kontingentwert erheblich erhöhen würden, kann die Genehmigung länger dauern.

Es gelten nicht für alle Projekte dieselben Kontingente. Wenn Sie Google Cloud im Laufe der Zeit 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 Sheets MCP-Server

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

Sheets MCP-Kontingente

Es werden zwei Arten von Kontingenten erzwungen:

  • Pro Minute und Projekt:Dies sind die Abfragekosten für Ihr Google Cloud-Projekt für eine Minute.

  • Pro Minute, Nutzer und Projekt:Dies sind die Abfragekosten für Ihr Google Cloud-Projekt für eine Minute, die ein bestimmter Nutzer verwenden kann.

In der folgenden Tabelle sind diese Kontingente aufgeführt:

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

Kontingente für das Sheets MCP-Toolset

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

Endpunkt Tool Abfragekosten
/mcp/v1 get_values 1 Leseanfrage
get_spreadsheet 1 Leseanfrage
update_spreadsheet 1 Schreibanfrage
update_values 1 Schreibanfrage
update_formulas 1 Schreibanfrage
insert_dimension 1 Schreibanfrage

Weitere Informationen finden Sie in der Referenz zur Sheets MCP API.