Konektor kalendarza Google

Konektor kalendarza Google

Integracja Tulip z Kalendarzem Google

Wprowadzenie

Interfejs API Kalendarza Google umożliwia użytkownikom tworzenie, odczytywanie i edytowanie wydarzeń kalendarza Google z odpowiednim dostępem do ich kont Google. Celem tego konektora jest wykorzystanie uwierzytelniania OAuth i integracja z Google Calendar V3 Api z Tulip za pomocą konektorów HTTP i zapewnienie naszym klientom gotowego konektora, który można zaimportować do ich instancji.

Cel

Ten dokument podkreśla różne funkcje konektorów HTTP, które można zbudować, wykonując wywołania HTTP do punktów końcowych interfejsu API Kalendarza Google V3 w celu interakcji z Kalendarzem Google w celu wypróbowania różnych działań odczytu i zapisu w kalendarzu, które można wykorzystać w różnych przypadkach użycia.

Dokument API

1. Kalendarz Google

Wymagania wstępne

1. Utwórz konto w Google Cloud Console i skonfiguruj poświadczenia OAuth 2.0. Więcej informacji można znaleźć w dokumentach API Google.
2. Aktywuj Google Calendar API w Google API Console.

Szczegóły połączenia Tulip

W konektorach Tulip należy skonfigurować następujące informacje.

1. Uruchomione na: Cloud Connector Host
2. Host:www.googleapis.com
3. Port:443
4. TLS: Tak
5. Uwierzytelnianie konektora: OAuth2.0(Administrator/Operator)
6. Poniżej znajdują się zakresy, które należy przekazać:
7. https://www.googleapis.com/auth/calendar
8. https://www.googleapis.com/auth/calendar.events

Funkcje konektora

Pobierz wszystkie kalendarze

Cel

Ten konektor pobiera wszystkie kalendarze istniejące w kalendarzu Google użytkownika.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego https://www.googleapis.com:443/calendar/v3/users/me/calendarList

Wymagane dane wejściowe

Dane wejściowe nie są wymagane

Wymagane dane wyjściowe Extractor

1. Calendar Id: Unikalny identyfikator kalendarza, który będzie używany do wykonywania innych zadań.
2. Title: Tytuł kalendarza
3. Dodatkowe parametry zwracane wraz z odpowiedzią mogą być dołączone jako część parametrów wyjściowych

Pobierz wszystkie zdarzenia

Cel

Ten łącznik pobierze wszystkie wydarzenia z określonego kalendarza.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

1. Identyfikator kalendarza - Identyfikator kalendarza / przekaż "primary" jako wartość w parametrze identyfikatora kalendarza. Podanie wartości "Primary" spowoduje pobranie wszystkich wydarzeń z głównego kalendarza użytkownika.

Wymagany ekstraktor danych wyjściowych

1. Calendar Id: Unikalny identyfikator kalendarza, który będzie używany do wykonywania innych zadań.
2. Event ID: Unikalny identyfikator wydarzenia, który będzie używany do pobierania szczegółów dotyczących konkretnego wydarzenia.
3. Tytuł: Tytuł wydarzenia
4. Dodatkowe parametry zwracane wraz z odpowiedzią mogą być dołączone jako część parametrów wyjściowych

Pobierz zdarzenia według filtra

Cel

Ten łącznik pobiera wszystkie zdarzenia, które mieszczą się w określonym zakresie dat podanym w parametrach zapytania.

Punkt końcowy

Wywołanie HTTP GET do punktu końcowego -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true

Wymagane dane wejściowe

Poniżej przedstawiono parametry adresu URL, które należy przekazać

1. Identyfikator kalendarza: ID kalendarza
2. MaxResults: Liczba rekordów do pobrania
3. MinTime: data początkowa i godzina zdarzeń do pobrania
4. MaxTime: Godzina daty końcowej zdarzeń do pobrania

Wymagany ekstraktor danych wyjściowych

1. Calendar Id: Unikalny identyfikator kalendarza, który będzie używany do wykonywania innych zadań.
2. Event ID: Unikalny identyfikator zdarzenia, który zostanie użyty do wykonania innych zadań.
3. Title: Tytuł wydarzenia
4. Dodatkowe parametry zwracane wraz z odpowiedzią mogą być częścią parametrów wyjściowych.

Utwórz nowe zdarzenie dla pojedynczego/grupy/wielu użytkowników

Cel

