Conector do Google Agenda

Conector do Google Agenda

Integração do Tulip com o Google Calendar

Introdução

O Google Calendar API permite que os usuários criem, leiam e editem eventos do Google Calendar com o acesso correto definido para suas contas do Google. O objetivo desse conector é usar a autenticação OAuth e integrar-se ao Google Calendar V3 Api com o Tulip usando conectores HTTP e fornecer aos nossos clientes um conector pronto para uso que possa ser importado para sua instância.

Objetivo

Este documento destaca diferentes funções do conector HTTP que podem ser criadas por meio de chamadas HTTP para os pontos de extremidade da API do Google Calendar V3 para interagir com o Google Calendar e experimentar várias ações de leitura e gravação no calendário que podem ser aproveitadas para vários casos de uso.

Documento da API

1. Calendário do Google

Pré-requisitos

1. Crie uma conta no console de nuvem do Google e configure as credenciais do OAuth 2.0. Mais informações podem ser encontradas nos documentos da API do Google.
2. Ativar a API do Google Calendar no Console de API do Google.

Detalhes da conexão Tulip

As informações a seguir precisariam ser configuradas nos conectores da Tulip.

1. Executando em: host do conector de nuvem
2. Host:www.googleapis.com
3. Porta:443
4. TLS: Sim
5. Autenticação do conector: OAuth2.0 (administrador/operador)
6. A seguir estão os escopos que precisam ser passados:
7. https://www.googleapis.com/auth/calendar
8. https://www.googleapis.com/auth/calendar.events

Funções do conector

Obter todos os calendários

Objetivo

Esse conector buscará todos os calendários existentes no calendário do Google de um usuário.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade https://www.googleapis.com:443/calendar/v3/users/me/calendarList

Entrada necessária

Não são necessárias entradas

Extractor de saída obrigatório

1. Id do calendário: Identificador exclusivo do calendário que será usado para executar as outras tarefas.
2. Title (Título): O título do calendário
3. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Obter todos os eventos

Objetivo

Esse conector buscará todos os eventos de um calendário específico.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. Calendar Id- Calendar Id/ passe "primary" como um valor no parâmetro de ID do calendário. Especificar "Primary" obtém todos os eventos do calendário principal de um usuário.

Extrator de saída necessário

1. Calendar Id: Identificador exclusivo do calendário que será usado para executar as outras tarefas.
2. Event ID (ID do evento): Identificador exclusivo do evento que será usado para extrair detalhes sobre um evento específico.
3. Title (Título): O título do evento.
4. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Obter eventos por filtro

Finalidade

Esse conector obtém todos os eventos que se enquadram no intervalo de datas especificado, fornecido pelos parâmetros de consulta.

Ponto de extremidade

Chamada HTTP GET para o ponto de extremidade -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true

Entrada obrigatória

A seguir estão os parâmetros de URL que devem ser passados

1. ID do calendário: ID do calendário
2. MaxResults: Número de registros a serem obtidos
3. MinTime: Data e hora de início dos eventos a serem obtidos
4. MaxTime: Data e hora de término dos eventos a serem obtidos

Extrator de saída necessário

1. Id do calendário: Identificador exclusivo do calendário que será usado para executar as outras tarefas
2. Event ID (ID do evento): Identificador exclusivo do evento que será usado para executar as outras tarefas
3. Title (Título): O título do evento
4. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Criar um novo evento para usuários individuais/grupo/múltiplos usuários

Objetivo

1. Os usuários podem passar um título de evento, descrição, data de início e data de término como entrada e a Tulip criará um novo evento com o título fornecido. A resposta da API será os metadados e várias propriedades do arquivo.
2. As informações extraídas da API do Google Calendar V3 podem ser utilizadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip, que serão canalizadas para outras funções do conector.

Ponto final

Chamada HTTP POST para o endpoint https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Entrada obrigatória

Os parâmetros a seguir são enviados como o corpo da solicitação

1. ID do calendário - ID do calendário selecionado
2. Event Title (Título do evento) - O título do evento
3. Start Date Time - Hora da data de início do evento
4. End Date Time - Hora da data de término do evento
5. Fuso horário - Fuso horário do evento
6. Participantes - Participantes do evento
7. Local - Local do evento
8. Descrição - Descrição do evento

Extrator de saída necessário

1. Id do evento: Identificador exclusivo do evento que será usado para executar as outras tarefas
2. Event Title (Título do evento): O título do evento
3. Organizador: Nome do organizador do evento
4. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Criar um novo evento recorrente para usuários individuais/grupo/múltiplos usuários

Objetivo

1. Os usuários podem passar o título do evento, a descrição, a data de início, a data de término, a data de término da recorrência, o tipo de recorrência e outros parâmetros como entrada e a Tulip criará um novo evento com o título fornecido. A resposta da API será os metadados e várias propriedades do arquivo.
2. As informações extraídas da API do Google Calendar V3 podem ser usadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip que seriam canalizadas para outras funções do conector.

Ponto final

Chamada HTTP POST para o endpoint https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Entrada obrigatória

Os parâmetros a seguir são enviados como o corpo da solicitação

