Google Sheets

Descripcion

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

Requisitos

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

Configuracion

Sub-nodos disponibles

1. Read Sheet

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

Campo	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
range	text	No	Rango en notacion 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	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
spreadsheetId	google_spreadsheet	Si	Hoja de calculo
range	text	No	Rango en notacion 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	Descripcion
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	Descripcion
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	Descripcion
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 informacion del spreadsheet: hojas, dimensiones, titulo.

Campo	Tipo	Requerido	Descripcion
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	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth
title	text	Si	Titulo 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	Descripcion
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	Descripcion
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 (vacio = 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	Solucion
Spreadsheet not found	ID incorrecto o sin acceso	Verifica el ID y los permisos
Unable to parse range	Rango con formato invalido	Usa notacion 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 vacio	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