I servizi di Google Apps Script hanno quote giornaliere e limitazioni su alcune funzionalità. Se superi una quota o una limitazione, lo script genera un'eccezione e l'esecuzione si interrompe.
Alcune funzionalità hanno quote aggiuntive rispetto al prodotto Google associato. L'utilizzo del servizio Apps Script di un prodotto viene conteggiato per tutte le riserve di quote associate. Una funzionalità non è più disponibile se raggiungi una delle quote associate.
Quote attuali
Le quote sono impostate a livelli diversi per gli utenti di account consumer (ad esempio gmail.com) e account Google Workspace. Le quote sono per utente e vengono reimpostate 24 ore dopo la prima richiesta.
Utilizza le seguenti quote per testare gli script. Tutte le quote sono soggette a eliminazione, riduzione o modifica in qualsiasi momento, senza preavviso.
| Funzionalità | Account consumer (ad esempio gmail.com) | Account Google Workspace |
|---|---|---|
| Eventi del calendario creati | 5000 al giorno | 10.000 al giorno |
| Contatti creati | 1000 al giorno | 2000 al giorno |
| Documenti creati | 250 al giorno | 1500 al giorno |
| File convertiti | 2000 al giorno | 4000 al giorno |
| Destinatari di email al giorno (ad esempio con MailApp) | 100* al giorno | 1500* al giorno |
| Destinatari di email al giorno all'interno del dominio (ad esempio con MailApp) | 100* al giorno | 2000 al giorno |
| Lettura/scrittura di email (escluso l'invio) | 20.000 al giorno | 50.000 al giorno |
| Lettura Gruppi | 2000 al giorno | 10.000 al giorno |
| Connessioni JDBC | 10.000 al giorno | 50.000 al giorno |
| Errori di connessione JDBC | 100 al giorno | 500 al giorno |
| Presentazioni create | 250 al giorno | 1500 al giorno |
| Lettura/scrittura di proprietà | 50.000 al giorno | 500.000 al giorno |
| Slide create | 250 al giorno | 1500 al giorno |
| Fogli di lavoro creati | 250 al giorno | 3200 al giorno |
| Tempo di esecuzione totale degli attivatori | 90 minuti al giorno | 6 ore al giorno |
| Chiamate di recupero URL | 20.000 al giorno | 100.000 al giorno |
| Rendering di mappe statiche | 1000 al giorno | 10.000 al giorno |
| Query di indicazioni stradali di Google Maps | 1000 al giorno | 10.000 al giorno |
| Chiamate di geocodifica di Google Maps | 1000 al giorno | 10.000 al giorno |
| Chiamate di traduzione | 5000 al giorno | 20.000 al giorno |
| Query di campioni di elevazione di Google Maps | 1000 al giorno | 10.000 al giorno |
| Progetti Apps Script | 50 al giorno | 50 al giorno |
Per gli account di prova si applicano limiti aggiuntivi. Dopo aver convertito l'account di prova senza costi aggiuntivi in un abbonamento a pagamento, i limiti dell'account aumentano automaticamente quando entrambe le seguenti condizioni sono soddisfatte:
- Per il tuo dominio sono stati effettuati pagamenti cumulativi per almeno 100 $ (o un importo equivalente).
- Sono trascorsi almeno 60 giorni da quando questa soglia di pagamento è stata superata.
Limitazioni attuali
Utilizza i seguenti limiti per testare gli script. Tutti i limiti sono soggetti a eliminazione, riduzione o modifica in qualsiasi momento, senza preavviso.
| Funzionalità | Account consumer (ad es. gmail.com) | Account Google Workspace |
|---|---|---|
| Tempo di esecuzione dello script | 6 minuti per esecuzione | 6 minuti per esecuzione |
| Tempo di esecuzione della funzione personalizzata | 30 secondi per esecuzione | 30 secondi per esecuzione |
| Tempo di esecuzione del componente aggiuntivo di Google Workspace | 30 secondi per esecuzione | 30 secondi* per esecuzione |
| Esecuzioni simultanee per utente | 30 per utente | 30 per utente |
| Esecuzioni simultanee per script | 1000 | 1000 |
| Allegati email | 250 per messaggio | 250 per messaggio |
| Dimensione corpo dell'email | 200 kB per messaggio | 400 kB per messaggio |
| Destinatari di email per messaggio | 50 per messaggio | 50 per messaggio |
| Dimensione totale allegati dell'email | 25 MB per messaggio | 25 MB per messaggio |
| Dimensione del valore delle proprietà | 9 kB per valore | 9 kB per valore |
| Spazio di archiviazione totale delle proprietà | 500 kB per archivio di proprietà | 500 kB per archivio di proprietà |
| Trigger | 20 per utente per script | 20 per utente per script |
| Dimensione della risposta di recupero URL | 50 MB per chiamata | 50 MB per chiamata |
| Intestazioni di recupero URL | 100 per chiamata | 100 per chiamata |
| Dimensioni intestazione di recupero URL | 8 kB per chiamata | 8 kB per chiamata |
| Dimensioni POST di recupero URL | 50 MB per chiamata | 50 MB per chiamata |
| Lunghezza URL di recupero URL | 2 kB per chiamata | 2 kB per chiamata |
| Versioni | 200 per script | 200 per script |
Monitorare l'utilizzo della quota
Per monitorare il consumo della quota e l'integrità dell'esecuzione dello script, utilizza i seguenti metodi:
- Quota email: utilizza
MailApp.getRemainingDailyQuota()per controllare il numero di destinatari di email rimanenti a cui puoi inviare email per il resto della giornata. - Monitoraggio dell'esecuzione: utilizza la
dashboard di Apps Script per visualizzare la
cronologia e l'integrità dell'esecuzione dello script. La pagina Le mie esecuzioni mostra lo
stato (ad esempio
Completed,Failed, oRunning) di ogni esecuzione dello script. Puoi monitorare il numero di esecuzioni simultanee filtrando le esecuzioni con uno Stato `In esecuzione`Running. - Console Google Cloud: se il tuo progetto Apps Script utilizza un progetto Google Cloud standard, puoi monitorare le quote specifiche del servizio e l'utilizzo delle API nella console Google Cloud.
Messaggi di eccezione
Se uno script raggiunge una quota o una limitazione, genera un'eccezione con un messaggio simile al seguente:
Limit exceeded: Email Attachments Per Message.Indica che lo script ha superato una delle quote o delle limitazioni elencate nelle Quote attuali o Limitazioni attuali sezioni.Service invoked too many times: Calendar.Indica che lo script ha chiamato il servizio specificato troppe volte in un giorno.Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls.Questo indica che lo script ha chiamato il servizio specificato troppe volte in un breve periodo.Service using too much computer time for one day.Indica che lo script ha superato il tempo di esecuzione totale consentito per un giorno. Si verifica più spesso per gli script eseguiti su un attivatore, che hanno un limite giornaliero inferiore rispetto agli script eseguiti manualmente.Script invoked too many times per second for this Google user account.Indica che lo script ha iniziato l'esecuzione troppe volte in un breve periodo. Si verifica più spesso per le funzioni personalizzate chiamate ripetutamente in un singolo foglio di lavoro. Per evitare questo errore, codifica le funzioni personalizzate in modo che debbano essere chiamate una sola volta per intervallo di dati, come spiegato nella guida alle funzioni personalizzate.There are too many scripts running simultaneously for this Google user account.Indica che hai troppi script in esecuzione contemporaneamente, anche se non necessariamente lo stesso script. Come l'eccezione precedente, questa si verifica più spesso per le funzioni personalizzate chiamate ripetutamente in un singolo foglio di lavoro.
Argomenti correlati
- Restrizioni per gli attivatori del file manifest.
- Restrizioni per gli attivatori dei componenti aggiuntivi Editor.