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 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

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
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
8. 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