Quote per i servizi Google

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, o Running) 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.