Google Sheets — Write range

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

Escribe valores a partir de una celda concreta, sobrescribiendo lo que haya. Úsala para colocar datos en una posición exacta: rellenar una zona de una plantilla o volcar una tabla debajo de unos títulos fijos.

Cómo funciona

Escribe los values empezando en la celda superior izquierda de range, en la hoja sheet (la primera si se omite), en una sola llamada a Google:

Acepta una DataTable (todas sus filas) o un DataRow (una sola fila). Se escriben solo los valores, nunca los nombres de columna.
Los valores se interpretan como USER_ENTERED (fórmulas, números y fechas como si los teclearas).
Sobrescribe las celdas que ocupa la tabla; lo que esté fuera de esa área no se toca. Si los datos nuevos son más cortos que los anteriores, limpia primero con Clear range.
Si das un rango (A2:C10) en vez de una celda, debe ser al menos tan grande como los datos; con una sola celda (A2) la tabla se extiende lo que haga falta.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`range`	`string`	—	Celda inicial o rango donde escribir, p. ej. `A1`, `B3`.
`values`	`DataTable \| DataRow`	—	Los datos a escribir (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`	—	Nombre de la hoja. Si se omite, se usa la primera hoja.

Salida

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

Errores comunes

Mensaje	Causa y solución
`'range' es obligatorio.`	`range` quedó vacío o su expresión dio nulo.
`'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 tabla con Build DataTable.
`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

Escribir una fila de títulos y, debajo, los datos:

Build DataTable   columns = arr("c1", "c2")   rows = arr(arr("Cliente", "Total"))   → output: titulos
Google Sheets — Write range   session = hoja   range = "A1"   values = titulos
Google Sheets — Write range   session = hoja   range = "A2"   values = datos

Actividades relacionadas

Write sheet — escribir desde A1.
Write cell — escribir una sola celda.
Append rows — agregar al final.