Prácticas recomendadas

En este documento, se enumeran las prácticas recomendadas que te ayudarán a mejorar el rendimiento de tus secuencias de comandos.

Minimiza las llamadas a otros servicios

El uso de operaciones de JavaScript dentro de tu secuencia de comandos es mucho más rápido que llamar a otros servicios. Todo lo que puedas lograr dentro de Google Apps Script será mucho más rápido que realizar llamadas que necesitan recuperar datos de los servidores de Google o un servidor externo, como solicitudes a Hojas de cálculo, Documentos, Sites, Translate, UrlFetch, etcétera. Tus secuencias de comandos se ejecutarán más rápido si puedes encontrar formas de minimizar las llamadas que hacen a esos servicios.

Considera colaborar con unidades compartidas

Si trabajas en un proyecto de secuencia de comandos con otros desarrolladores, puedes colaborar en proyectos de Apps Script con unidades compartidas. Los archivos de una unidad compartida pertenecen al grupo, no a personas específicas. Esto facilita el desarrollo y el mantenimiento del proyecto.

Usa operaciones por lotes

Por lo general, las secuencias de comandos necesitan leer los datos de una hoja de cálculo, realizar cálculos y, luego, escribir los resultados de los datos en una hoja de cálculo. Google Apps Script ya tiene algunas optimizaciones integradas, como el uso del almacenamiento en caché anticipado para recuperar lo que es probable que obtenga una secuencia de comandos y escribir en caché para guardar lo que es probable que se establezca.

Puedes escribir secuencias de comandos para aprovechar al máximo la caché integrada minimizando la cantidad de operaciones de lectura y escritura. La alternancia de comandos de lectura y escritura es lento. Para acelerar una secuencia de comandos, lee todos los datos en un array con un comando, realiza cualquier operación en los datos del array y escribe los datos con un solo comando.

Este es un ejemplo, un ejemplo que no debes seguir ni usar. Una secuencia de comandos usa el siguiente código para establecer los colores de fondo de cada celda en una cuadrícula de hoja de cálculo de 100 × 100. Usa una función llamada getColorFromCoordinates() (que no se muestra aquí) para determinar qué color usar para cada celda:

  // 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();
  }

La secuencia de comandos es ineficiente: realiza un bucle de 100 filas y 100 columnas, y escribe de forma consecutiva en 10,000 celdas. La caché de escritura de Google Apps Script ayuda, ya que fuerza una escritura mediante el volcado al final de cada línea. Debido al almacenamiento en caché, solo hay 100 llamadas a la hoja de cálculo.

Sin embargo, el código puede ser mucho más eficiente si se agrupan las llamadas. Aquí hay una reescritura en la que el rango de celdas se lee en un array llamado colores, la operación de asignación de colores se realiza en los datos del array y los valores del array se escriben en la hoja de cálculo:

  // 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);

El código ineficiente tarda unos 70 segundos en ejecutarse. El código eficiente se ejecuta en solo 1 segundo.

Evita las bibliotecas en secuencias de comandos con mucha IU

Las bibliotecas son una forma conveniente de reutilizar código, pero aumentan ligeramente el tiempo que se tarda en iniciar la secuencia de comandos. Esta demora no es evidente en secuencias de comandos de larga duración (como una secuencia de comandos de utilidad para limpiar tus archivos de Google Drive), pero en las interfaces de usuario del servicio HTML del cliente que realizan llamadas de google.script.run repetidas y de corta duración, el retraso afectará a cada llamada. Debido a este problema, las bibliotecas deben usarse con moderación en los complementos, y es posible que desees evitarlas en secuencias de comandos que no sean de complementos y que realicen muchas llamadas a google.script.run.

Usa el servicio de caché

Puedes usar el servicio de caché para almacenar en caché recursos entre ejecuciones de secuencias de comandos. Si almacenas datos en caché, puedes reducir la cantidad de veces o la frecuencia con la que debes recuperar los datos. Imagina que tienes un feed RSS en example.com que tarda 20 segundos en recuperar y deseas acelerar el acceso en la solicitud promedio. En el siguiente ejemplo, se muestra cómo usar el servicio de caché para acelerar el acceso a estos datos.

  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;
  }

Si bien deberás esperar 20 segundos si el elemento no está en la caché, los accesos posteriores serán muy rápidos hasta que el elemento venza de la caché en 25 minutos.