Google Sheets — Write sheet

Google Sheets — Write sheet

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

Escribe un conjunto de datos en la hoja, empezando desde A1. Es la forma directa de volcar datos a Google Sheets: una tabla leída de Excel, el resultado de una consulta o un reporte calculado.

Cómo funciona

Escribe los values a partir de A1 en la hoja sheet (la primera si se omite), en una sola llamada a Google. Equivale a Write range con range = "A1":

• Acepta una DataTable o un DataRow; escribe solo los valores, sin los nombres de columna.
• Los valores se interpretan como USER_ENTERED (fórmulas, números y fechas como si los teclearas).
• Sobrescribe el área que ocupan los datos y no borra lo que quede fuera: si la hoja tenía más filas que la tabla nueva, esas filas siguen ahí. Para reemplazar todo el contenido, ejecuta antes Clear range.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
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, escribe en la primera hoja.

Salida

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

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. Pasa una 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

Reemplazar el contenido de una hoja con los datos de un Excel local:

Read Excel Sheet   path = asset("datos.xlsx")   → output: tabla
Google Sheets — Clear range   session = hoja   sheet = "Importado"   range = "A:Z"
Google Sheets — Write sheet   session = hoja   sheet = "Importado"   values = tabla

Valores, no encabezados

Write sheet escribe los valores de la DataTable, no sus nombres de columna. Si quieres una fila de títulos, escríbela aparte (por ejemplo con Write range en la fila 1 y los datos desde A2) o inclúyela como primera fila de los datos.

Actividades relacionadas

• Write range — escribir en una posición concreta.
• Append rows — agregar al final sin sobrescribir.
• Clear range — limpiar antes de escribir.