Google Drive & Calendar

Descripcion

Este modulo integra dos servicios de Google en un unico nodo configurable:

• Google Drive: Listar archivos y carpetas, subir archivos con tipo MIME configurable y carpeta destino, descargar archivos por ID.
• Google Calendar: Listar calendarios, listar eventos con filtros de fecha, obtener detalle de un evento, crear eventos con asistentes y zona horaria, actualizar eventos existentes y eliminar eventos.

La operacion se determina automaticamente segun el sub-nodo utilizado (List Drive Files, Upload to Drive, List Calendar Events, etc.) o mediante el parametro operation. Utiliza OAuth2 con refresh automatico del token a traves del servicio googleOAuthService. Cada operacion se registra para auditoria.

El modulo soporta continueOnError para que el flujo continue aun cuando ocurra un error.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Google OAuth configurada en el sistema
operation	select	Si	Operacion a realizar: listDriveFiles, uploadToDrive, downloadFromDrive, listCalendars, listCalendarEvents, getCalendarEvent, createCalendarEvent, updateCalendarEvent, deleteCalendarEvent

Parametros por operacion (sub-nodos)

List Drive Files:

Parametro	Tipo	Requerido	Descripcion
pageSize	number	No	Numero de archivos a obtener (1-100, default: 10)
driveQuery	text	No	Filtro de busqueda, ej: ‘name contains “reporte“‘
outputKey	text	No	Clave de salida para la lista (default: files)

Upload to Drive:

Parametro	Tipo	Requerido	Descripcion
fileName	text	Si	Nombre del archivo a subir
mimeType	text	No	Tipo MIME (default: application/octet-stream)
parentFolderId	text	No	ID de la carpeta destino en Drive
fileContentKey	text	No	Clave en los datos de entrada con el contenido (default: fileContent)

Download from Drive:

Parametro	Tipo	Requerido	Descripcion
fileId	text	Si	ID del archivo en Google Drive
fileIdKey	text	No	Clave en data con el ID del archivo (default: fileId)
outputKey	text	No	Clave de salida (default: fileContent)

List Calendar Events:

Parametro	Tipo	Requerido	Descripcion
calendarId	google_calendar	No	ID del calendario (default: primary)
maxResults	number	No	Maximo de eventos (1-250, default: 10)
timeMin	calendar_datetime	No	Fecha/hora minima en formato ISO
timeMax	calendar_datetime	No	Fecha/hora maxima en formato ISO

Create Calendar Event:

Parametro	Tipo	Requerido	Descripcion
calendarId	google_calendar	No	Calendario destino (default: primary)
summary	text	Si	Titulo del evento
description	textarea	No	Descripcion del evento
startDateTime	calendar_datetime	Si	Fecha/hora de inicio (ISO)
endDateTime	calendar_datetime	Si	Fecha/hora de fin (ISO)
timeZone	select	No	Zona horaria (default: America/Mexico_City)
attendees	text	No	Emails de asistentes separados por coma

Update Calendar Event:

Parametro	Tipo	Requerido	Descripcion
eventId	text	No	ID del evento (o variable dinamica)
eventIdKey	text	No	Clave en data con el ID (default: id)
summary	text	No	Nuevo titulo
description	textarea	No	Nueva descripcion
startDateTime	calendar_datetime	No	Nueva fecha inicio
endDateTime	calendar_datetime	No	Nueva fecha fin

Delete Calendar Event / Get Calendar Event:

Parametro	Tipo	Requerido	Descripcion
eventId	text	No	ID del evento
eventIdKey	text	No	Clave en data con el ID (default: id)

Credenciales

Requiere credenciales de tipo Google OAuth2. Se configuran en el sistema con:

• Client ID y Client Secret de Google Cloud Console
• Scopes para Drive y/o Calendar
• El modulo gestiona el refresh del token automaticamente mediante googleOAuthService.getAuthenticatedClient()

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "files": [
      {
        "id": "abc123",
        "name": "documento.pdf",
        "mimeType": "application/pdf",
        "size": 1024,
        "createdTime": "2026-01-01T00:00:00Z",
        "modifiedTime": "2026-01-02T00:00:00Z"
      }
    ]
  },
  "_meta_": {
    "operation": "listDriveFiles",
    "recordsProcessed": 1,
    "googleService": "drive",
    "nodeName": "List Drive Files"
  }
}

Ejemplo de Uso

Caso basico - Listar archivos

{
  "credentials_id": "mi-cuenta-google",
  "operation": "listDriveFiles",
  "pageSize": "20"
}

Caso basico - Crear evento

{
  "credentials_id": "mi-cuenta-google",
  "operation": "createCalendarEvent",
  "summary": "Reunion de equipo",
  "startDateTime": "2026-03-25T10:00:00",
  "endDateTime": "2026-03-25T11:00:00",
  "timeZone": "Europe/Madrid"
}

API Utilizada

• Google Drive API v3 (googleapis)
• Google Calendar API v3 (googleapis)

Notas

• Los valores se pueden pasar desde config o desde los datos de entrada (data)
• El campo eventId se busca en multiples ubicaciones: config.eventId > data[eventIdKey] > data.id > data.eventId
• Los recordatorios al crear evento incluyen por defecto: email 24h antes y popup 10 min antes
• Soporta variables dinamicas en los campos de texto (ej: {{id}}, {{summary}})
• Se registra auditoria OAuth por cada operacion ejecutada

Nodos Relacionados

• List Drive Files (sub-nodo)
• Upload to Drive (sub-nodo)
• Download from Drive (sub-nodo)
• List Calendars (sub-nodo)
• List Calendar Events (sub-nodo)
• Get Calendar Event (sub-nodo)
• Create Calendar Event (sub-nodo)
• Update Calendar Event (sub-nodo)
• Delete Calendar Event (sub-nodo)