Conector de Google Calendar

Conector de Google Calendar

Integración de Tulip con Google Calendar

Introducción

Google Calendar API permite a los usuarios crear, leer y editar eventos del calendario de Google con el acceso adecuado a sus cuentas de Google. El objetivo de este conector es utilizar la autenticación OAuth e integrar con Google Calendar V3 Api con Tulip utilizando conectores HTTP y proporcionar a nuestros clientes un conector listo para usar que se puede importar en su instancia.

Propósito

Este documento destaca diferentes funciones de conectores HTTP que se pueden construir haciendo llamadas HTTP a los puntos finales de la API de Google Calendar V3 para interactuar con el calendario de Google para probar varias acciones de lectura y escritura en el calendario que podría ser aprovechado para diversos casos de uso.

Documento API

1. Google Calendar

Requisitos previos

1. Crear una cuenta en la consola en la nube de Google y configurar las credenciales OAuth 2.0. Puede encontrar más información en los documentos de la API de Google.
2. Activa la API de Google Calendar en la consola de API de Google.

Detalles de la conexión de Tulipán

Es necesario configurar la siguiente información en los conectores de Tulip.

1. Running On: Cloud Connector Host
2. Host:www.googleapis.com
3. Puerto:443
4. TLS: Sí
5. Autenticación del conector: OAuth2.0(Admin/Operador)
6. A continuación se muestran los ámbitos necesarios para ser pasado:
7. https://www.googleapis.com/auth/calendar
8. https://www.googleapis.com/auth/calendar.events

Funciones del conector

Obtener todos los calendarios

Propósito

Este conector obtendrá todos los calendarios existentes en el calendario de google de un usuario.

Punto final

Llamada HTTP GET al punto final https://www.googleapis.com:443/calendar/v3/users/me/calendarList

Entrada requerida

No se requieren entradas

Salida requerida Extractor

1. Id. de calendario Identificador único del Calendario que se utilizará para realizar las demás tareas
2. Título: Título del calendario
3. Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida

Obtener todos los eventos

Propósito

Este conector obtendrá todos los eventos de un calendario específico.

Punto final

Llamada HTTP GET al punto final -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Entrada obligatoria

A continuación se indican los parámetros de URL que deben introducirse

1. Calendar Id- Id de calendario/ pase "primary" como valor en el parámetro de ID de calendario. Especificando "Primario" se obtienen todos los eventos del calendario primario de un usuario.

Extractor de salida requerido

1. Id. de calendario: Identificador único del Calendario que se utilizará para realizar las demás tareas
2. ID Evento: Identificador único del Evento que se utilizará para extraer detalles sobre un evento específico.
3. Título: Título del evento
4. Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida

Obtener eventos por filtro

Propósito

Este conector obtiene todos los eventos que se encuentran en el intervalo de fechas especificado por los parámetros de consulta.

Punto final

Llamada HTTP GET al punto final -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true

Entrada obligatoria

A continuación se indican los parámetros de URL que deben introducirse

1. ID de calendario: ID del calendario
2. MaxResults: Número de registros a recuperar
3. MinTime: Fecha de inicio Hora de los eventos a recuperar
4. MaxTime: Fecha y hora de finalización de los eventos a recuperar

Extractor de salida requerido

1. Id. de calendario: Identificador único del calendario que se utilizará para realizar las demás tareas.
2. ID de evento: Identificador único del evento que se utilizará para realizar las demás tareas.
3. Título: Título del evento
4. Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida

Crear un nuevo incidente para usuarios individuales/grupos/múltiples

Propósito

1. Los usuarios pueden introducir un título de evento, una descripción, una fecha de inicio y una fecha de finalización y Tulip creará un nuevo evento con el título proporcionado. La respuesta de la API serán los metadatos y varias propiedades del archivo.
2. La información se extrae de la API de Google Calendar V3 y puede ser utilizada en aplicaciones de Tulip, tablas de Tulip o variables de Tulip que se canalizarán en otras funciones del conector.

Punto final

Llamada HTTP POST al punto final https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Entrada requerida

Los siguientes son los parámetros que se envían como cuerpo de la solicitud

1. ID de calendario: ID del calendario seleccionado
2. Título del evento - Título del evento
3. Start Date Time- Hora de inicio del evento
4. End Date Time- Hora de finalización del evento
5. Zona horaria: zona horaria del evento
6. Asistentes- Asistentes al evento
7. Lugar- Lugar del evento
8. Descripción- Descripción del Evento

Extractor de salida requerido

1. Id. de Evento: Identificador único del Evento que se utilizará para realizar las demás tareas
2. Título del incidente: Título del acontecimiento
3. Organizador: Nombre del organizador del acontecimiento
4. Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida

Crear un nuevo evento recurrente para un único usuario/grupo/múltiples usuarios

Propósito

1. Los usuarios pueden pasar un Título de Evento, Descripción, FechaHora de Inicio, FechaHora de Fin, FechaHora de Fin de Recurrencia, Tipo de Recurrencia, y otros parámetros como entrada & Tulip creará un nuevo evento con el título de evento proporcionado. La respuesta de la API serán los metadatos y diversas propiedades del archivo.
2. La información se extrae de la API de Google Calendar V3 y puede ser utilizada en aplicaciones de Tulip, tablas de Tulip o variables de Tulip que se canalizarán en otras funciones del conector.

Punto final

Llamada HTTP POST al punto final https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Entrada requerida

Los siguientes son los parámetros que se envían como cuerpo de la solicitud

