Nutzungsbeschränkungen

Da die Google Drive 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 Gesamtleistung des Google Workspace-Systems zu schützen.

Limits werden in Kontingenteinheiten definiert, einer abstrakten Maßeinheit, die die Ressourcennutzung von Google Drive darstellt.

Drive API-Kontingente

Es werden drei Arten von Kontingenten erzwungen:

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

  • Pro Minute pro Nutzer pro Projekt: Dies ist die Anzahl der Kontingenteinheiten, die ein bestimmter Nutzer in Ihrem Cloud-Projekt verwenden kann. Dieses Limit soll Ihnen helfen, eine faire Verteilung der Nutzung auf Ihre Nutzer zu gewährleisten.

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

In der folgenden Tabelle werden diese Limits im Detail beschrieben:

Typ des Nutzungslimits 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 die HTTP-Statuscode-Antwort 403: User rate limit exceeded. Zusätzliche Prüfungen der Ratenbegrenzung im Drive-Backend können ebenfalls 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 Schwellenwert für die Abrechnung

Dieses Limit pro Tag und Projekt definiert die maximale Anzahl von Kontingenteinheiten, die Ihr Google Cloud-Projekt innerhalb eines 24-Stunden-Zeitraums 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. Die vollständigen Abrechnungsdetails werden im Laufe des Jahres 2026 mindestens 90 Tage vor Inkrafttreten der Änderungen bekannt gegeben.

Sie können keine Erhöhung dieses Tageslimits beantragen.

In der folgenden Tabelle wird das Limit näher erläutert:

Art des Grenzwerts Limit
Pro Tag und Projekt 400.000.000 Kontingenteinheiten

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

Kosten pro Kontingenteinheit und Methode

Die Anzahl der pro Anfrage verbrauchten Kontingenteinheiten variiert je nach aufgerufener Methode, wie in den folgenden Tabellen beschrieben:

Lesemethoden (5 Kontingenteinheiten)

Methode
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

Listenmethoden (100 Kontingenteinheiten)

Methode
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

Bearbeitungsmethoden (50 Kontingenteinheiten)

Methode
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create, drive.comments.delete, drive.comments.insert, drive.comments.patch, drive.comments.update
drive.drives.create, drive.drives.delete, drive.drives.hide, drive.drives.insert, drive.drives.unhide, drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create, drive.permissions.delete, drive.permissions.insert, drive.permissions.patch, drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create, drive.replies.delete, drive.replies.insert, drive.replies.patch, drive.replies.update
drive.revisions.delete, drive.revisions.patch, drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

Downloadmethoden (200 Kontingenteinheiten)

Methode
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

Andere Methoden (5 Kontingenteinheiten)

Methode
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

Zusätzliche Einschränkungen

Bei der Arbeit mit der Drive API gelten die folgenden Einschränkungen:

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

  • Nutzer, die das Limit von 750 GB erreichen oder eine Datei mit mehr als 750 GB hochladen, 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 die erste Datei, die das Limit überschreitet, wird vollständig hochgeladen. Die maximale Dateigröße, die Nutzer kopieren können, beträgt 750 GB.

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

  • Solange Sie die Kontingente pro Minute einhalten, gibt es keine Begrenzung für die Anzahl der Anfragen, die Sie pro Tag stellen können.

  • Je nach Art Ihres Google Workspace-Kontos gelten zusätzliche Limits für den Drive-Speicherplatz.

Zeitbasierte Kontingentfehler beheben

Bei allen zeitbasierten Fehlern (maximal N Anfragen pro X Minuten) empfehlen wir, dass Ihr Code die Ausnahme abfängt und einen gekürzten 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:

  1. Anfrage an die Google Drive API senden
  2. Wenn die Anfrage fehlschlägt, wartet das System 1 + random_number_milliseconds und wiederholt dann die Anfrage.
  3. Wenn die Anfrage fehlschlägt, wartet das System 2 + random_number_milliseconds Sekunden und wiederholt dann die Anfrage.
  4. Wenn die Anfrage fehlschlägt, wartet das System 4 + random_number_milliseconds Sekunden und wiederholt dann die Anfrage.
  5. Und so weiter bis zur maximum_backoff-Zeit.
  6. 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), wobei n bei jeder Ausführung (Anfrage) um 1 erhöht wird.
  • random_number_milliseconds steht 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 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 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 Drive API ist ohne zusätzliche Kosten möglich. Wenn Sie die Kontingentlimits für Anfragen ü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 Verwendung 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 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:

Kontingente für den Drive-MCP-Server

Der Drive-MCP-Server verwendet einen Messwert für die Zuordnung von Abfragekosten. In den folgenden Tabellen sind die Abfragekosten für die einzelnen Drive-MCP-Servermethoden nach Abschnitt aufgeführt:

MCP-Kontingente für Google Drive

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 werden diese Kontingente aufgeführt:

Typ des Nutzungslimits Limit
Pro Minute und Projekt 325.000
Pro Minute, Nutzer und Projekt 1.000.000

Kontingente für MCP-Tools für Google Drive

In der folgenden Tabelle sind die Abfragekosten für die einzelnen drivemcp.googleapis.com-Tools 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.