--- title: "Google Calendar Connector" slug: "google-calendar-connector" updated: 2023-11-03T16:27:06Z published: 2023-11-03T16:27:06Z canonical: "support.tulip.co/google-calendar-connector" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 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](https://support.tulip.co/docs/what-are-connectors) 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](https://developers.google.com/calendar/v3/reference/calendarList) ## 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](http://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](https://www.googleapis.com/auth/calendar) 8. [https://www.googleapis.com/auth/calendar.events](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