Google Sheets Activities

Versión: 1.0.0  ·  ID: zoan-packages-googlesheets  ·  Autor: Zoan Software

El paquete Google Sheets lee y escribe hojas de cálculo de Google directamente en la nube (a través de su API). Es el equivalente de Excel para documentos de Google: ideal cuando los datos viven en una hoja compartida de Google Drive que varias personas o sistemas actualizan.

Concepto 1: la conexión OAuth de Google

A diferencia de Excel (que abre un archivo local), Google Sheets accede a una hoja en la nube, así que necesita autorización. Esa autorización se configura una vez en Nexus como una conexión OAuth de Google, y luego la referencias por su nombre.

Lo que necesitas	Dónde se obtiene
Conexión OAuth	Se configura en Nexus (autorizas el acceso a tu cuenta de Google). La referencias por su nombre en el parámetro credential.
ID de la hoja (spreadsheetId)	Está en la URL de la hoja: docs.google.com/spreadsheets/d/{ID}/edit — copia la parte {ID}.

Alternativa: service account

Además de la conexión OAuth, Google Sheets — Open admite autenticarse con una llave de service account (parámetro authType = service-account): no requiere consentimiento de usuario, ideal para desatendido. La llave se guarda como credencial y la hoja debe compartirse con el email del service account.

Concepto 2: la sesión

Todas las operaciones trabajan sobre una sesión que abres con Google Sheets — Open (pasando la conexión y el ID) y compartes con las demás actividades:

• Con body: las actividades dentro heredan la sesión; al terminar se cierra sola.
• Sin body: guardas la sesión en una variable y la cierras con Google Sheets — Close.

Google Sheets — Open   credential = "google-clinica"   spreadsheetId = = idHoja
 └─ body:
      Google Sheets — Read sheet   sheet = "Citas"   has-headers = true   → output: citas
      ... procesar ...

Notación A1 y encabezados

• Celdas y rangos usan notación A1: A1, B3, A1:E10, A:E (columnas completas).
• Hojas: por nombre ("Citas"); si lo omites, usa la primera/activa.
• has-headers: en las lecturas, si lo pones en true, la primera fila se trata como encabezados y el resultado es una DataTable; si es false (por defecto), devuelve una lista de filas crudas.

Las escrituras admiten fórmulas

Al escribir, los valores se interpretan como USER_ENTERED: si escribes =SUM(A1:A10), Google Sheets lo guarda como fórmula, igual que si lo teclearas tú.

Actividades

Sesión

Actividad	Tipo	Salida	Qué hace
Google Sheets — Open	googlesheets-open	ZoanGoogleSheetsSession	Abre una sesión autenticada con una hoja
Google Sheets — Close	googlesheets-close	—	Cierra la sesión

Leer

Actividad	Tipo	Salida	Qué hace
Read sheet	googlesheets-read-sheet	DataTable / List	Lee toda una hoja
Read range	googlesheets-read-range	DataTable / List	Lee un rango
Read cell	googlesheets-read-cell	object	Lee una celda
Used range	googlesheets-get-used-range	Dictionary	Dimensiones del área con datos
Get sheet names	googlesheets-get-sheet-names	List	Nombres de las hojas
Find cell	googlesheets-find-cell	Dictionary	Encuentra una celda por valor
Find row	googlesheets-find-row	object	Encuentra una fila por valor de columna

Escribir

Actividad	Tipo	Salida	Qué hace
Write sheet	googlesheets-write-sheet	—	Escribe datos desde A1
Write range	googlesheets-write-range	—	Escribe en un rango
Write cell	googlesheets-write-cell	—	Escribe una celda
Append rows	googlesheets-append	—	Agrega filas al final
Clear range	googlesheets-clear-range	—	Limpia el contenido de un rango

Siguientes pasos

• Google Sheets — Open — abrir una hoja.
• Read sheet — leer datos a una DataTable.
• Excel — el equivalente para archivos .xlsx locales.