1. Użytkownicy mogą przekazać tytuł wydarzenia, opis, czas rozpoczęcia i czas zakończenia jako dane wejściowe, a Tulip utworzy nowe wydarzenie z podanym tytułem wydarzenia. Odpowiedzią API będą metadane i różne właściwości pliku.
2. Informacje pobierane z Google Calendar V3 API mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przekazywane do innych funkcji konektora.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Calendar ID - wybrany identyfikator kalendarza
2. Tytuł wydarzenia - tytuł wydarzenia
3. Data rozpoczęcia - godzina rozpoczęcia wydarzenia
4. End Date Time- Data zakończenia wydarzenia
5. Strefa czasowa - strefa czasowa wydarzenia
6. Uczestnicy- Uczestnicy wydarzenia
7. Lokalizacja - Lokalizacja wydarzenia
8. Opis - Opis zdarzenia

Wymagany ekstraktor danych wyjściowych

1. Event Id: Unikalny identyfikator zdarzenia, który zostanie wykorzystany do wykonania innych zadań.
2. Tytuł zdarzenia: Tytuł wydarzenia
3. Organizator: Nazwa organizatora wydarzenia
4. Dodatkowe parametry zwracane wraz z odpowiedzią mogą zostać dołączone jako część parametrów wyjściowych.

Utwórz nowe wydarzenie cykliczne dla jednego/grupy/wielu użytkowników

Cel

1. Użytkownicy mogą przekazać tytuł wydarzenia, opis, czas rozpoczęcia, czas zakończenia, czas zakończenia powtarzania, typ powtarzania i inne parametry jako dane wejściowe, a Tulip utworzy nowe wydarzenie z podanym tytułem wydarzenia. Odpowiedzią API będą metadane i różne właściwości pliku.
2. Informacje pobierane z Google Calendar V3 API mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przekazywane do innych funkcji konektora.

Punkt końcowy

Wywołanie HTTP POST do punktu końcowego https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Calendar ID - wybrany identyfikator kalendarza
2. Tytuł wydarzenia - tytuł wydarzenia
3. Data rozpoczęcia - godzina rozpoczęcia wydarzenia
4. End Date Time- Data zakończenia wydarzenia
5. Strefa czasowa - strefa czasowa wydarzenia
6. Uczestnicy- Uczestnicy wydarzenia
7. Opis - opis wydarzenia
8. Lokalizacja - Lokalizacja wydarzenia
9. Recurrence Rule- Reguła powtarzania zawiera wszystkie szczegóły dotyczące tego, jak i kiedy zdarzenie powinno się powtarzać. Poniżej znajduje się lista kilku reguł powtarzalności dodanych w aplikacji (patrz dokument [RFC5545] (https://tools.ietf.org/html/rfc5545

sekcja-3.8.5) w celu zapoznania się ze szczegółowymi regułami powtarzania):

Codziennie dla wystąpień:

RRULE:FREQ=DAILY;COUNT=

Na przykład: RRULE:FREQ=DAILY;COUNT=5

Zdarzenie występuje przez 5 dni od daty rozpoczęcia zdarzenia dla tego samego czasu rozpoczęcia i zakończenia.

Codziennie do :

RRULE:FREQ=DAILY;UNTIL=

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

Zdarzenie występuje codziennie do "24 września 2021 r." od daty rozpoczęcia zdarzenia dla tego samego czasu rozpoczęcia i zakończenia.

Cotygodniowe dla zdarzeń :

RRULE:FREQ=WEEKLY;COUNT=

Na przykład: RRULE:FREQ=WEEKLY;COUNT=3

Zdarzenie występuje co tydzień przez 3 tygodnie w tym samym dniu tygodnia co data rozpoczęcia zdarzenia oraz o tej samej godzinie rozpoczęcia i zakończenia.

Co tydzień do :

RRULE:FREQ=WEEKLY;UNTIL=

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

Zdarzenie występuje co tydzień do "24 września 2021 r." w tym samym dniu tygodnia, w którym rozpoczęło się zdarzenie, oraz o tej samej godzinie rozpoczęcia i zakończenia.

W każdy wtorek, co drugi miesiąc:(this)

RRULE:FREQ=MONTHLY;INTERVAL=;BYDAY=

Na przykład: RRULE:FREQ=MONTHLY;INTERVAL=2;BYDAY=TU

Zdarzenie ma miejsce we wtorek co drugi miesiąc o tej samej godzinie rozpoczęcia i zakończenia.

Wymagany ekstraktor danych wyjściowych

