Google Sheets — Append rows

Tipo: googlesheets-append · Paquete: Google Sheets Activities v1.0.5 · Salida: —

Agrega filas al final de los datos existentes, sin sobrescribir. Ideal para acumular registros en una hoja compartida a lo largo del tiempo: una bitácora, resultados que crecen, pedidos que llegan cada día. No necesitas calcular en qué fila escribir.

Cómo funciona

Google localiza la tabla de datos dentro de range (por defecto A:Z de la hoja sheet, o de la primera hoja) y escribe las values justo debajo de su última fila, en una sola llamada:

Acepta una DataTable (todas sus filas) o un DataRow (una sola fila). Se escriben solo los valores, sin los nombres de columna.
Las filas se insertan: si hay contenido debajo de la tabla, se desplaza hacia abajo en lugar de sobrescribirse.
Los valores se interpretan como USER_ENTERED (fórmulas, números y fechas como si los teclearas).
Cada ejecución agrega filas nuevas: si repites la actividad con los mismos datos, quedan duplicados.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`values`	`DataTable \| DataRow`	—	Las filas a agregar (solo valores, sin encabezados).

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`	—	Hoja donde agregar. Si se omite, se usa la primera hoja.
`range`	`string`	`A:Z`	Rango donde Google busca la tabla y su última fila.

Salida

Esta actividad no devuelve ningún valor. El log indica cuántas filas se agregaron.

Errores comunes

Mensaje	Causa y solución
`'values' es obligatorio.`	`values` quedó vacío o su expresión dio nulo.
`'values' debe ser un DataTable (o un solo DataRow).`	Se pasó una lista, un texto u otro tipo. Construye la fila con Build DataTable o Add Data Row.
`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

Registrar el resultado de cada ejecución en una bitácora:

Build DataTable   columns = arr("Fecha", "Proceso", "Estado")
                  rows    = arr(arr(now().ToString("yyyy-MM-dd HH:mm"), proceso, "OK"))
                  → output: registro
Google Sheets — Append rows   session = hoja   sheet = "Bitácora"   values = registro

Actividades relacionadas

Write sheet — escribir desde A1 (sobrescribe).
Write range — escribir en una posición fija.