--- title: "Google Calendar Connector" slug: "google-calendar-connector" updated: 2023-11-03T16:26:49Z published: 2023-11-03T16:26:49Z 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. # Google Calendar Connector ## Google Kalender-Verbindung *Integration von Tulip mit Google Calendar* ## Einführung Google Calendar API ermöglicht es den Benutzern, Google Calendar Events zu erstellen, zu lesen und zu bearbeiten, wenn sie den richtigen Zugang zu ihren Google-Konten haben. Das Ziel dieses Konnektors ist es, die OAuth-Authentifizierung zu verwenden und die Google Calendar V3 Api mit Tulip über [HTTP-Konnektoren](https://support.tulip.co/docs/what-are-connectors) zu integrieren und unseren Kunden einen fertigen Konnektor zu bieten, der in ihre Instanz importiert werden kann. ## Zweck Dieses Dokument hebt verschiedene HTTP-Connector-Funktionen hervor, die durch HTTP-Aufrufe zu Google Calendar V3 API-Endpunkten erstellt werden können, um mit dem Google Calendar zu interagieren und verschiedene Lese- und Schreibaktionen auf dem Kalender auszuprobieren, die für verschiedene Anwendungsfälle genutzt werden können. ## API-Dokument 1. [Google Kalender](https://developers.google.com/calendar/v3/reference/calendarList) ## Vorraussetzungen 1. Erstellen Sie ein Konto in der Google Cloud Console und konfigurieren Sie die OAuth 2.0-Anmeldeinformationen. Weitere Informationen finden Sie in den API-Dokumenten von Google. 2. Aktivieren Sie die Google Calendar API in der Google API-Konsole. ## Tulip Verbindungsdetails Die folgenden Informationen müssen für die Tulip-Konnektoren konfiguriert werden. 1. Läuft auf: Cloud Connector Host 2. Rechner[:www.googleapis.com](http://www.googleapis.com) 3. Anschluss:443 4. TLS: Ja 5. Konnektor-Authentifizierung: OAuth2.0(Admin/Bediener) 6. Im Folgenden sind die zu übergebenden Bereiche aufgeführt: 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) ## Konnektor-Funktionen #### Alle Kalender abrufen **Zweck** Dieser Connector ruft alle Kalender ab, die im Google-Kalender eines Benutzers vorhanden sind. **Endpunkt** `HTTP GET-Aufruf an den Endpunkt https://www.googleapis.com:443/calendar/v3/users/me/calendarList` **Erforderliche Eingabe** Keine Eingaben erforderlich **Erforderlicher Output Extraktor** 1. Kalender-Id: Eindeutiger Bezeichner des Kalenders, der für die Ausführung der anderen Aufgaben verwendet wird 2. Titel: Der Titel des Kalenders 3. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden #### Alle Ereignisse abrufen **Zweck** Dieser Konnektor ruft alle Ereignisse eines bestimmten Kalenders ab. **Endpunkt** `HTTP GET-Aufruf an den Endpunkt -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events` **Erforderliche Eingabe** Die folgenden URL-Parameter sind zu übergeben 1. Kalender-ID - Kalender-ID/ Übergeben Sie "primary" als Wert im Kalender-ID-Parameter. Die Angabe von "Primary" ruft alle Ereignisse des primären Kalenders eines Benutzers ab. **Erforderlicher Output-Extraktor** 1. Kalender-ID: Eindeutiger Bezeichner des Kalenders, der für die Ausführung der anderen Aufgaben verwendet wird 2. Ereignis-ID: Eindeutiger Bezeichner des Ereignisses, der verwendet wird, um Details über ein bestimmtes Ereignis zu erhalten. 3. Titel: Der Titel des Ereignisses 4. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden #### Ereignisse nach Filter abrufen **Zweck** Dieser Connector ruft alle Ereignisse ab, die in den durch die Abfrageparameter angegebenen Datumsbereich fallen. **Endpunkt** `HTTP GET-Aufruf an den Endpunkt -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true` **Erforderliche Eingabe** Die folgenden URL-Parameter sind zu übergeben 1. Kalender-ID: Kalender-ID 2. MaxResults: Anzahl der abzurufenden Datensätze 3. MinTime: Startdatum Uhrzeit der abzurufenden Ereignisse 4. MaxTime: Enddatum Uhrzeit der abzurufenden Ereignisse **Erforderlicher Output-Extraktor** 1. Kalender Id: Eindeutiger Bezeichner des Kalenders, der für die Ausführung der anderen Aufgaben verwendet wird 2. Ereignis-ID: Eindeutiger Bezeichner des Ereignisses, das für die Ausführung der anderen Aufgaben verwendet wird 3. Titel: Der Titel des Ereignisses 4. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden #### Ein neues Ereignis für einen/eine Gruppe/mehrere Benutzer erstellen **Zweck** 1. Benutzer können einen Ereignistitel, eine Beschreibung, ein Startdatum und ein Enddatum als Eingabe übergeben. Tulip erstellt dann ein neues Ereignis mit dem angegebenen Ereignistitel. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften der Datei. 2. Die Informationen, die von der Google Calendar V3 API abgezogen werden, können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen eingefügt werden. **Endpunkt** `HTTP POST-Aufruf an den Endpunkt https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events` **Erforderliche Eingabe** Die folgenden Parameter werden als Request Body gesendet 1. Kalender-ID - Ausgewählte Kalender-ID 2. Event Title - Der Titel des Ereignisses 3. Start Date Time - Uhrzeit für das Startdatum des Ereignisses 4. Enddatum - Uhrzeit - Enddatum des Ereignisses Uhrzeit 5. Zeitzone- Zeitzone des Ereignisses 6. Teilnehmer - Teilnehmer der Veranstaltung 7. Ort - Ort der Veranstaltung 8. Beschreibung - Beschreibung des Ereignisses **Erforderlicher Output-Extraktor** 1. Ereignis-Kennung: Eindeutiger Bezeichner des Ereignisses, der für die Ausführung der anderen Aufgaben verwendet wird 2. Ereignis-Titel: Der Titel der Veranstaltung 3. Organisator: Name des Veranstalters der Veranstaltung 4. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden #### Eine neue wiederkehrende Veranstaltung für einen/eine Gruppe/mehrere Benutzer erstellen **Zweck** 1. Benutzer können einen Veranstaltungstitel, eine Beschreibung, ein Startdatum, ein Enddatum, ein Enddatum für die Wiederholung, einen Wiederholungstyp und andere Parameter als Eingabe übergeben & Tulip wird eine neue Veranstaltung mit dem angegebenen Veranstaltungstitel erstellen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften der Datei. 2. Die Informationen, die von der Google Calendar V3 API abgerufen werden, können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen eingefügt werden. **Endpunkt** `HTTP POST-Aufruf an den Endpunkt https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events` **Erforderliche Eingabe** Die folgenden Parameter werden als Request Body gesendet 1. Kalender-ID - Ausgewählte Kalender-ID 2. Event Title - Der Titel des Ereignisses 3. Start Date Time - Uhrzeit für das Startdatum des Ereignisses 4. Enddatum - Uhrzeit - Enddatum des Ereignisses Uhrzeit 5. Zeitzone- Zeitzone des Ereignisses 6. Teilnehmer - Teilnehmer der Veranstaltung 7. Beschreibung - Beschreibung der Veranstaltung 8. Ort - Ort des Ereignisses 9. Wiederholungsregel - Die Wiederholungsregel enthält alle Details darüber, wie und wann das Ereignis wiederkehren soll. Nachfolgend finden Sie eine Liste einiger Wiederholungsregeln, die in der Anwendung hinzugefügt wurden (siehe [RFC5545](https://tools.ietf.org/html/rfc5545 ## Abschnitt-3.8.5) Dokument für detaillierte Wiederholungsregeln) : **Täglich für Vorkommnisse:** RRULE:FREQ=DAILY;COUNT= Beispiel: `RRULE:FREQ=DAILY;COUNT=5` Das Ereignis tritt 5 Tage lang ab dem Startdatum des Ereignisses zur gleichen Start- und Endzeit auf. **Täglich bis :** RRULE:FREQ=DAILY;UNTIL= Ex: `RRULE:FREQ=DAILY;UNTIL=20210924T000000Z` Das Ereignis tritt täglich bis zum "24. September 2021" ab dem Startdatum des Ereignisses für dieselbe Start- und Endzeit auf. **Wöchentlich für Ereignisse:** RRULE:FREQ=WEEKLY;COUNT= Beispiel: `RRULE:FREQ=WEEKLY;COUNT=3` Das Ereignis tritt 3 Wochen lang wöchentlich für denselben Wochentag des Startdatums des Ereignisses und für dieselbe Start- und Endzeit auf. **Wöchentlich bis :** RRULE:FREQ=WEEKLY;UNTIL= Ex: `RRULE:FREQ=WEEKLY;UNTIL=20210924T000000Z` Das Ereignis tritt wöchentlich bis zum "24. September 2021" für denselben Wochentag des Startdatums des Ereignisses und für dieselbe Start- und Endzeit ein **Jeden Dienstag, jeden zweiten Monat:(this)** RRULE:FREQ=MONATLICH;INTERVAL=;BYDAY= Beispiel: `RRULE:FREQ=MONATLICH;INTERVALL=2;BYDAY=TU` Das Ereignis findet jeden zweiten Dienstag im Monat zur gleichen Start- und Endzeit statt. **Erforderlicher Output-Extraktor** 1. Ereignis-ID: Eindeutiger Bezeichner des Ereignisses, der für die Ausführung der anderen Aufgaben verwendet wird 2. Titel des Ereignisses: Der Titel der Veranstaltung 3. Organisator: Name des Veranstalters der Veranstaltung 4. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden #### Ereignis-Metadaten aktualisieren **Zweck** 1. Benutzer können einen Veranstaltungstitel, eine Beschreibung, ein Startdatum, ein Enddatum und andere Parameter als Eingabe übergeben & Tulip wird eine bestehende Veranstaltung mit den angegebenen Eingaben aktualisieren. Die Antwort der API sind die Metadaten und verschiedene Eigenschaften der Datei. 2. Die Informationen aus der Google Calendar V3 API können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen eingefügt werden. **Endpunkt** HTTP PATCH-Aufruf an den Endpunkt `https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*` **Erforderliche Eingabe** Die folgenden Parameter werden als Request Body gesendet 1. Kalender-ID - Ausgewählte Kalender-ID 2. Veranstaltungs-ID - Ausgewählte Veranstaltungs-ID 3. Event Title - Der Titel des Ereignisses 4. Start Date Time - Uhrzeit des Startdatums des Ereignisses 5. End Date Time- Enddatum des Ereignisses Zeit 6. Zeitzone- Zeitzone des Ereignisses 7. Ort - Ort des Ereignisses 8. Beschreibung - Beschreibung des Ereignisses **Erforderlicher Output-Extraktor** 1. Ereignis-ID: Eindeutiger Bezeichner des Ereignisses, der für die Ausführung der anderen Aufgaben verwendet wird 2. Ereignis-Titel: Der Titel des Ereignisses 3. Beschreibung des Ereignisses: Der Titel des Ereignisses 4. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden #### Aktualisieren eines wiederkehrenden Ereignisses **Zweck** 1. Benutzer können einen Ereignistitel, eine Beschreibung, ein Startdatum, ein Enddatum, eine Wiederholungsregel und andere Parameter als Eingabe übergeben & Tulip wird ein bestehendes Ereignis mit den gegebenen Eingaben aktualisieren. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften der Datei. 2. Die Informationen, die aus der Google Calendar V3 API gezogen werden, können dann entweder innerhalb von Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen geleitet werden. **Endpunkt** HTTP PATCH-Aufruf an den Endpunkt `https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*` **Erforderliche Eingabe** Die folgenden Parameter werden als Request Body gesendet 1. Kalender-ID - Ausgewählte Kalender-ID 2. Veranstaltungs-ID - Ausgewählte Veranstaltungs-ID 3. Event Title - Der Titel des Ereignisses 4. Start Date Time - Uhrzeit des Startdatums des Ereignisses 5. End Date Time- Enddatum des Ereignisses Zeit 6. Zeitzone- Zeitzone des Ereignisses 7. Ort - Ort des Ereignisses 8. Beschreibung- Beschreibung des Ereignisses 9. Wiederholungsregel- Die Wiederholungsregel enthält alle Details, wie und wann das Ereignis wiederkehren soll. Detaillierte Wiederholungsregeln finden Sie in der Liste der wenigen Wiederholungsregeln, die in der oben genannten App hinzugefügt wurden.) **Erforderlicher Output-Extraktor** 1. Ereignis-Kennung: Eindeutiger Bezeichner des Ereignisses, der für die Ausführung der anderen Aufgaben verwendet wird 2. Ereignis-Titel: Der Titel des Ereignisses 3. Beschreibung des Ereignisses: Der Titel des Ereignisses 4. Zusätzliche Parameter, die mit der Antwort zurückgegeben werden, können als Teil der Ausgabeparameter aufgenommen werden #### Löschen eines Ereignisses **Zweck** 1. Benutzer können Kalender-ID und Ereignis-ID als Eingabe übergeben und Tulip wird das Ereignis im Google-Kalender löschen. **Endpunkt** HTTP DELETE Aufruf an den Endpunkt `-https://www.googleapis.com:443/calendar/v3/calendars/{KalenderID}/events/{EventID}` **Erforderliche Eingaben** Die folgenden Parameter werden als Request Body gesendet 1. Kalender-ID - Ausgewählte Kalender-ID 2. Ereignis-ID - Ausgewählte Ereignis-ID