Questo documento elenca le best practice che ti aiuteranno a migliorare il rendimento degli script.
Riduci al minimo le chiamate ad altri servizi
L'utilizzo di operazioni JavaScript all'interno dello script è notevolmente più veloce rispetto alla chiamata di altri servizi. Qualsiasi cosa tu possa fare all'interno di Google Apps Script sarà molto più veloce rispetto a effettuare chiamate che devono recuperare dati dai server di Google o da un server esterno, ad esempio richieste a Fogli, Documenti, Sites, Traduttore, UrlFetch e così via. Gli script verranno eseguiti più velocemente se riesci a trovare modi per ridurre al minimo le chiamate effettuate a questi servizi.
Valutare la collaborazione con i Drive condivisi
Se stai lavorando a un progetto di script con altri sviluppatori, puoi collaborare a progetti Apps Script con unità condivise. I file che si trovano su un Drive condiviso sono di proprietà del gruppo, non dei singoli membri. In questo modo, lo sviluppo e la manutenzione del progetto sono più semplici.
Utilizzare le operazioni batch
In genere, gli script devono leggere i dati da un foglio di lavoro, eseguire calcoli e poi scrivere i risultati dei dati in un foglio di lavoro. Google Apps Script ha già alcune ottimizzazioni integrate, ad esempio l'utilizzo della memorizzazione nella cache di anticipazione per recuperare ciò che uno script è probabile che riceva e la memorizzazione nella cache di scrittura per salvare ciò che è probabile che venga impostato.
Puoi scrivere script per sfruttare al meglio la memorizzazione nella cache integrata, minimizzando il numero di letture e scritture. L'alternanza di comandi di lettura e scrittura è lenta. Per velocizzare uno script, leggi tutti i dati in un array con un comando, esegui qualsiasi operazione sui dati nell'array e scrivi i dati con un comando.
Ecco un esempio, un esempio che non devi seguire o utilizzare. Uno script
utilizza il seguente codice per impostare i colori di sfondo di ogni cella in una
griglia di foglio di lavoro di 100 x 100. Utilizza la funzione 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 è inefficiente: esegue un ciclo per 100 righe e 100 colonne, scrivendo consecutivamente in 10.000 celle. La cache di scrittura di Google Apps Script è utile, perché forza una scrittura utilizzando il comando flush alla fine di ogni riga. A causa della memorizzazione nella cache, vengono effettuate solo 100 chiamate al foglio di lavoro.
Tuttavia, il codice può essere reso molto più efficiente raggruppando le chiamate. Ecco un rifacimento 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).setBackgrounds(colors);
L'esecuzione del codice inefficiente richiede circa 70 secondi. Il codice efficiente viene eseguito in appena 1 secondo.
Evita le librerie negli script con interfaccia utente complessa
Le librerie sono un modo pratico per riutilizzare il codice, ma aumentano leggermente il tempo necessario per avviare lo script. Questo ritardo
non è evidente per gli script con un'esecuzione relativamente lunga (ad esempio uno script di utilità per
ripulire i file di Google Drive), ma per le interfacce utente di Servizio HTML lato client che effettuano chiamate google.script.run ripetute e di breve durata, il ritardo influirà su ogni chiamata. A causa di questo problema, le librerie devono essere utilizzate con parsimonia nei componenti aggiuntivi e ti consigliamo di evitarle negli script non aggiuntivi che effettuano molte chiamate google.script.run.
Utilizzare il servizio Cache
Puoi utilizzare il servizio Cache per memorizzare nella cache le risorse tra le esecuzioni dello script. Memorizzando i dati nella cache, puoi ridurre il numero di volte o la frequenza con cui devi recuperarli. Considera lo scenario in cui hai un feed RSS su example.com che richiede 20 secondi per il recupero e vuoi velocizzare 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 è in cache, gli accessi successivi saranno molto rapidi fino alla scadenza dell'elemento dalla cache tra 25 minuti.