Nutzungsbeschränkungen

Da die Google Drive API ein freigegebener Dienst ist, wenden wir Kontingente und Einschränkungen an, um sicherzustellen, dass sie von allen Nutzern fair verwendet wird, und um die Gesamtleistung des Google Workspace-Systems zu schützen.

Die Limits werden in Kontingenteinheiten definiert. Das ist eine abstrakte Maßeinheit, die die Nutzung von Google Drive-Ressourcen darstellt.

Drive API-Kontingente

Es werden drei Arten von Kontingenten erzwungen:

  • Pro Minute und Projekt:Das ist die Anzahl der Kontingenteinheiten, die Ihr Google Cloud-Projekt in einer Minute verwenden kann.

  • Pro Minute, Nutzer und Projekt:Das ist die Anzahl der Kontingenteinheiten, die ein bestimmter Nutzer in Ihrem Cloud-Projekt verwenden kann. Mit diesem Limit können Sie eine faire Verteilung der Nutzung auf Ihre Nutzer gewährleisten.

  • Pro Tag und Projekt: Damit wird die maximale Anzahl von Byte definiert, die Ihr Google Cloud-Projekt innerhalb von 24 Stunden ausgehenden Traffic übertragen kann, bevor Gebühren anfallen.

In der folgenden Tabelle sind diese Limits aufgeführt:

Nutzungslimittyp Limit
Pro Minute und Projekt 1.000.000 Kontingenteinheiten
Pro Minute, Nutzer und Projekt 325.000 Kontingenteinheiten
Pro Tag und Projekt 1 TB

Wenn Sie ein Kontingent überschreiten, erhalten Sie eine 403: User rate limit exceeded HTTP Antwort mit dem Statuscode. Zusätzliche Ratenlimitprüfungen im Drive Back-End können auch eine 429: Rate limit exceeded Antwort generieren. In diesem Fall sollten Sie einen exponentiellen Backoff Algorithmus verwenden und es später noch einmal versuchen.

Täglicher Abrechnungsschwellenwert

Mit diesem Limit pro Tag und Projekt wird die maximale Anzahl von Kontingenteinheiten definiert, die Ihr Google Cloud-Projekt innerhalb von 24 Stunden verwenden kann, bevor Gebühren anfallen.

Bei einer Nutzung unter diesem Schwellenwert fallen keine zusätzlichen Gebühren an und Ihr Google Cloud-Konto wird nicht belastet. Vollständige Abrechnungsdetails werden später im Jahr 2026 mit einer Vorlaufzeit von mindestens 90 Tagen vor Inkrafttreten von Änderungen bekannt gegeben.

Sie können keine Erhöhung dieses täglichen Schwellenwertlimits beantragen.

In der folgenden Tabelle ist das Limit aufgeführt:

Schwellenwertlimittyp Limit
Pro Tag und Projekt 400.000.000 Kontingenteinheiten

Weitere Informationen finden Sie unter Standardisiertes Google Workspace-Modell für Agent-Tools und APIs.

Kontingentnutzung pro Methode

Die Anzahl der Kontingenteinheiten, die pro Anfrage verbraucht werden, hängt von der aufgerufenen Methode ab. In der folgenden Tabelle ist die Kontingenteinheitennutzung pro Methode aufgeführt:

Aktion Kontingenteinheiten
Elemente lesen, z. B. files.get 5
Elemente auflisten, z. B. files.list 100
Elemente herunterladen, z. B. files.download 200
Elemente bearbeiten, z. B. files.update 50
Andere Aktionen, z. B. files.generateIds 5

Zusätzliche Einschränkungen

Bei der Verwendung der Drive API gelten die folgenden Einschränkungen:

  • Google Workspace-Nutzer können täglich nur 750 GB zwischen „Meine Ablage“ und allen geteilten Ablagen hochladen. Dieses Limit gilt auch für Kopien.

  • Nutzer, die das Limit von 750 GB erreicht haben oder eine Datei hochladen, die größer als 750 GB ist, können erst nach 24 Stunden wieder Dateien hochladen oder kopieren.

  • Die maximale Dateigröße, die Nutzer hochladen können, beträgt 5 TB. Nur der Upload der ersten Datei, die das Limit überschreitet, wird abgeschlossen. Die maximale Dateigröße, die Nutzer kopieren können, beträgt 750 GB.

  • Benachrichtigungen, die an die Adresse gesendet werden, die beim Öffnen eines Benachrichtigungskanals angegeben wurde, werden nicht auf Ihre Kontingent limits angerechnet. Aufrufe der changes.watch, channels.stop und files.watch Methoden werden jedoch auf Ihr Kontingent angerechnet.

  • Sofern Sie die Kontingente pro Minute nicht überschreiten, ist die Anzahl der Anfragen, die Sie pro Tag senden können, nicht begrenzt.

  • Je nach Art Ihres Google Workspace-Kontos gelten zusätzliche Drive-Speicherlimits.

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 nicht erfolgreich sind, müssen 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 Drive 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, wodurch Anfragen in synchronisierten Wellen gesendet werden. 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. 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 gesamte Standardnutzung der Google Drive 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 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 als Nutzung eines einzelnen Kontos betrachtet. Wenn Sie ein angepasstes Kontingent beantragen, bedeutet dies nicht, dass Ihr Antrag auch genehmigt wird. Die Genehmigung von Anfragen zur Kontingentanpassung, die den Kontingentwert erheblich erhöhen würden, kann 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 Drive MCP-Server

Der Drive MCP-Server verwendet einen Messwert für die Zuweisung von Abfragekosten. In den folgenden Tabellen sind die Abfragekosten für jede Drive MCP-Servermethode nach Abschnitt aufgeschlüsselt:

Drive MCP-Kontingente

Es werden zwei Arten von Kontingenten erzwungen:

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

  • Pro Minute, Nutzer und Projekt:Das 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:

Nutzungslimittyp Abfragekosten
Pro Minute und Projekt 325.000
Pro Minute, Nutzer und Projekt 1.000.000

Kontingente für das Drive MCP-Toolset

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

Endpunkt Tool Abfragekosten

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

Weitere Informationen finden Sie in der Drive MCP API Referenz.