Estas simples instrucciones proveen una manera simple de acceder a la información de la página activa donde sea instalado el script. Lo ideal es que tengas estas 4 funciones a mano y puedas utilizarlas hasta que te familiarices con el acceso a datos convencional.
El código está diseñado de manera de utilizar las llamadas en diferentes niveles, para que se pueda obtener el libro, la página, el rango de celdas o direcamente todos los datos de la página.
Decidí utilizar el símbolo $ como antecesor al nombre de la función para identificarlas fácilmente dentro del código. Además, la letra que sigue indica que objeto se va a obtener invocando la función de la manera siguiente:
Función para obtener el LIBRO: $l
function $l(){
//Función para obtener la pagina activa.
var libro = SpreadsheetApp.getActiveSpreadsheet();
return libro;
}
Función para obtener la HOJA: $h
function $h(n){
//Devuelve la hoja con nombre igual al parámetro.
return $l().getSheetByName(n);
}
Función para obtener el RANGO: $r
function $r(n){
//Devuelve el rango de las celdas que contienen datos
// de la hoja con nombre igual al parámetro.
var h = $h(n);
return h.getRange(1, 1, h.getLastRow()-1, h.getLastColumn()-1);
}
Función para obtener los DATOS: $d
function $d(n){
//Función que devuelve una matriz con los valores
//de la hoja con nombre igual al parámetro.
return $r(n).getValues();
}