Quote e limiti giornalieri di Google
Google Apps Script impone quote giornaliere su tutte le operazioni che coinvolgono i servizi Google, come la creazione di documenti, la lettura di fogli di calcolo e le chiamate alle API di Drive. Queste quote sono per utente, si azzerano 24 ore dopo la prima richiesta e variano in base al tipo di account.
Quote principali per tipo di account
Le quote che interessano maggiormente Doc Regia sono:
- Documenti creati — 250 al giorno per account Gmail, 1.500 al giorno per account Google Workspace
- Tempo totale di esecuzione dei trigger — 90 minuti al giorno per account Gmail, 6 ore al giorno per account Google Workspace
- Tempo massimo per singola esecuzione — 6 minuti per tutti i tipi di account
- Chiamate URL Fetch — 20.000 al giorno per account Gmail, 100.000 al giorno per account Google Workspace
L’elenco completo è disponibile nella documentazione ufficiale di Google.
Come Doc Regia gestisce questi limiti
Doc Regia rileva automaticamente il tipo di account in uso (Gmail o Google Workspace) e adatta il proprio comportamento di conseguenza, applicando limiti interni più conservativi rispetto a quelli di Google per evitare di raggiungere le soglie massime.
In particolare:
- Ogni ciclo di elaborazione genera un numero limitato di documenti in base al profilo dell’account, per restare sempre entro le quote di Google
- Se il limite per ciclo viene raggiunto o il tempo di esecuzione si avvicina al massimo consentito, l’elaborazione si interrompe e riprende automaticamente dal punto esatto in cui si era fermata al ciclo successivo
- In caso di errori temporanei da parte di Google (rate limit, timeout, errori di servizio), Doc Regia ritenta automaticamente con tempi di attesa progressivi. Se dopo più tentativi l’errore persiste, la riga viene contrassegnata nel foglio di calcolo per consentire una verifica manuale
Cosa può succedere in pratica
- Con un account Gmail e molte risposte da elaborare, la generazione potrebbe richiedere più cicli (e quindi più ore) per completarsi rispetto a un account Google Workspace. Se hai bisogno di generare documenti immediatamente senza attendere il ciclo automatico, puoi utilizzare la generazione manuale direttamente dal pannello del progetto: i documenti vengono creati subito al click per le righe selezionate
- Se utilizzi Doc Regia insieme ad altri add-on o script che consumano le stesse quote, lo spazio disponibile per la generazione si riduce
- Non è necessario alcun intervento manuale: il sistema gestisce i limiti in modo trasparente e non si blocca mai a causa delle quote