Google Sheets — Open

Google Sheets — Open

Tipo: googlesheets-open  ·  Paquete: Google Sheets Activities v1.0.0  ·  Salida: ZoanGoogleSheetsSession

Abre una sesión autenticada con una hoja de Google Sheets y la devuelve como ZoanGoogleSheetsSession. Es el punto de partida obligatorio: todas las demás actividades trabajan sobre esta sesión.

Cómo funciona

Se autentica contra Google y abre la sesión sobre el ID de la hoja (spreadsheetId). Dos modos de uso del cuerpo:

• Con body: las actividades dentro heredan la sesión; al terminar se cierra sola.
• Sin body: devuelve la sesión como salida; pásala como session a las actividades y ciérrala con Google Sheets — Close.

Autenticación

El parámetro authType elige cómo autenticar (el Designer muestra solo los campos del modo elegido):

• oauth (por defecto): usa una conexión OAuth de Google de Nexus (campo credential). Requiere consentimiento de un usuario; ideal cuando el bot actúa sobre una cuenta concreta.
• service-account: usa una llave de service account guardada como credencial (campo serviceAccount). No requiere consentimiento — ideal para desatendido. La hoja debe estar compartida con el email del service account. Opcionalmente, impersonateUser actúa en nombre de un usuario del Workspace (domain-wide delegation).

Parámetros requeridos

Parámetro	Editor	Descripción
spreadsheetId	expresión	ID de la hoja, de la URL docs.google.com/spreadsheets/d/{ID}/edit.

Parámetros opcionales

Parámetro	Editor	Descripción
authType	enum	oauth (por defecto) o service-account.
credential	credencial	Modo OAuth: nombre de la conexión OAuth de Google en Nexus.
serviceAccount	credencial	Modo service account: credencial con el JSON completo de la llave.
impersonateUser	expresión	Modo service account (opcional): email del usuario del Workspace a impersonar.

Sub-flujos (lanes)

body opcional

Actividades a ejecutar dentro de la sesión. Se cierra al terminar.

Salida

Devuelve un ZoanGoogleSheetsSession. Pásalo como session a las demás actividades.

Ejemplo

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

La conexión se configura en Nexus

El parámetro credential no es una contraseña sino el nombre de una conexión OAuth de Google que un administrador autoriza una vez en Nexus. Allí se concede a Zoan el acceso a tu cuenta de Google. Ver conexión OAuth.

Actividades relacionadas

• Google Sheets — Close — cerrar la sesión (modo sin body).
• Read sheet / Write sheet — operar con la sesión.