1. Event Id: Unikalny identyfikator zdarzenia, który zostanie użyty do wykonania innych zadań.
2. Tytuł zdarzenia: Tytuł wydarzenia
3. Organizator: Nazwa organizatora wydarzenia
4. Dodatkowe parametry zwracane wraz z odpowiedzią mogą być dołączone jako część parametrów wyjściowych.

Aktualizacja metadanych wydarzenia

Cel

1. Użytkownicy mogą przekazać tytuł wydarzenia, opis, czas rozpoczęcia, czas zakończenia i inne parametry jako dane wejściowe, a Tulip zaktualizuje istniejące wydarzenie za pomocą dostarczonych danych wejściowych. Odpowiedzią API będą metadane i różne właściwości pliku.
2. Informacje pobierane z Google Calendar V3 API mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przesyłane do innych funkcji konektora.

Punkt końcowy

Wywołanie HTTP PATCH do punktu końcowego https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Identyfikator kalendarza - wybrany identyfikator kalendarza
2. Identyfikator zdarzenia - wybrany identyfikator zdarzenia
3. Tytuł wydarzenia - tytuł wydarzenia
4. Data rozpoczęcia - godzina daty rozpoczęcia wydarzenia
5. Data zakończenia - data zakończenia wydarzenia
6. Strefa czasowa - strefa czasowa zdarzenia
7. Lokalizacja - Lokalizacja zdarzenia
8. Opis - opis zdarzenia

Wymagany ekstraktor danych wyjściowych

1. Identyfikator zdarzenia: Unikalny identyfikator zdarzenia, który zostanie wykorzystany do wykonania innych zadań.
2. Tytuł zdarzenia: Tytuł zdarzenia
3. Opis zdarzenia: Tytuł zdarzenia
4. Dodatkowe parametry zwracane wraz z odpowiedzią mogą być dołączone jako część parametrów wyjściowych.

Aktualizacja zdarzenia cyklicznego

Cel

1. Użytkownicy mogą przekazać tytuł zdarzenia, opis, czas rozpoczęcia, czas zakończenia, regułę powtarzalności i inne parametry jako dane wejściowe, a Tulip zaktualizuje istniejące zdarzenie za pomocą dostarczonych danych wejściowych. Odpowiedzią API będą metadane i różne właściwości pliku.
2. Informacje pobierane z Google Calendar V3 API mogą być następnie dalej wykorzystywane w aplikacjach Tulip, tabelach Tulip lub zmiennych Tulip, które będą przekazywane do innych funkcji konektora.

Punkt końcowy

Wywołanie HTTP PATCH do punktu końcowego https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Identyfikator kalendarza - wybrany identyfikator kalendarza
2. Identyfikator zdarzenia - wybrany identyfikator zdarzenia
3. Tytuł wydarzenia - tytuł wydarzenia
4. Data rozpoczęcia - godzina daty rozpoczęcia wydarzenia
5. Data zakończenia - data zakończenia wydarzenia
6. Strefa czasowa - strefa czasowa zdarzenia
7. Lokalizacja- Lokalizacja zdarzenia
8. Opis- Opis zdarzenia
9. Reguła powtarzania - Reguła powtarzania zawiera wszystkie szczegóły dotyczące tego, jak i kiedy zdarzenie powinno się powtarzać. Aby uzyskać szczegółowe informacje na temat reguł powtarzania, zapoznaj się z listą kilku reguł powtarzania dodanych w aplikacji wspomnianej w powyższym dokumencie.)

Wymagany ekstraktor danych wyjściowych

1. Identyfikator zdarzenia: Unikalny identyfikator zdarzenia, który będzie używany do wykonywania innych zadań.
2. Tytuł zdarzenia: Tytuł zdarzenia
3. Opis zdarzenia: Tytuł zdarzenia
4. Dodatkowe parametry zwracane wraz z odpowiedzią mogą być dołączone jako część parametrów wyjściowych.

Usuń zdarzenie

Cel

1. Użytkownicy mogą przekazać identyfikator kalendarza i identyfikator wydarzenia jako dane wejściowe, a Tulip usunie wydarzenie z kalendarza Google.

Punkt końcowy

Wywołanie HTTP DELETE do punktu końcowego -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}

Wymagane dane wejściowe

Następujące parametry są wysyłane jako treść żądania

1. Identyfikator kalendarza - wybrany identyfikator kalendarza
2. Identyfikator zdarzenia - wybrany identyfikator zdarzenia