Google Sheets — Read sheet

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

Lee todos los datos de una hoja y los devuelve siempre como DataTable. Es la lectura más común: traer el contenido completo para procesarlo fila a fila, filtrarlo o pasarlo a otra actividad.

Cómo funciona

Lee el área con datos de la hoja indicada (la primera si omites sheet), desde A1 hasta la última fila y columna con contenido, en una sola llamada a Google.

Con has-headers = true, la primera fila da los nombres de columna y las filas siguientes son los datos. Las celdas de una fila más larga que la fila de encabezados se descartan.
Con has-headers = false (por defecto), las columnas se llaman Column1, Column2, … hasta la fila más larga, y la primera fila también es un dato.
Todas las celdas llegan como texto tal como se ven en la hoja; las celdas vacías como "". Una fórmula se lee como su resultado.

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, lee la primera hoja.
`has-headers`	`bool`	`false`	Tratar la primera fila como nombres de columna. Si es `false`, las columnas se nombran `Column1`, `Column2`, …

Salida

Siempre un DataTable con columnas de texto. Si la hoja está vacía, devuelve una DataTable vacía (sin columnas ni filas), no un error: compruébalo con rowCount(tabla) == 0. Con has-headers = true y solo la fila de encabezados, devuelve las columnas sin filas.

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 visibles para la API.
`A column named '…' already belongs to this DataTable.`	Con `has-headers = true`, dos encabezados tienen el mismo texto. Renombra uno en la hoja o lee con `has-headers = false`.
`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 sheet   session = hoja   sheet = "Pedidos"   has-headers = true   → output: pedidos
For Each   items = pedidos   itemVariable = fila
 └─ activities:
      Log   message = str(fila["Cliente"]) + " — " + num(fila["Total"])

Actividades relacionadas

Read range — leer solo un rango.
Write sheet — escribir datos de vuelta.
Get sheet names — saber qué hojas hay.