I servizi Google Apps Script hanno quote giornaliere e limitazioni per alcune funzionalità. Se superi una quota o una limitazione, lo script genera un'eccezione e l'esecuzione si interrompe.
Alcune funzionalità hanno quote aggiuntive del prodotto Google associato. L'utilizzo di un servizio Apps Script di un prodotto viene conteggiato in tutte le riserve di quota 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 per gli account Google Workspace. Le quote sono per utente e vengono reimpostate 24 ore dopo la prima richiesta.
Utilizza le seguenti quote per testare i tuoi 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 email al giorno (ad esempio, con MailApp) | 100* al giorno | 1500* al giorno |
| Destinatari email al giorno all'interno del dominio (ad esempio con MailApp) | 100* al giorno | 2000 al giorno |
| Lettura/scrittura email (escluso 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 delle 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 Indicazioni Google Maps | 1000 al giorno | 10.000 al giorno |
| Chiamate di geocodifica di Google Maps | 1000 al giorno | 10.000 al giorno |
| Tradurre le chiamate | 5000 al giorno | 20.000 al giorno |
| Query di esempio 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. Quando avrai convertito l'account di prova senza costi aggiuntivi in un account a pagamento, i limiti relativi al tuo account verranno automaticamente incrementati se 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 i tuoi 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 |
|---|---|---|
| Runtime dello script | 6 min / esecuzione | 6 min / esecuzione |
| Runtime della funzione personalizzata | 30 sec / esecuzione | 30 sec / esecuzione |
| Runtime del componente aggiuntivo di Google Workspace | 30 sec / esecuzione | 30 sec* / esecuzione |
| Esecuzioni simultanee per utente | 30 / utente | 30 / utente |
| Esecuzioni simultanee per script | 1000 | 1000 |
| Allegati email | 250 / msg | 250 / msg |
| Dimensione corpo dell'email | 200 KB / messaggio | 400 KB / messaggio |
| Destinatari email per messaggio | 50 / msg | 50 / msg |
| Dimensione totale allegati dell'email | 25 MB / messaggio | 25 MB / messaggio |
| Dimensioni del valore delle proprietà | 9 KB / valore | 9 KB / valore |
| Spazio di archiviazione totale delle proprietà | 500 KB / store della proprietà | 500 KB / store della proprietà |
| Trigger | 20 per utente per script | 20 per utente per script |
| Dimensioni risposta recupero URL | 50 MB / chiamata | 50 MB / chiamata |
| Intestazioni URLFetch | 100 / chiamata | 100 / chiamata |
| Dimensioni intestazione recupero URL | 8 KB / chiamata | 8 KB / chiamata |
| Dimensioni POST URLFetch | 50 MB / chiamata | 50 MB / chiamata |
| Lunghezza URL di recupero URL | 2 kB / chiamata | 2 kB / chiamata |
| Versioni | 200 / script | 200 / script |
Monitorare l'utilizzo della quota
Per monitorare il consumo di quote e l'integrità dell'esecuzione dello script, utilizza i seguenti metodi:
- Quota email: utilizza
MailApp.getRemainingDailyQuota()per controllare il numero di destinatari email rimanenti a cui puoi inviare messaggi 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,FailedoRunning) di ogni esecuzione dello script. Puoi monitorare il numero di esecuzioni simultanee filtrando le esecuzioni con uno Stato diRunning. - 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 limitazioni elencate nelle sezioni Quote attuali o Limitazioni attuali.Service invoked too many times: Calendar.Indica che lo script ha chiamato il servizio specificato troppe volte in un solo giorno.Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls.Ciò 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ù comunemente per gli script eseguiti su un trigger, che hanno un limite giornaliero inferiore rispetto agli script eseguiti manualmente.Script invoked too many times per second for this Google user account.Ciò indica che lo script ha iniziato l'esecuzione troppe volte in un breve periodo. Si verifica più comunemente 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.Ciò indica che sono in esecuzione troppi script contemporaneamente, anche se non necessariamente lo stesso script. Come l'eccezione precedente, questa si verifica più comunemente per le funzioni personalizzate chiamate ripetutamente in un unico foglio di lavoro.