Limiti di utilizzo

Poiché l'API Google Drive è un servizio condiviso, applichiamo quote e limitazioni per garantire che venga utilizzato in modo equo da tutti gli utenti e per proteggere le prestazioni complessive del sistema Google Workspace.

I limiti sono definiti in termini di unità di quota, un'unità di misura astratta che rappresenta l'utilizzo delle risorse di Google Drive.

Quote API Drive

Vengono applicati tre tipi di quote:

  • Al minuto per progetto cloud: questo è il numero di unità di quota che il tuo progetto cloud Google Cloud può utilizzare in un minuto.

  • Al minuto per utente per progetto: questo è il numero di unità di quota che un singolo utente può utilizzare nel tuo progetto Cloud. Questo limite ha lo scopo di aiutarti a garantire una distribuzione equa dell'utilizzo tra i tuoi utenti.

  • Al giorno per progetto: definisce il numero massimo di byte che il tuo progetto Google Cloud può trasferire in uscita in un periodo di 24 ore prima che vengano applicati addebiti.

La tabella seguente descrive questi limiti:

Tipo di limite di utilizzo Limite
Al minuto per progetto 1.000.000 di unità di quota
Al minuto per utente per progetto 325.000 unità di quota
Al giorno per progetto 1 TB

Se superi una quota, riceverai una risposta con codice di stato HTTP 403: User rate limit exceeded. Anche ulteriori controlli del limite di frequenza sul backend di Drive potrebbero generare una risposta 429: Rate limit exceeded. In questo caso, devi utilizzare un algoritmo di backoff esponenziale e riprovare più tardi.

Soglia di fatturazione giornaliera

Questo limite per giorno per progetto definisce il numero massimo di unità di quota che il tuo progetto Google Cloud può utilizzare in un periodo di 24 ore prima che vengano applicati addebiti.

L'utilizzo al di sotto di questa soglia non comporta costi aggiuntivi e non viene addebitato sul tuo account Google Cloud. I dettagli completi sulla fatturazione verranno condivisi più avanti nel 2026 con un preavviso di almeno 90 giorni prima dell'entrata in vigore di eventuali modifiche.

Non puoi richiedere un aumento di questo limite di soglia giornaliero.

La tabella seguente descrive il limite:

Tipo di limite di soglia Limite
Al giorno per progetto 400.000.000 di unità di quota

Per saperne di più, consulta Modello standardizzato di Google Workspace per strumenti e API degli agenti.

Costi delle unità di quota per metodo

Il numero di unità di quota consumate per richiesta varia a seconda del metodo chiamato, come descritto nelle seguenti tabelle:

Metodi di lettura (5 unità di quota)

Metodo
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

Metodi List (100 unità di quota)

Metodo
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

Metodi di modifica (50 unità di quota)

Metodo
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 e drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

Metodi di download (200 unità di quota)

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

Altri metodi (5 unità di quota)

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

Ulteriori vincoli

Quando utilizzi l'API Drive, vengono applicati i seguenti vincoli:

  • Gli utenti di Google Workspace possono caricare solo 750 GB al giorno tra Il mio Drive e tutti i Drive condivisi; questo limite si applica anche alle copie.

  • Gli utenti che raggiungono il limite di 750 GB o caricano un file di dimensioni superiori a 750 GB non possono caricare o copiare altri file per 24 ore.

  • La dimensione massima dei file che gli utenti possono caricare è di 5 TB; solo il primo file che supera il limite completa il caricamento. La dimensione massima dei file che gli utenti possono copiare è di 750 GB.

  • Le notifiche inviate all'indirizzo specificato durante l'apertura di un canale di notifica non vengono conteggiate ai fini dei limiti della quota. Tuttavia, le chiamate ai metodi changes.watch, channels.stop e files.watch vengono conteggiate ai fini della quota.

  • Se rimani entro le quote al minuto, non esiste un limite al numero di richieste che puoi effettuare al giorno.

  • A seconda del tipo di account Google Workspace, esistono ulteriori limiti di spazio di archiviazione di Drive.

Risolvi gli errori di quota basati sul tempo

Per tutti gli errori basati sul tempo (massimo N richieste per X minuti), ti consigliamo di fare in modo che il tuo codice rilevi l'eccezione e utilizzi un backoff esponenziale troncato per assicurarti che i tuoi dispositivi non generino un carico eccessivo.

Il backoff esponenziale è una strategia standard di gestione degli errori per le applicazioni di rete. Un algoritmo di backoff esponenziale riprova le richieste utilizzando tempi di attesa che aumentano in modo esponenziale tra le richieste, fino a un tempo di backoff massimo. Se le richieste continuano a non andare a buon fine, è importante che i ritardi tra le richieste aumentino nel tempo fino a quando la richiesta non va a buon fine.

Algoritmo di esempio

Un algoritmo di backoff esponenziale riprova le richieste in modo esponenziale, aumentando il tempo di attesa tra i nuovi tentativi fino a un tempo di backoff massimo. Ad esempio:

  1. Effettua una richiesta all'API Google Drive.
  2. Se la richiesta non va a buon fine, attendi 1 + random_number_milliseconds e riprova a inviare la richiesta.
  3. Se la richiesta non riesce, attendi 2 + random_number_milliseconds e riprova a inviare la richiesta.
  4. Se la richiesta non riesce, attendi 4 + random_number_milliseconds e riprova a inviare la richiesta.
  5. E via così fino all'maximum_backoffintervallo di backoff massimo.
  6. Continua ad attendere e riprovare fino al numero massimo di nuovi tentativi, ma non aumentare il periodo di attesa tra i nuovi tentativi.

dove:

  • Il tempo di attesa è min(((2^n)+random_number_milliseconds), maximum_backoff), con n incrementato di 1 per ogni iterazione (richiesta).
  • random_number_milliseconds è un numero casuale di millisecondi inferiore o uguale a 1000. In questo modo si evitano i casi in cui molti client vengono sincronizzati da una determinata situazione e tutti riprovano contemporaneamente, inviando richieste in ondate sincronizzate. Il valore di random_number_milliseconds viene ricalcolato dopo ogni richiesta di nuovo tentativo.
  • maximum_backoff è in genere di 32 o 64 secondi. Il valore appropriato dipende dal caso d'uso.

Il client può continuare a riprovare dopo aver raggiunto il tempo maximum_backoff. I nuovi tentativi dopo questo punto non devono continuare ad aumentare il tempo di backoff. Ad esempio, se un client utilizza un valore maximum_backoff di 64 secondi, dopo aver raggiunto questo valore, il client può riprovare ogni 64 secondi. A un certo punto, è necessario impedire ai client di effettuare ulteriori tentativi indefinitamente.

Il tempo di attesa tra i nuovi tentativi e il numero di nuovi tentativi dipendono dal caso d'uso e dalle condizioni della rete.

Prezzi

L'utilizzo standard dell'API Google Drive è disponibile senza costi aggiuntivi. Il superamento dei limiti di richieste della quota comporterà addebiti sul tuo account di fatturazione Google Cloud nel corso del 2026. Per saperne di più, consulta Modello standardizzato di Google Workspace per strumenti e API degli agenti.

Richiedi un aumento della quota

A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aggiustamento della quota. Le chiamate API effettuate da un service account vengono considerate come se utilizzassero un singolo account. La richiesta di una quota modificata non ne garantisce l'approvazione. Le richieste di aggiustamento della quota che aumenterebbero in modo significativo il valore della quota possono richiedere più tempo per essere approvate.

Non tutti i progetti hanno le stesse quote. Man mano che utilizzi sempre più Google Cloud nel tempo, i valori delle quote potrebbero dover aumentare. Se prevedi un aumento imminente e consistente dell'utilizzo, puoi richiedere un aggiustamento della quota in modo proattivo nella pagina Quote e limiti di sistema della console Google Cloud.

Per saperne di più, consulta le seguenti risorse:

Quote del server MCP di Drive

Il server MCP di Drive utilizza una metrica di allocazione dei costi delle query. Le tabelle seguenti descrivono in dettaglio il costo delle query per ogni metodo del server MCP di Drive per sezione:

Quote MCP di Drive

Vengono applicati due tipi di quote:

  • Al minuto per progetto: questo è il costo delle query per il tuo progetto Google Cloud per un minuto.

  • Per minute per user per project: questo è il costo delle query per il tuo progetto Google Cloud per un minuto che un utente specifico può utilizzare.

La tabella seguente descrive queste quote:

Tipo di limite di utilizzo Limite
Al minuto per progetto 325.000
Al minuto per utente per progetto 1.000.000

Quote del set di strumenti MCP di Drive

La tabella seguente descrive in dettaglio il costo delle query per ogni set di strumenti drivemcp.googleapis.com:

Endpoint Strumento Costo delle query

/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

Per ulteriori informazioni, consulta il Riferimento API Drive MCP.