Google Sheets

Descripción

Modulo completo para operar con hojas de calculo de Google: leer, escribir, crear, buscar y reemplazar datos. Incluye múltiples sub-nodos para diferentes operaciones.

Requisitos

Credencial Google OAuth configurada con permisos de Google Sheets (spreadsheets)

Configuración

Sub-nodos disponibles

1. Read Sheet

Lee datos de una hoja de calculo como array de arrays (formato raw).

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
range	text	No	Rango en notación A1. Default: `Sheet1!A:Z`
outputKey	text	No	Campo de salida. Default: `sheetData`

Salida:

{
  "sheetData": [
    ["Nombre", "Email", "Telefono"],
    ["Juan", "juan@mail.com", "555-0001"],
    ["Maria", "maria@mail.com", "555-0002"]
  ]
}

2. Read as Objects

Lee datos como array de objetos usando la primera fila como headers/keys.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
range	text	No	Rango en notación A1. Default: `Sheet1!A:Z`
outputKey	text	No	Campo de salida. Default: `rows`

Salida:

{
  "rows": [
    { "Nombre": "Juan", "Email": "juan@mail.com", "Telefono": "555-0001" },
    { "Nombre": "Maria", "Email": "maria@mail.com", "Telefono": "555-0002" }
  ]
}

3. Write Sheet

Escribe datos en una hoja con modos de sobreescribir o anadir al final.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
sheetName	google_sheet	Si	Hoja destino
writeMode	select	Si	`append` (anadir al final) o `overwrite` (sobrescribir)
startCell	text	No	Celda inicial para modo overwrite (ej: A1). Solo si overwrite
valuesKey	text	Si	Campo con los datos a escribir. Default: `values`
headers	text	No	Columnas separadas por coma (para objetos)
includeHeaders	boolean	No	Incluir fila de encabezados. Default: true

Formatos de datos soportados:

Array de arrays: [["Juan", "juan@mail.com"], ["Maria", "maria@mail.com"]]
Array de objetos: [{"nombre": "Juan", "email": "juan@mail.com"}]
Objeto simple: {"nombre": "Juan", "email": "juan@mail.com"} (se escribe como una fila)

4. Append Rows

Atajo para agregar filas al final de los datos existentes.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
range	text	No	Hoja destino. Default: `Sheet1`
valuesKey	text	No	Campo con las filas. Default: `values`

5. Clear Range

Limpia (borra) los datos de un rango especifico.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
range	text	Si	Rango a limpiar. Default: `Sheet1!A2:Z`

Tip: Usa Sheet1!A2:Z para limpiar datos sin borrar los encabezados de la fila 1.

6. Get Sheet Info

Obtiene información del spreadsheet: hojas, dimensiones, título.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo

7. Create Spreadsheet

Crea una nueva hoja de calculo en Google Drive.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
title	text	Si	Título del spreadsheet. Default: `Nueva Hoja de Calculo`
sheetTitles	text	No	Nombres de hojas separados por coma. Default: `Sheet1`

Salida:

{
  "createdSpreadsheet": {
    "spreadsheetId": "1aBcDeF...",
    "spreadsheetUrl": "https://docs.google.com/spreadsheets/d/1aBcDeF.../edit",
    "title": "Reporte Q1 2024",
    "sheets": ["Datos", "Resumen"]
  }
}

8. Add Sheet

Agrega una nueva hoja (pestana) a un spreadsheet existente.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
sheetTitle	text	Si	Nombre de la nueva hoja

9. Find & Replace

Busca y reemplaza texto en toda la hoja de calculo.

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
find	text	Si	Texto a buscar
replace	text	No	Texto de reemplazo (vacío = eliminar)
matchCase	boolean	No	Sensible a mayusculas. Default: false
matchEntireCell	boolean	No	Coincidir celda completa. Default: false

Ejemplo de Uso

Sincronizar datos de formulario a Sheets

[Form Trigger] -> [Read as Objects] -> [Condition] -> [Append Rows]
  | nuevo registro     | leer existentes    | no duplicado    | agregar fila

Generar reporte y enviarlo

[Cron Trigger] -> [Query MySQL] -> [Create Spreadsheet] -> [Write Sheet] -> [Send Email]
  | cada lunes      | datos ventas     | nuevo archivo      | escribir datos   | adjuntar link

Limpiar y actualizar datos

[HTTP Trigger] -> [Clear Range] -> [Write Sheet]
  | nuevos datos    | limpiar A2:Z    | escribir datos actualizados

Errores comunes

Error	Causa	Solución
`Spreadsheet not found`	ID incorrecto o sin acceso	Verifica el ID y los permisos
`Unable to parse range`	Rango con formato invalido	Usa notación A1: `Sheet1!A1:D10`
`Sheet not found`	La hoja no existe en el spreadsheet	Verifica el nombre exacto de la hoja
`No values to write`	El campo de datos esta vacío	Verifica que el nodo anterior genera datos en el campo especificado

Nodos Relacionados

Google Calendar - Gestionar eventos de calendario
Google Drive - Gestionar archivos en Drive