Soy un "newbee". Pero es mi experiencia que solo puede acceder a una "celda" a través del objeto "rango". Debe definir el rango como una sola celda. Por ejemplo "A1: A1", le dará acceso a la celda en "A1".
Una RANGE es un objeto asociado a una "HOJA". UNA HOJA es un objeto asociado a una "HOJA DE DATOS".
Aquí algunos ejemplos de código para acceder a la celda A1 de la hoja activa actual:
var cell_A1 = SpreadsheetApp.getActiveSheet().getRange("A1:A1");
Desde aquí se puede pasar el objeto como cualquier otro parámetro.
myFunction(cell_A1);
La función de recepción debe "saber" que se trata de un "rango". Solo puede acceder a sus valores llamando a los "métodos" asociados al objeto "rango".
¡Cuidado! Un "rango" puede consistir en más de una celda. Su función llamada debería probar para ver si está funcionando con una sola célula. Si supera un rango de más de una celda, es posible que su función no actúe de la manera esperada.
Los dos métodos de un objeto de rango: "getNumRows()" y "getNumColumns()" devuelve los números de Filas y Columnas en un objeto de rango.
En general, si se utiliza métodos que se limitan a cambiar o acceder una sola célula, y operar en un conjunto mayor rango, la función sólo se realiza en el miembro de celda superior izquierda. Pero ten cuidado. Mientras que suponga que un método solo cambiará una sola celda, en realidad puede afectar a todas las celdas del rango. Lea la documentación de cerca.
Hay otro método para obtener un rango de una sola celda. Su instrucción se ve así:
var cell_B2 = SpreadsheetApp.getActiveSheet().getRange(2, 2, 1, 1).
Los dos primeros parámetros decir la función "GetRange" la ubicación de la celda (en la fila, el formato de la columna). Los dos segundos parámetros definen el número de "filas" y "columnas" asociadas al rango. Al establecerlos en "1", accede a una sola celda.
Espero que esto ayude.
Estas funciones personalizadas son lentas. Ten cuidado. – fiatjaf
Parece que las funciones disponibles en la hoja de cálculo no están todas disponibles para el script. Por ejemplo, intentar usar la función JOIN en un script da como resultado el error "JOIN no definido", aunque el uso de JOIN en la hoja de cálculo funciona bien. – Triynko