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 |
|
||||||
|
Richieste di lettura costose
(Utilizzato per le richieste |
|
||||||
| Richieste di scrittura |
|
||||||
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:
- Effettua una richiesta all'API Moduli Google.
- Se la richiesta non va a buon fine, attendi 1 +
random_number_millisecondse riprova a inviare la richiesta. - Se la richiesta non riesce, attendi 2 +
random_number_millisecondse riprova a inviare la richiesta. - Se la richiesta non riesce, attendi 4 +
random_number_millisecondse riprova a inviare la richiesta. - E via così fino all'
maximum_backoffintervallo di backoff massimo. - 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), connincrementato 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 dirandom_number_millisecondsviene 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: