Limiti di utilizzo

Poiché l'API Moduli Google è un servizio condiviso, applichiamo quote e limitazioni per assicurarci che venga utilizzata in modo equo da tutti gli utenti e per proteggere l'integrità complessiva del sistema Google Workspace.

Se superi una quota, in genere riceverai una risposta con codice di stato HTTP 429: Too many requests. In questo caso, devi utilizzare un algoritmo di backoff esponenziale e riprovare più tardi. Se non superi le quote al minuto riportate di seguito, non esiste un limite al numero di richieste che puoi effettuare al giorno.

Nota: i controlli dei moduli hanno limiti aggiuntivi. Per saperne di più, consulta Configura e ricevi notifiche push.

La tabella seguente descrive i limiti delle richieste:

Quote
Richieste di lettura
Al giorno per progetto Illimitato
Al minuto per progetto 975
Al minuto per utente per progetto 390
Richieste di lettura costose

(Utilizzato per le richieste forms.responses.list.)

Al giorno per progetto Illimitato
Al minuto per progetto 450
Al minuto per utente per progetto 180
Richieste di scrittura
Al giorno per progetto Illimitato
Al minuto per progetto 375
Al minuto per utente per progetto 150

Risolvi gli errori di quota basati sul tempo

Per tutti gli errori basati sul tempo (massimo di 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 Moduli Google.
  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 Forms è 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 aggiustamento di una quota 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: