Best practice

Questo documento elenca le best practice che ti aiuteranno a migliorare le prestazioni dei tuoi 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. Questo semplifica lo sviluppo e la manutenzione del progetto.

Utilizzare le operazioni batch

Di solito, gli script devono leggere i dati di un foglio di lavoro, eseguire calcoli e quindi trascrivere i risultati dei dati in un foglio di lavoro. Google Apps Script dispone già di alcune ottimizzazioni integrate, come l'uso della memorizzazione nella cache look-ahead per recuperare ciò che uno script potrebbe ottenere e la scrittura nella cache per salvare ciò che probabilmente verrà 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 che non dovresti seguire o utilizzare. Uno script utilizza il seguente codice per impostare i colori di sfondo di ogni cella in una riga 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 loop su 100 righe e 100 colonne, scrivendo consecutivamente su 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.

Ma il codice può essere reso molto più efficiente raggruppando le chiamate in batch. 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 a lunga durata (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 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 impiega 20 secondi per essere recuperato 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.