Connettore calendario di Google

Connettore calendario Google

Integrazione di Tulip con Google Calendar

Introduzione

L'API di Google Calendar consente agli utenti di creare, leggere e modificare gli eventi del calendario di Google con il giusto accesso ai loro account di Google. L'obiettivo di questo connettore è utilizzare l'autenticazione OAuth e integrare l'API Google Calendar V3 con Tulip utilizzando i connettori HTTP e fornire ai nostri clienti un connettore pronto all'uso che può essere importato nella loro istanza.

Scopo

Questo documento evidenzia diverse funzioni di connettore HTTP che possono essere costruite effettuando chiamate HTTP agli endpoint dell'API Google Calendar V3 per interagire con il calendario di Google e provare varie azioni di lettura e scrittura sul calendario che potrebbero essere sfruttate per vari casi d'uso.

Documento API

1. Calendario di Google

Prerequisiti

1. Creare un account nella Console cloud di Google e configurare le credenziali OAuth 2.0. Ulteriori informazioni sono disponibili nei documenti API di Google.
2. Attivare l'API Google Calendar nella Console API di Google.

Dettagli della connessione Tulip

Le seguenti informazioni devono essere configurate sui connettori di Tulip.

1. In esecuzione su: Host del connettore cloud
2. Host:www.googleapis.com
3. Porta: 443
4. TLS: Sì
5. Autenticazione del connettore: OAuth2.0 (Admin/Operatore)
6. Di seguito sono riportati gli ambiti che devono essere passati:
7. https://www.googleapis.com/auth/calendar
8. https://www.googleapis.com/auth/calendar.events

Funzioni del connettore

Ottieni tutti i calendari

Scopo

Questo connettore recupera tutti i calendari esistenti nel calendario di Google di un utente.

Punto finale

Chiamata HTTP GET all'endpoint https://www.googleapis.com:443/calendar/v3/users/me/calendarList

Input richiesti

Nessun input richiesto

Estrattore di output richiesto

1. Id calendario: Identificatore univoco del calendario che verrà utilizzato per eseguire gli altri compiti.
2. Titolo: Il titolo del calendario
3. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output

Ottieni tutti gli eventi

Scopo

Questo connettore recupera tutti gli eventi di un calendario specifico.

Punto finale

Chiamata HTTP GET all'endpoint -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/eventi

Input richiesti

I parametri URL da passare sono i seguenti

1. Calendar Id- Id del calendario/ Passare "primary" come valore nel parametro ID del calendario. Specificando "Primary" si ottengono tutti gli eventi del calendario principale di un utente.

Estrattore di output richiesto

1. Id calendario: Identificatore univoco del calendario che verrà utilizzato per eseguire gli altri compiti.
2. ID evento: Identificatore univoco dell'evento che verrà utilizzato per estrarre i dettagli di un evento specifico.
3. Titolo: Il titolo dell'evento
4. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output.

Ottieni eventi per filtro

Scopo

Questo connettore recupera tutti gli eventi che rientrano nell'intervallo di date specificato dai parametri della query.

Punto finale

Chiamata HTTP GET all'endpoint -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true

Input richiesti

I parametri URL da passare sono i seguenti

1. ID calendario: ID calendario
2. MaxResults: Numero di record da recuperare
3. MinTime: data e ora di inizio degli eventi da recuperare
4. MaxTime: Data di fine Ora degli eventi da recuperare

Estrattore di output richiesto

1. Id calendario: Identificatore univoco del calendario che verrà utilizzato per eseguire gli altri compiti.
2. ID evento: Identificatore univoco dell'evento che verrà utilizzato per svolgere le altre attività.
3. Titolo: Il titolo dell'evento
4. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output.

Creare un nuovo evento per un utente singolo/gruppo/multiplo

Scopo

1. Gli utenti possono passare un titolo di evento, una descrizione, una data di inizio e una data di fine come input e Tulip creerà un nuovo evento con il titolo fornito. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del file.
2. Le informazioni estratte dall'API di Google Calendar V3 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip da inserire in altre funzioni del connettore.

Punto finale

Chiamata HTTP POST all'endpoint https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/eventi

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. ID calendario - ID del calendario selezionato
2. Titolo dell'evento - Il titolo dell'evento
3. Data di inizio - Ora della data di inizio dell'evento
4. Data di fine - Ora della data di fine dell'evento
5. Fuso orario- Fuso orario dell'evento
6. Partecipanti - Partecipanti all'evento
7. Luogo - Luogo dell'evento
8. Descrizione - Descrizione dell'evento

Estrattore di output richiesto

1. Id evento: Identificatore univoco dell'evento che verrà utilizzato per eseguire gli altri compiti.
2. Titolo dell'evento: Il titolo dell'evento
3. Organizzatore: Nome dell'organizzatore dell'evento
4. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output.

Creare un nuovo evento ricorrente per un utente singolo/gruppo/multiplo

Scopo

1. Gli utenti possono passare un titolo di evento, una descrizione, una data di inizio, una data di fine, una data di fine ricorrenza, un tipo di ricorrenza e altri parametri come input e Tulip creerà un nuovo evento con il titolo fornito. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del file.
2. Le informazioni estratte dall'API di Google Calendar V3 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip da inserire in altre funzioni del connettore.

