Como leer una hoja de calculo con Google Apps Scripts

• <<<< Como cambiar permisos de un fichero con Google Apps Script
• Cómo escribir en una celda de una hoja de cálculo con Google Apps Script >>>>

Google Apps Script Google Sheets

Artículo perteneciente a la introducción de Google Apps Script
Artículo referente a como usar Google Apps Script en spreadsheets

Una de las aplicaciones más usuales (y útiles) de GAS es poder obtener información de una hoja de cálculo que tengamos compartida en Drive.

Hay dos maneras de obtener la información de una hoja de cálculo de Drive:

- Leyendo casilla a casilla: Útil si hay poca información, extremadamente lento si hay mucha.
- Leyendo fila a fila : Bastante más rápido cuando el volumen de información es elevado dado que se hacen menos accesos a disco.

Dado que para mi la mejor manera de aprender es mediante los ejemplos, no os explicaré como se lee un fichero, os adjunto dos códigos muy sencillos e intentad entenderlo vosotros. Ambos hacen lo mismo, recogen todos los datos de una hoja de calculo y lo ponen dentro de un string (sin sentido por separado, pero con bastante utilidad si esta funcionalidad la tenemos en un código más grande).

Probad a copiar este código y ejecutar las funciones Lento y Rapido.

function onOpen() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var entries = [
    { name : "Lento",  functionName : "Lento"},
    { name : "Rapido",  functionName : "Rapido"}
 
  ];
  spreadsheet.addMenu("Lord Pakus Scripts", entries);
};

function Lento()
{
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var rows = sheet.getDataRange();
  var numCols = rows.getNumColumns();
  var numRows = rows.getNumRows();
  var string ="";

  for (var i = 0 ; i < numRows; ++i )
    for(var j = 0 ; j < numCols ; j++)
      string += sheet.getRange(i+1, j+1).getValue() + " ";
}


function Rapido()
{
    var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
    var sheet = spreadsheet.getActiveSheet();
    var rows = sheet.getDataRange();
    var values = rows.getValues();
    var numCols = rows.getNumColumns();
    var numRows = rows.getNumRows();
    var string ="";
 
    for(var i = 0 ;i < numRows ; ++i)
    {
      var row = values[i];
      for(var j = 0 ; j < numCols ; ++j)
      {
        string += row[j] + " ";
      }
    }
}

Cuánto más rápido? Cuánto más lento? Una forma fácil de verlo es mediante la opción de Ver->Transcripción de la Ejecución, que no hace más que un log de las cosas más importante de la ejecución y al final de todo dice cuanto ha tardado la última ejecución

Probad ambas funciones y mirad sus trazas de ejecución. Veréis que la función lenta tarda más y genera logs más extensos ( dado que tiene que hacer mas accesos a fichero ) mientras que la rápida hace un log mucho más discreto y los tiempos de ejecución son brutalmente mejores. Depende del tamaño de los datos que tengamos en esa hoja de cálculo, del número de filas y de columnas y de como están dispuestas, pero para tamaños medios-grandes de información podríamos hablar de mejores de rendimiento de x10 o x15, así que vale la pena que os acostumbréis desde el principio a leer ficheros de forma óptima.

Para cualquier duda ya sabéis que estoy a vuestra disposición.

Nos vemos

NOTA: Si te ha gustado este tutorial tal vez también te interese el tutorial sobre las diferentes maneras de obtener una fila de un spreadsheet con Google Apps Script