Google Sheets — Read cell

Tipo: googlesheets-read-cell · Paquete: Google Sheets Activities v1.0.5 · Salida: object

Lee el valor de una celda concreta. Úsala cuando solo necesitas un dato puntual: un total, un estado, un parámetro que alguien ajusta en la hoja.

Cómo funciona

Lee la celda cell (notación A1) de la hoja sheet (la primera si se omite) con una llamada a Google. El valor llega tal como se ve en la hoja: un número con formato 1.500,00 llega como el texto "1.500,00", y una fórmula como su resultado.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`cell`	`string`	—	Dirección de la celda en notación A1, p. ej. `B3`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanGoogleSheetsSession`	—	Sesión de Google Sheets — Open. Dentro del `body` de Open se hereda y puedes omitirla.
`sheet`	`string`	—	Nombre de la hoja. Si se omite, se usa la primera hoja.

Salida

Devuelve el valor de la celda como texto (string), o nulo si la celda está vacía. Para calcular con él, conviértelo: num(limite). Comprueba el vacío con isNull(valor).

Errores comunes

Mensaje	Causa y solución
`'cell' es obligatorio. Ejemplo: A1, B3.`	`cell` quedó vacío o su expresión dio nulo.
`No hay una sesión de Google Sheets disponible. Indica 'session' desde una actividad googlesheets-open o coloca esta actividad dentro del cuerpo de la actividad Open …`	La actividad está fuera del `body` de Open y no recibió `session`. Colócala dentro del `body` o pasa la sesión guardada.
`The service sheets has thrown an exception. HttpStatusCode is …`	Google rechazó la llamada: hoja o rango inexistente, sin acceso, token vencido o cuota superada. Ver errores de la API de Google.

Ejemplo

Google Sheets — Read cell   session = hoja   sheet = "Config"   cell = "B2"   → output: limite
If   condition = !isNull(limite) && num(limite) > 0
 └─ then:
      Log   message = "Límite configurado: " + limite

Actividades relacionadas

Write cell — escribir una celda.
Find cell — encontrar una celda por su valor.