Google Sheets — Open

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

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

Cómo funciona

Prepara el acceso a la hoja indicada en spreadsheetId con la autenticación elegida. Dos modos de uso:

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

Open no llama a Google: no comprueba que la hoja exista ni que la cuenta tenga acceso. Esos problemas aparecen en la primera lectura o escritura, con el error de la API correspondiente.

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 Zoan Cloud en credential, como credential("nombre-clave"). Zoan Cloud entrega un token vigente y lo renueva solo. La conexión debe estar Conectada e incluir el permiso de Sheets.
service-account: usa una llave de service account guardada como credencial (el JSON completo descargado de Google Cloud) en serviceAccount. No requiere consentimiento de una persona: ideal para desatendido. La hoja debe estar compartida con el email de la service account. Con impersonateUser, actúa en nombre de un usuario del Workspace (requiere domain-wide delegation configurada por el administrador del Workspace).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`spreadsheetId`	`string`	—	ID de la hoja, de la URL `docs.google.com/spreadsheets/d/{ID}/edit`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`authType`	`string`	`oauth`	Modo de autenticación: `oauth` o `service-account`.
`credential`	`credential`	—	Modo OAuth: la conexión OAuth de Google de Zoan Cloud, `credential("nombre-clave")`.
`serviceAccount`	`credential`	—	Modo service account: credencial cuyo valor es el JSON completo de la llave. Nunca pegues la llave en el parámetro.
`impersonateUser`	`string`	—	Modo service account (opcional): email del usuario del Workspace en cuyo nombre se actúa.

Sub-flujos

`body`

Actividades a ejecutar dentro de la sesión. La heredan sin indicar session y la sesión se cierra al terminar.

Salida

Sin body, devuelve un ZoanGoogleSheetsSession: guárdalo en una variable y pásalo como session a las demás actividades. Con body no devuelve nada (la sesión se hereda y se cierra sola).

Errores comunes

Mensaje	Causa y solución
`'spreadsheetId' es obligatorio.`	`spreadsheetId` quedó vacío o su expresión dio nulo.
`Credential '…' could not be resolved. Verify it exists in Zoan Automation and that there is an active session.`	La conexión o credencial no existe en el ambiente, se usó el nombre legible en vez del nombre clave, o no hay sesión con Zoan Cloud.
`'credential' no contiene un access_token válido. Revisa la conexión OAuth en Zoan Cloud.`	La conexión existe pero no tiene token (por ejemplo, quedó Pendiente). Autorízala en Zoan Cloud.
`'serviceAccount' debe apuntar a una credencial de Zoan Cloud que contenga la clave JSON de la cuenta de servicio.`	En modo service account, la credencial está vacía.
`La credencial de la cuenta de servicio no es una clave JSON válida de cuenta de servicio de Google. …`	El valor guardado no es el JSON completo de la llave. Vuelve a guardarlo tal como lo descargaste.

Ejemplo

Google Sheets — Open   credential = credential("google-operaciones")   spreadsheetId = "1AbC...XyZ"
 └─ body:
      Google Sheets — Read sheet   sheet = "Pedidos"   has-headers = true   → output: pedidos
      Log   message = "Pedidos leídos: " + rowCount(pedidos)

Con service account, para una ejecución desatendida:

Google Sheets — Open   authType = service-account   serviceAccount = credential("google-sa-reportes")
                       spreadsheetId = idHoja
 └─ body:
      Google Sheets — Append rows   sheet = "Bitácora"   values = resumen

Actividades relacionadas

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