Punto finale

Chiamata HTTP POST all'endpoint https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/eventi

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. ID calendario - ID del calendario selezionato
2. Titolo dell'evento - Il titolo dell'evento
3. Data di inizio - Ora della data di inizio dell'evento
4. Data di fine - Ora della data di fine dell'evento
5. Fuso orario- Fuso orario dell'evento
6. Partecipanti - Partecipanti all'evento
7. Descrizione - Descrizione dell'evento
8. Luogo - Luogo dell'evento
9. Regola di ricorrenza: la regola di ricorrenza contiene tutti i dettagli su come e quando l'evento deve ripetersi. Di seguito sono elencate alcune regole di ricorrenza aggiunte in-app (fare riferimento al documento [RFC5545](https://tools.ietf.org/html/rfc5545

sezione-3.8.5) per le regole di ricorrenza dettagliate):

Giornalmente per occorrenze:

RRULE:FREQ=DAILY;COUNT=

Es: RRULE:FREQ=DAILY;COUNT=5

L'evento si verifica per 5 giorni dalla data di inizio dell'evento per la stessa ora di inizio e di fine.

Tutti i giorni fino a :

RRULE:FREQ=GIORNALIERO;FINOA=

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

L'evento si verifica ogni giorno fino al "24 settembre 2021" dalla data di inizio dell'evento per la stessa ora di inizio e di fine.

Settimanale per le occorrenze di :

RRULE:FREQ=WEEKLY;COUNT=

Es: RRULE:FREQ=WEEKLY;COUNT=3

L'evento si verifica settimanalmente per 3 settimane per lo stesso giorno della settimana della data di inizio dell'evento e per la stessa ora di inizio e di fine.

Settimanale fino a :

RRULE:FREQ=WEEKLY;UNTIL=

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

L'evento si verifica settimanalmente fino al "24 settembre 2021" per lo stesso giorno della settimana della data di inizio dell'evento e per la stessa ora di inizio e di fine.

Ogni martedì, a mesi alterni:(this)

RRULE:FREQ=MONTHLY;INTERVAL=;BYDAY=

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

L'evento si verifica il martedì di ogni mese per la stessa ora di inizio e di fine.

Estrattore di output richiesto

1. Id evento: Identificatore univoco dell'evento che verrà utilizzato per eseguire gli altri compiti.
2. Titolo dell'evento: Il titolo dell'evento
3. Organizzatore: Nome dell'organizzatore dell'evento
4. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output.

Aggiornare i metadati di un evento

Scopo

1. Gli utenti possono passare un titolo dell'evento, una descrizione, una data di inizio, una data di fine e altri parametri come input e Tulip aggiornerà un evento esistente con gli input forniti. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del file.
2. Le informazioni estratte dall'API di Google Calendar V3 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip da inserire in altre funzioni del connettore.

Punto finale

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

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. ID calendario - ID calendario selezionato
2. ID evento - ID evento selezionato
3. Titolo evento - Il titolo dell'evento
4. Data di inizio - Ora della data di inizio dell'evento
5. Data di fine - Ora della data di fine dell'evento
6. Fuso orario - Fuso orario dell'evento
7. Posizione - Posizione dell'evento
8. Descrizione - Descrizione dell'evento

Estrattore di output richiesto

1. Id evento: Identificatore univoco dell'evento che verrà utilizzato per eseguire gli altri compiti.
2. Titolo dell'evento: Il titolo dell'evento
3. Descrizione dell'evento: Il titolo dell'evento
4. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output.

Aggiornare un evento ricorrente

Scopo

1. Gli utenti possono passare un titolo di evento, una descrizione, una data di inizio, una data di fine, una regola di ricorrenza e altri parametri come input e Tulip aggiornerà un evento esistente con gli input forniti. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà del file.
2. Le informazioni estratte dall'API di Google Calendar V3 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip da inserire in altre funzioni del connettore.

Punto finale

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

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. ID calendario - ID calendario selezionato
2. ID evento - ID evento selezionato
3. Titolo evento - Il titolo dell'evento
4. Data di inizio - Ora della data di inizio dell'evento
5. Data di fine - Ora della data di fine dell'evento
6. Fuso orario - Fuso orario dell'evento
7. Posizione - Posizione dell'evento
8. Descrizione - Descrizione dell'evento
9. Regola di ricorrenza: la regola di ricorrenza contiene tutti i dettagli su come e quando l'evento deve ripetersi. Per le regole di ricorrenza dettagliate, consultare l'elenco delle regole di ricorrenza aggiunte nell'applicazione di cui sopra).

Estrattore di output richiesto

1. Id evento: Identificatore univoco dell'evento che verrà utilizzato per eseguire gli altri compiti.
2. Titolo dell'evento: Il titolo dell'evento
3. Descrizione dell'evento: Il titolo dell'evento
4. I parametri aggiuntivi che vengono restituiti con la risposta possono essere inclusi come parte dei parametri di output.

Cancellare un evento

Scopo

1. Gli utenti possono passare l'ID del calendario e l'ID dell'evento come input e Tulip cancellerà l'evento nel calendario di Google.

Punto finale

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

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. ID calendario - ID calendario selezionato
2. ID evento: ID evento selezionato