1. ID do calendário - ID do calendário selecionado
2. Event Title (Título do evento) - O título do evento
3. Start Date Time - Hora da data de início do evento
4. End Date Time - Hora da data de término do evento
5. Fuso horário - Fuso horário do evento
6. Participantes - Participantes do evento
7. Descrição - Descrição do evento
8. Local - Local do evento
9. Regra de recorrência - A regra de recorrência contém todos os detalhes de como e quando o evento deve se repetir. Abaixo está a lista de algumas regras de recorrência adicionadas no aplicativo (consulte [RFC5545] (https://tools.ietf.org/html/rfc5545

seção-3.8.5) para obter regras de recorrência detalhadas):

Diariamente para ocorrências:

RRULE:FREQ=DAILY;COUNT=

Ex: RRULE:FREQ=DAILY;COUNT=5

O evento ocorre por 5 dias a partir da data de início do evento para a mesma hora de início e hora de término.

Diariamente até :

RRULE:FREQ=DAILY;UNTIL=

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

O evento ocorre diariamente até "24 de setembro de 2021" a partir da data de início do evento para a mesma hora de início e hora de término.

Semanalmente para ocorrências:

RRULE:FREQ=WEEKLY;COUNT=

Ex: RRULE:FREQ=WEEKLY;COUNT=3

O evento ocorre semanalmente por 3 semanas, no mesmo dia da semana da data de início do evento e com a mesma hora de início e de término.

Semanalmente até :

RRULE:FREQ=WEEKLY;UNTIL=

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

O evento ocorre semanalmente até "24 de setembro de 2021" para o mesmo dia da semana da data de início do evento e para a mesma hora de início e hora de término

Toda terça-feira, a cada dois meses:(this)

RRULE:FREQ=MONTHLY;INTERVAL=;BYDAY=

Ex: RRULE:FREQ=MONTHLY;INTERVAL=2;BYDAY=TU

O evento ocorre na terça-feira de cada dois meses, com a mesma hora de início e hora de término.

Extrator de saída necessário

1. Id do evento: Identificador exclusivo do evento que será usado para executar as outras tarefas.
2. Event Title (Título do evento): O título do evento
3. Organizador: Nome do organizador do evento
4. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Atualizar metadados de um evento

Objetivo

1. Os usuários podem passar um título de evento, descrição, data e hora de início, data e hora de término e outros parâmetros como entrada e a Tulip atualizará um evento existente com as entradas fornecidas. A resposta da API será os metadados e várias propriedades do arquivo.
2. As informações extraídas da API do Google Calendar V3 podem ser utilizadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip, que serão canalizadas para outras funções do conector.

Ponto final

Chamada HTTP PATCH para o endpoint https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

Entrada obrigatória

A seguir estão os parâmetros que são enviados como corpo da solicitação

1. ID do calendário - ID do calendário selecionado
2. ID do evento - ID do evento selecionado
3. Event Title (Título do evento) - O título do evento
4. Start Date Time - Hora da data de início do evento
5. End Date Time - Hora da data de término do evento
6. Fuso horário - Fuso horário do evento
7. Localização - Localização do evento
8. Descrição - Descrição do evento

Extrator de saída necessário

1. Id do evento: Identificador exclusivo do evento que será usado para executar as outras tarefas
2. Event Title (Título do evento): O título do evento
3. Descrição do evento: O título do evento
4. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Atualizar um evento recorrente

Objetivo

1. Os usuários podem passar o título do evento, a descrição, a data e hora de início, a data e hora de término, a regra de recorrência e outros parâmetros como entrada e a Tulip atualizará um evento existente com as entradas fornecidas. A resposta da API será os metadados e várias propriedades do arquivo.
2. As informações extraídas do Google Calendar V3 API podem ser utilizadas em aplicativos Tulip, tabelas Tulip ou variáveis Tulip, que serão canalizadas para outras funções do conector.

Ponto final

Chamada HTTP PATCH para o endpoint https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

Entrada obrigatória

A seguir estão os parâmetros que são enviados como corpo da solicitação

1. ID do calendário - ID do calendário selecionado
2. ID do evento - ID do evento selecionado
3. Event Title (Título do evento) - O título do evento
4. Start Date Time - Hora da data de início do evento
5. End Date Time - Hora da data de término do evento
6. Fuso horário - Fuso horário do evento
7. Localização - Localização do evento
8. Descrição - Descrição do evento
9. Regra de recorrência - A regra de recorrência contém todos os detalhes de como e quando o evento deve se repetir. Consulte a lista de poucas regras de recorrência adicionadas no aplicativo mencionada no documento acima para obter regras de recorrência detalhadas.)

Extrator de saída necessário

1. Id do evento: Identificador exclusivo do evento que será usado para executar as outras tarefas.
2. Event Title (Título do evento): O título do evento
3. Descrição do evento: O título do evento
4. Parâmetros adicionais que são retornados com a resposta podem ser incluídos como parte dos parâmetros de saída

Excluir um evento

Objetivo

1. Os usuários podem passar o ID do calendário e o ID do evento como entrada e o Tulip excluirá o evento no calendário do Google.

Ponto final

Chamada HTTP DELETE para o ponto de extremidade -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}

Entrada obrigatória

Os parâmetros a seguir são enviados como corpo da solicitação

1. ID do calendário - ID do calendário selecionado
2. Event ID - ID do evento selecionado