Questo documento elenca le best practice che ti aiuteranno a migliorare le prestazioni degli script.
Riduci a icona le chiamate ad altri servizi
L'utilizzo delle operazioni JavaScript all'interno dello script è notevolmente più veloce rispetto alla chiamata di altri servizi. Qualsiasi operazione che tu possa svolgere all'interno di Google Apps Script sarà molto più veloce rispetto a fare chiamate che devono recuperare i dati dai server di Google o da un server esterno, ad esempio richieste a Fogli, Documenti, Sites, Traduttore, UrlFetch e così via. Se riesci a trovare modi per ridurre al minimo le chiamate effettuate a questi servizi, i tuoi script verranno eseguiti più velocemente.
Valuta la possibilità di collaborare con i Drive condivisi
Se stai lavorando a un progetto di script con altri sviluppatori, puoi collaborare a progetti Apps Script con i Drive condivisi. I file che si trovano in un Drive condiviso sono di proprietà del gruppo e non dei singoli utenti. Ciò semplifica lo sviluppo e la gestione del progetto.
Utilizzare le operazioni in batch
In genere gli script devono leggere i dati di un foglio di lavoro, eseguire calcoli e scrivere i risultati dei dati in un foglio di lavoro. Google Apps Script ha già alcune ottimizzazioni integrate, come l'utilizzo della memorizzazione nella cache di look-ahead per recuperare ciò che è probabile che uno script otterrà e scrivere la memorizzazione nella cache per salvare ciò che è probabile che venga impostato.
Puoi scrivere script per sfruttare al massimo la memorizzazione nella cache integrata, riducendo al minimo il numero di letture e scritture. La alternanza dei comandi di lettura e scrittura è lenta. Per velocizzare uno script, leggi tutti i dati in un array con un solo comando, esegui qualsiasi operazione sui dati nell'array e scrivi i dati con un solo comando.
Ecco un esempio che non dovresti seguire o utilizzare. Uno script utilizza il seguente codice per impostare i colori di sfondo di ogni cella in una griglia di un foglio di lavoro 100 x 100. Utilizza la funzione denominata getColorFromCoordinates() (non mostrata qui) per determinare il colore da utilizzare per ogni cella:
// DO NOT USE THIS CODE. It is an example of SLOW, INEFFICIENT code.
// FOR DEMONSTRATION ONLY
var cell = sheet.getRange('a1');
for (var y = 0; y < 100; y++) {
xcoord = xmin;
for (var x = 0; x < 100; x++) {
var c = getColorFromCoordinates(xcoord, ycoord);
cell.offset(y, x).setBackgroundColor(c);
xcoord += xincrement;
}
ycoord -= yincrement;
SpreadsheetApp.flush();
}
Lo script non è efficace: esegue il loop di 100 righe e 100 colonne, scrivendo consecutivamente fino a 10.000 celle. La cache di write-back di Google Apps Script è utile, perché forza il write-back utilizzando lo svuotamento alla fine di ogni riga. A causa della memorizzazione nella cache, ci sono solo 100 chiamate al foglio di lavoro.
Tuttavia, il codice può essere reso molto più efficiente raggruppando le chiamate. Ecco una riscrittura in cui l'intervallo di celle viene letto in un array chiamato colori, l'operazione di assegnazione del colore viene eseguita sui dati nell'array e i valori nell'array vengono scritti nel foglio di lavoro:
// OKAY TO USE THIS EXAMPLE or code based on it.
var cell = sheet.getRange('a1');
var colors = new Array(100);
for (var y = 0; y < 100; y++) {
xcoord = xmin;
colors[y] = new Array(100);
for (var x = 0; x < 100; x++) {
colors[y][x] = getColorFromCoordinates(xcoord, ycoord);
xcoord += xincrement;
}
ycoord -= yincrement;
}
sheet.getRange(1, 1, 100, 100).setBackgroundColors(colors);
L'esecuzione del codice non efficiente richiede circa 70 secondi. Il codice efficiente viene eseguito in appena un secondo.
Evita le librerie in script che utilizzano molta interfaccia utente
Le librerie sono un modo comodo per riutilizzare il codice,
ma aumentano leggermente il tempo necessario per avviare lo script. Questo ritardo non è particolare per gli script a esecuzione relativamente lunga (come uno script di utilità per ripulire i file di Google Drive), ma per le interfacce utente HTML Service lato client che effettuano chiamate google.script.run ripetute e a breve esecuzione, il ritardo inciderà su ogni chiamata. A causa di questo problema, le librerie devono essere utilizzate con parsimonia nei componenti aggiuntivi ed è consigliabile evitarle negli script non aggiuntivi che effettuano molte chiamate google.script.run.
Utilizzare il servizio Cache
Puoi utilizzare il servizio cache per memorizzare le risorse nella cache tra le esecuzioni di script. Mettendo in cache i dati, puoi ridurre il numero di volte o la frequenza con cui devi recuperare i dati. Prendi in considerazione lo scenario in cui hai un feed RSS su example.com che richiede 20 secondi per essere recuperato e vuoi accelerare l'accesso alla richiesta media. L'esempio riportato di seguito mostra come utilizzare il servizio cache per velocizzare l'accesso a questi dati.
function getRssFeed() {
var cache = CacheService.getScriptCache();
var cached = cache.get("rss-feed-contents");
if (cached != null) {
return cached;
}
// This fetch takes 20 seconds:
var result = UrlFetchApp.fetch("http://example.com/my-slow-rss-feed.xml");
var contents = result.getContentText();
cache.put("rss-feed-contents", contents, 1500); // cache for 25 minutes
return contents;
}
Ora, anche se dovrai comunque attendere 20 secondi se l'elemento non è nella cache, gli accessi successivi saranno molto rapidi fino a quando l'elemento non esce dalla cache entro 25 minuti.