Konektor kalendarza Microsoft
- 06 Mar 2024
- 5 Minuty do przeczytania
- Współtwórcy
- Wydrukować
Konektor kalendarza Microsoft
- Zaktualizowano 06 Mar 2024
- 5 Minuty do przeczytania
- Współtwórcy
- Wydrukować
Article Summary
Share feedback
Thanks for sharing your feedback!
::: (info) () Aby pobrać aplikację, odwiedź: Biblioteka:::
Integracja z interfejsem Graph API firmy Microsoft dla aplikacji Kalendarz
Wprowadzenie
Interfejs API kalendarza Microsoft umożliwia użytkownikom tworzenie, odczytywanie i edytowanie wydarzeń kalendarza Microsoft z odpowiednim dostępem do ich kont M365. Celem tego konektora jest integracja Tulip z Microsoft za pomocą Graph API Microsoftu (v1.0) przy użyciu konektorów HTTP i zapewnienie naszym klientom gotowego konektora, który można zaimportować do ich instancji.
Cel
Zamierzamy wyróżnić różne funkcje konektorów, które można zbudować, wykonując wywołania HTTP do Graph Api firmy Microsoft (v1.0) w celu interakcji z wydarzeniami kalendarza Microsoft, aby zaprezentować różne akcje odczytu i zapisu w kalendarzu, które można wykorzystać w różnych przypadkach użycia.
Dokumentacja API
Dokumentacja interfejsu API Microsoft Graph
Wymagania wstępne
- Utwórz konto na platformie Microsoft 365 i skonfiguruj poświadczenia OAuth 2.0 w Microsoft Entra ID.
- Zarejestrowanie interfejsu API z wymaganymi zakresami w portalu Microsoft. Azure - Entra ID
Film przedstawiający konfigurację konektora dla programu Excel:
Możesz wykonać te same kroki, aby skonfigurować również konektor kalendarza.
Szczegóły połączenia Tulip
Następujące informacje muszą zostać skonfigurowane w Tulip's
Konektory.
- Uruchomione na: Host konektora w chmurze
- Host: graph.microsoft.com
- Port:443
- TLS: Tak
OAuth 2: Uwierzytelnianie zostanie przeniesione do wszystkich funkcji konektora.
Funkcje konektora
1) Pobierz wszystkie zdarzenia kalendarza
Cel
Ten konektor pobiera wszystkie wydarzenia z kalendarza M365.
Punkt końcowy
Wywołanie HTTP GET do punktu końcowego: https://graph.micrsoft.com:443/v1.0/me/events
Wymagane dane wejściowe
Dane wejściowe nie są wymagane
Ekstraktor danych wyjściowych
- eventID: Unikalny identyfikator zdarzenia, który zostanie wykorzystany do wykonania innych zadań.
- eventSubject: Temat zdarzenia.
- eventContent: Treść zdarzenia.
- eventStartDate: Data i godzina rozpoczęcia zdarzenia.
- eventEndDate: Data i godzina zakończenia zdarzenia.
- eventLocation: Lokalizacja wydarzenia.
- eventAttendees: Uczestnicy wydarzenia.
- eventOrganizer: Organizator wydarzenia.
- Dodatkowe parametry zwracane wraz z odpowiedzią są częścią parametrów wyjściowych.
2) Get User Meeting Schedule
Cel
Ten łącznik pobiera informacje o dostępności wolnych/ zajętych dla zbioru użytkowników, list dystrybucyjnych lub zasobów (pomieszczeń lub sprzętu) dla określonego okresu czasu.
Punkt końcowy
Wywołanie HTTP GET do punktu końcowego -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule
Wymagane dane wejściowe
Następujące parametry należy przekazać w treści żądania
- Adres e-mail: Zbiór adresów SMTP użytkowników, list dystrybucyjnych lub zasobów, dla których mają zostać pobrane informacje o dostępności.
- Schedule Start Date Time: Data, godzina i strefa czasowa rozpoczęcia okresu.
- Schedule End Date Time: Data, godzina i strefa czasowa zakończenia okresu.
- Strefa czasowa: Strefa czasowa zdarzenia.
Ekstraktor danych wyjściowych
- scheduleUserId: Adres e-mail użytkownika harmonogramu.
- startTime: data, godzina i strefa czasowa rozpoczęcia okresu.
- endTime: data, godzina i strefa czasowa zakończenia okresu.
- timeZone: strefa czasowa.
- scheduleStatus: Status odpowiedzi harmonogramów użytkownika.
- scheduleSubject: Temat zaplanowanego zdarzenia.
- scheduleLocation: Lokalizacja zaplanowanego zdarzenia.
- scheduleStartDateTime: Godzina rozpoczęcia zaplanowanego zdarzenia.
- scheduleEndDateTime: Zaplanowana data zakończenia zdarzenia.
3) Utwórz zdarzenie
Cel
- Użytkownicy mogą przekazać temat wydarzenia, treść, datę rozpoczęcia, godzinę zakończenia i inne parametry jako dane wejściowe, a Tulip utworzy nowe wydarzenie kalendarza z dostarczonymi danymi wejściowymi. Odpowiedzią interfejsu API będą metadane i różne właściwości wydarzenia kalendarza. Można to dalej wykorzystać do pobierania i aktualizacji zdarzeń.
- Ten konektor może utworzyć wydarzenie w domyślnym kalendarzu użytkownika lub określonym kalendarzu dla określonego użytkownika lub grupy użytkowników lub wielu użytkowników.
- Informacje pobierane z interfejsu API Microsoft Graph V1.0 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://graph.microsoft.com:443/v1.0/me/events
Wymagane dane wejściowe
W treści żądania należy przekazać następujące parametry
- Event Subject: Temat zdarzenia
- Treść zdarzenia: Treść zdarzenia
- Event Start Date Time: Data i godzina rozpoczęcia zdarzenia
- Strefa czasowa zdarzenia: Strefa czasowa zdarzenia
- Data zakończenia zdarzenia: Godzina zakończenia zdarzenia
- Lokalizacja zdarzenia: Lokalizacja wydarzenia
- Adres e-mail uczestnika: Adres e-mail uczestnika
Ekstraktor danych wyjściowych
- eventId: Identyfikator utworzonego wydarzenia
- eventTimezone: Strefa czasowa zdarzenia
- eventSubject: Temat zdarzenia
- eventBody: Treść zdarzenia
- eventStartDateTime: Godzina rozpoczęcia zdarzenia
- eventEndDateTime: Godzina zakończenia zdarzenia
- eventLocation: Lokalizacja zdarzenia
- Dodatkowe parametry zwracane wraz z odpowiedzią są dołączane jako część parametrów wyjściowych.
4) Tworzenie zdarzeń cyklicznych
Cel
- Użytkownicy mogą przekazać temat wydarzenia, treść, datę rozpoczęcia, godzinę zakończenia i inne parametry jako dane wejściowe, a Tulip utworzy nowe cykliczne wydarzenie kalendarza z dostarczonymi danymi wejściowymi. Odpowiedzią interfejsu API będą metadane i różne właściwości wydarzenia kalendarza. Można to dalej wykorzystać do pobierania i aktualizowania zdarzeń.
- Ten konektor utworzy powtarzające się wydarzenie w domyślnym kalendarzu użytkownika i określonym kalendarzu dla użytkownika lub grupy użytkowników.
- Informacje pobierane z interfejsu API Microsoft Graph V1.0 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 POST do punktu końcowego https://graph.microsoft.com:443/v1.0/me/events
Wymagane dane wejściowe
W treści żądania należy przekazać następujące parametry
- Event Subject: Temat zdarzenia
- Treść zdarzenia: Treść zdarzenia
- Event Start Date Time: Data i godzina rozpoczęcia zdarzenia
- Strefa czasowa zdarzenia: Strefa czasowa zdarzenia
- Data zakończenia zdarzenia: Godzina zakończenia zdarzenia
- Lokalizacja zdarzenia: Lokalizacja wydarzenia
- Adres e-mail uczestnika: Adres e-mail uczestnika
- Typ zdarzenia cyklicznego: Typ wydarzenia powtarzającego się
- Powtarzające się dni tygodnia: Dzień wydarzenia nawrotu
- Data rozpoczęcia nawrotu: Data rozpoczęcia zdarzenia nawrotu
- Data zakończenia nawrotu: Data zakończenia zdarzenia nawrotu
Ekstraktor danych wyjściowych
- eventId: Identyfikator utworzonego zdarzenia
- eventTimezone: Strefa czasowa zdarzenia
- eventSubject: Temat zdarzenia
- eventBody: Treść zdarzenia
- eventStartDateTime: Data rozpoczęcia i godzina zdarzenia
- eventEndDateTime: Data końcowa i godzina zdarzenia
- eventLocation: Lokalizacja zdarzenia
- eventRecurrenceRangeStartDate: Data rozpoczęcia zdarzenia cyklicznego.
- eventRecurrenceRangeEndDate: Data zakończenia wydarzenia cyklicznego.
- eventAttendees: Uczestnicy wydarzenia.
- eventOrganizer: Organizator wydarzenia.
- Dodatkowe parametry zwracane wraz z odpowiedzią są częścią parametrów wyjściowych.
5) Aktualizacja wydarzenia
Cel
- Użytkownicy mogą przekazać identyfikator wydarzenia, temat, treść i inne parametry jako dane wejściowe, a Tulip zaktualizuje wydarzenia w kalendarzu. Odpowiedzią API będą metadane i różne właściwości wydarzeń kalendarza.
- Informacje pobierane z interfejsu API Microsoft Graph V1.0 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://graph.microsoft.com:443/v1.0/me/events/{eventID}
Wymagane dane wejściowe
Następujące parametry są wysyłane jako treść żądania
- Event Subject: Temat zdarzenia
- Treść zdarzenia: Treść zdarzenia
- Event Start Date Time: Godzina rozpoczęcia zdarzenia
- Event TimeZone: Strefa czasowa zdarzenia
- Data zakończenia zdarzenia: Godzina zakończenia zdarzenia
- Lokalizacja zdarzenia: Lokalizacja wydarzenia
- Adres e-mail uczestnika: Adres e-mail uczestnika
Ekstraktor danych wyjściowych
- eventId: Identyfikator utworzonego wydarzenia
- eventTimezone: Strefa czasowa zdarzenia
- eventSubject: Temat zdarzenia
- eventBody: Treść zdarzenia
- eventStartDateTime: Godzina rozpoczęcia zdarzenia
- eventEndDateTime: Godzina zakończenia zdarzenia
- eventLocation: Lokalizacja zdarzenia
- Dodatkowe parametry zwracane wraz z odpowiedzią są dołączane jako część parametrów wyjściowych.
6) Usuń zdarzenie
Cel
- Użytkownicy mogą przekazać identyfikator wydarzenia jako dane wejściowe, a Tulip usunie wydarzenie z kalendarza.
Punkt końcowy
Wywołanie HTTP DELETE do punktu końcowego - https://graph.microsoft.com:443/v1.0/me/events/{eventID}
Wymagane dane wejściowe
Następujące parametry są wysyłane jako treść żądania
- Event ID - identyfikator wydarzenia
Więcej informacji
Więcej informacji na temat konektorów Microsoft
Czy ten artykuł był pomocny?