1. ID de calendario: ID del calendario seleccionado
2. Título del evento - Título del evento
3. Start Date Time- Hora de inicio del evento
4. End Date Time- Hora de finalización del evento
5. Zona horaria: zona horaria del evento
6. Asistentes- Asistentes al evento
7. Descripción- Descripción del evento
8. Ubicación- Ubicación del evento
9. Regla de recurrencia: la regla de recurrencia contiene todos los detalles sobre cómo y cuándo debe repetirse el evento. A continuación se muestra la lista de algunas reglas de recurrencia añadidas en la aplicación (consulte el documento [RFC5545](https://tools.ietf.org/html/rfc5545

sección-3.8.5) para reglas de recurrencia detalladas) :

Diariamente para ocurrencias:

RRULE:FREQ=DIARIO;COUNT=

Ej: RRULE:FREQ=DIAILY;COUNT=5

El evento se produce durante 5 días a partir de la fecha de inicio del evento para la misma hora de inicio y hora final.

Diariamente hasta :

RRULE:FREQ=DIARIO;HASTA=

Ex: RRULE:FREQ=DAILY;UNTIL=20210924T000000Z

El evento se produce diariamente hasta el "24 de septiembre de 2021" a partir de la fecha de inicio del evento para la misma hora de inicio y hora final.

Semanalmente para ocurrencias:

RRULE:FREQ=SEMANAL;COUNT=

Ej: RRULE:FREQ=SEMANAL;COUNT=3

El evento ocurre Semanalmente durante 3 semanas para el mismo día de la semana de la fecha de inicio del evento y para la misma hora de inicio y hora final.

Semanalmente hasta :

RRULE:FREQ=SEMANAL;HASTA=

Ex: RRULE:FREQ=WEEKLY;UNTIL=20210924T000000Z

El evento se produce Semanalmente hasta el "24 de septiembre de 2021" para el mismo día de la semana de la fecha de inicio del evento y para la misma hora de inicio y hora de finalización

Todos los martes, cada dos meses:(this)

RRULE:FREQ=MENSUAL;INTERVAL=;BYDAY=

Ej: RRULE:FREQ=MENSUAL;INTERVAL=2;BYDAY=TU

El evento se produce el martes de cada dos meses para la misma hora de inicio y hora final.

Extractor de salida requerido

1. Id Evento: Identificador único del evento que se utilizará para realizar las demás tareas.
2. Título del evento: Título del acontecimiento
3. Organizador: Nombre del organizador del acontecimiento
4. Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida

Actualización de los metadatos de un evento

Propósito

1. Los usuarios pueden pasar un Título de Evento, Descripción, FechaHora de Inicio, FechaHora de Fin, y otros parámetros como entrada & Tulip actualizará un evento existente con las entradas proporcionadas. La respuesta de la API serán los metadatos y varias propiedades del archivo.
2. La información que se extrae de la API de Google Calendar V3 puede utilizarse posteriormente en las aplicaciones de Tulip, en las tablas de Tulip o en las variables de Tulip, que se canalizarán a través de otras funciones del conector.

Punto final

Llamada HTTP PATCH al punto final https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

Entrada obligatoria

Los siguientes son los parámetros que se envían como cuerpo de la solicitud

1. ID de calendario: ID de calendario seleccionado
2. ID de evento: ID de evento seleccionado
3. Título del evento - Título del evento
4. Start Date Time- Hora de inicio del evento
5. End Date Time- Hora de finalización del evento
6. Zona horaria- Zona horaria del evento
7. Ubicación- Ubicación del evento
8. Descripción - Descripción del Evento

Extractor de Salida Requerido

1. Id. de Evento: Identificador único del Evento que se utilizará para realizar las demás tareas
2. Título del incidente: Título del incidente
3. Descripción del Evento: Título del incidente
4. Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida

Actualización de un evento recurrente

Propósito

1. Los usuarios pueden pasar un Título de Evento, Descripción, FechaHora de Inicio, FechaHora de Fin, Regla de Recurrencia, y otros parámetros como entrada & Tulip actualizará un evento existente con las entradas proporcionadas. La respuesta de la API serán los metadatos y diversas propiedades del archivo.
2. La información que se extrae de la API de Google Calendar V3 puede utilizarse posteriormente en las aplicaciones de Tulip, en las tablas de Tulip o en las variables de Tulip, que se canalizarán a través de otras funciones del conector.

Punto final

Llamada HTTP PATCH al punto final https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

Entrada obligatoria

Los siguientes son los parámetros que se envían como cuerpo de la solicitud

1. ID de calendario: ID de calendario seleccionado
2. ID de evento: ID de evento seleccionado
3. Título del evento - Título del evento
4. Start Date Time- Hora de inicio del evento
5. End Date Time- Hora de finalización del evento
6. Zona horaria- Zona horaria del evento
7. Ubicación- Ubicación del evento
8. Descripción- Descripción del evento
9. Regla de Recurrencia- La Regla de Recurrencia contiene todos los detalles de cómo y cuándo debe repetirse el evento. Consulte la lista de algunas reglas de recurrencia añadidas en la aplicación mencionada anteriormente para reglas de recurrencia detalladas)

Extractor de salida requerido

1. Id Evento: Identificador único del evento que se utilizará para llevar a cabo otras tareas.
2. Título del Evento: Título del suceso
3. Descripción del Evento: Título del incidente
4. Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida

Eliminar un incidente

Propósito

1. Los usuarios pueden introducir el ID del calendario y el ID del evento y Tulip eliminará el evento del calendario de Google.

Punto final

Llamada HTTP DELETE al punto final -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}

Entrada Requerida

Los siguientes son los parámetros que se envían como el cuerpo de la solicitud

1. ID del calendario: ID del calendario seleccionado
2. ID de evento: ID de evento seleccionado