Google Sheets — Read range

Google Sheets — Read range

Tipo: googlesheets-read-range  ·  Paquete: Google Sheets Activities v1.0.5  ·  Salida: DataTable

Lee un rango de celdas concreto en una DataTable. Igual que Read sheet, pero acotado a un rango en notación A1: útil cuando solo te interesa una parte de la hoja, o cuando los datos no empiezan en A1.

Cómo funciona

Lee el range indicado en la hoja sheet (la primera si se omite). Google devuelve desde la primera celda del rango hasta la última fila y columna con datos dentro de él, así que A:E no trae miles de filas vacías.

• Con has-headers = true, la primera fila del rango da los nombres de columna.
• Con has-headers = false (por defecto), las columnas se llaman Column1, Column2, …
• Todas las celdas llegan como texto tal como se ven en la hoja; las vacías como "".

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
range	string	—	Rango en notación A1: A1:E10, A:E, 1:100.

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.
has-headers	bool	false	Usar la primera fila del rango como nombres de columna; si no, Column1, Column2, …

Salida

Siempre un DataTable con columnas de texto. Si el rango está vacío, devuelve una DataTable vacía (sin columnas ni filas).

Errores comunes

Mensaje	Causa y solución
'range' es obligatorio.	range 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.
A column named '…' already belongs to this DataTable.	Con has-headers = true, dos encabezados del rango tienen el mismo texto.
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 range   session = hoja   sheet = "Resumen"   range = "B3:E50"   has-headers = true   → output: datos
Log   message = "Filas leídas: " + rowCount(datos)

Actividades relacionadas

• Read sheet — leer toda la hoja.
• Used range — conocer el rango con datos antes de leer.
• Read cell — leer una celda.