Google Drive — Connect

Google Drive — Connect

Tipo: googledrive-connect  ·  Paquete: Google Drive v1.0.5  ·  Salida: ZoanGoogleDriveSession

Abre una sesión autenticada con Google Drive. Es el punto de partida del paquete: todas las demás actividades (subir, descargar, listar, mover, compartir…) trabajan sobre esta sesión.

Cómo funciona

Se autentica con una conexión OAuth de Google de Zoan Cloud (o una service account) y abre la sesión. Tiene dos formas de uso:

• Con body: las actividades que coloques dentro heredan la sesión automáticamente; al terminar el bloque se cierra sola, también si una actividad falla.
• Sin body: devuelve la sesión como salida; guárdala en una variable, pásala por session a las demás actividades y ciérrala con Google Drive — Close.

Al conectar consulta el email de la cuenta para identificar la sesión en los registros. Si esa consulta falla (token vencido, sin red), no se detiene: el error aparece en la primera operación con Drive.

Autenticación

Dos modos en authType: oauth (por defecto — conexión OAuth de Zoan Cloud con el permiso de Drive) o service-account (llave JSON guardada como credencial, con impersonateUser opcional para domain-wide delegation). El Designer muestra solo los campos del modo elegido. Ver la autenticación.

Parámetros requeridos

Ninguno.

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 con el JSON completo de la llave.
impersonateUser	string	—	Modo service account (opcional): email del usuario del Workspace a suplantar (domain-wide delegation).

Sub-flujos

body

Actividades a ejecutar dentro de la sesión. Heredan la sesión automáticamente y, al terminar, esta se cierra.

Salida

Sin body, devuelve un ZoanGoogleDriveSession: asígnalo a una variable y pásalo como session a las demás actividades. Con body no devuelve nada (la sesión se hereda sola).

Errores comunes

Mensaje	Causa y solución
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 Drive — Connect   credential = credential("drive-operaciones")
 └─ body:
      Google Drive — Create folder   name = "Reportes"   → output: carpeta
      Google Drive — Upload   path = "C:\reportes\hoy.pdf"   folderId = carpeta["id"]   → output: subido
      Log   message = "Disponible en " + subido["webViewLink"]

Se navega por ID de carpeta, no por ruta

Drive identifica archivos y carpetas por ID, no por ruta. Usa root para la raíz de Mi unidad y obtén los IDs con List files o Get info. Al descargar, los documentos nativos de Google se exportan solos (Docs→docx, Sheets→xlsx, Slides→pptx, otros→pdf).

Actividades relacionadas

• Google Drive — Upload — subir un archivo.
• Google Drive — List files — listar o buscar archivos.
• Google Drive — Close — cerrar la sesión (modo sin body).
• Todas las actividades de Google Drive