Saltearse al contenido
Nappai Documentation

Google Calendar Modifier

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

El Google Calendar Modifier permite a los usuarios de Nappai gestionar eventos en sus calendarios de Google directamente desde el dashboard. Con él puedes crear nuevos eventos, actualizar los existentes o eliminarlos, todo sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Google Calendar mediante credenciales OAuth2 que el usuario debe haber configurado previamente en la sección de credenciales de Nappai. Cuando se ejecuta, el componente:

  1. Obtiene un token de acceso a través del toolkit de Gmail (GmailToolkit).
  2. Crea una instancia de GoogleCalendarManager con las credenciales y el calendario seleccionado.
  3. Convierte las fechas de inicio y fin del formato YYYY-MM-DD HH:MM:SS AM/PM TZ a ISO 8601, que es el formato que requiere la API de Google.
  4. Según la opción de Operation seleccionada, llama a la función correspondiente:
    • CREATE: crea un nuevo evento con los datos proporcionados.
    • UPDATE: actualiza los eventos listados en el campo Events.
    • DELETE: elimina los eventos listados en el campo Events.
  5. Devuelve un objeto Data (o una lista de ellos) con la respuesta de la API, que se muestra en la salida Event Result.

Entradas

CampoTipoDescripción
EventsDataInputItems to UPDATE/DELETE. Se utiliza cuando la operación es UPDATE o DELETE.
CalendarDropdownInputThe summary of the calendar to CREATE/UPDATE/DELETE events for. Se llena automáticamente con la lista de calendarios disponibles una vez que la credencial está configurada.
End TimeMessageTextInputThe end time of the event in ‘YYYY-MM-DD HH:MM:SS AM/PM TZ’ format.
DescriptionMessageTextInputThe description of the event.
LocationMessageTextInputThe location of the event.
OperationDropdownInputOperation to perform. Options: CREATE, UPDATE, DELETE.
Start TimeMessageTextInputThe start time of the event in ‘YYYY-MM-DD HH:MM:SS AM/PM TZ’ format.
Event SummaryMessageTextInputThe title or summary of the event.

Credencial
Este componente requiere una credencial de tipo Google Calendar.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial Google Calendar.
  2. Proporciona el Client Id, el Client Secret y selecciona el acceso a Google Calendar.
  3. En el componente, selecciona la credencial recién creada en el campo Credential (este campo no aparece en la lista de entradas).

Salidas

CampoTipoDescripción
Event ResultDataResultado de la operación (evento creado, actualizado o eliminado). En el caso de UPDATE o DELETE se devuelve una lista de objetos Data.

Ejemplo de Uso

  1. Crear un evento

    • Selecciona la operación CREATE.
    • Elige el calendario en el campo Calendar.
    • Rellena Event Summary, Start Time, End Time, Description y Location según sea necesario.
    • Haz clic en Run.
    • En la salida Event Result verás el objeto Data con los detalles del evento creado.

  2. Actualizar varios eventos

    • Selecciona la operación UPDATE.
    • Conecta la salida de otro componente que devuelva una lista de eventos en el campo Events.
    • Rellena los campos que deseas cambiar (por ejemplo, Location).
    • Ejecuta el flujo.
    • La salida mostrará una lista de objetos Data, cada uno con la respuesta de la actualización de un evento.

  3. Eliminar eventos

    • Selecciona la operación DELETE.
    • Conecta la salida de otro componente que devuelva los eventos a eliminar en el campo Events.
    • Ejecuta el flujo.
    • La salida mostrará un objeto Data indicando que los eventos fueron eliminados con éxito.

Componentes Relacionados

  • GoogleCalendarManager – Clase subyacente que interactúa con la API de Google Calendar.
  • GmailToolkit – Utilizado para obtener el token de acceso OAuth2.

Consejos y Mejores Prácticas

  • Mantén las fechas en el formato correcto (YYYY-MM-DD HH:MM:SS AM/PM TZ) para evitar errores de conversión.
  • Revisa la lista de eventos antes de actualizar o eliminar para asegurarte de que estás modificando los correctos.
  • Utiliza la opción de credencial con permisos mínimos necesarios (solo acceso a Google Calendar) para mejorar la seguridad.
  • Prueba en un calendario de prueba antes de operar en calendarios de producción.

Consideraciones de Seguridad

  • La credencial de Google Calendar debe guardarse con cuidado; contiene el Client Id y el Client Secret.
  • Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial en Nappai.
  • La API de Google Calendar requiere autorización OAuth2; el token de acceso se renueva automáticamente, pero no debe compartirse.
  • Evita exponer la salida Event Result en flujos públicos si contiene información sensible.