Google Sheets — Used range

Google Sheets — Used range

Tipo: googlesheets-get-used-range  ·  Paquete: Google Sheets Activities v1.0.5  ·  Salida: Dictionary<string,object>

Devuelve las dimensiones del área con datos de una hoja: cuántas filas y columnas, dónde terminan y el rango en notación A1. Útil para saber el tamaño antes de procesar, para escribir justo debajo de lo último o para construir un rango dinámico.

Cómo funciona

Lee la hoja sheet (la primera si se omite) y mide el área desde A1 hasta la última fila con datos y la columna más a la derecha con datos. Las filas vacías intermedias cuentan (el área llega hasta el último dato); las del final, no.

Parámetros requeridos

Ninguno.

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 un Dictionary con estas claves:

Clave	Tipo	Contenido
rows	int	Número de filas del área, contando desde la fila 1.
columns	int	Número de columnas del área, contando desde la columna A.
lastRow	int	Número de la última fila con datos (igual a rows).
lastColumn	int	Número de la última columna con datos (igual a columns; 3 = columna C).
range	string	Rango completo con el nombre de la hoja, p. ej. Pedidos!A1:E120.

Si la hoja está vacía, todas las cifras valen 0 y range es nulo.

Errores comunes

Mensaje	Causa y solución
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.
La hoja de cálculo no tiene hojas para leer.	Se omitió sheet y el documento no tiene hojas.
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

Escribir un total justo debajo de los datos:

Google Sheets — Used range   session = hoja   sheet = "Pedidos"   → output: dim
Google Sheets — Write cell   session = hoja   sheet = "Pedidos"
                             cell = "E" + (num(dim["lastRow"]) + 1)
                             value = "=SUM(E2:E" + dim["lastRow"] + ")"

Actividades relacionadas

• Read range — leer el área con datos.
• Append rows — agregar filas al final sin calcular la posición.
• Get sheet names — listar las hojas.