Microsoft 캘린더 커넥터

::: (정보) ()앱을 다운로드하려면 방문하세요: 라이브러리:::

Microsoft의 캘린더용 그래프 API와 통합하기

소개

Microsoft 캘린더 API를 통해 사용자는 M365 계정에 대한 올바른 액세스 권한으로 Microsoft 캘린더 이벤트를 만들고, 읽고, 편집할 수 있습니다. 이 커넥터의 목표는 HTTP 커넥터를 사용하여 Microsoft의 그래프 API(v1.0)를 사용하여 Tulip과 Microsoft를 통합하고 고객에게 인스턴스로 가져올 수 있는 즉시 사용 가능한 커넥터를 제공하는 것입니다.

목적

Microsoft의 Graph API(v1.0)에 HTTP 호출을 수행하여 Microsoft 캘린더 이벤트와 상호 작용하여 다양한 사용 사례에 활용할 수 있는 캘린더의 다양한 읽기 및 쓰기 작업을 보여주는 다양한 커넥터 기능을 강조할 것입니다.

API 문서

Microsoft Graph API 문서

사전 요구 사항

1. Microsoft 365에서 계정을 만들고 Microsoft Entra ID에서 OAuth 2.0 자격 증명을 구성합니다.
2. Microsoft 포털에서 필요한 범위로 API를 등록합니다. Azure - Entra ID

엑셀용 커넥터 설정 동영상:

동일한 단계에 따라 캘린더 커넥터도 설정할 수 있습니다.

튤립 연결 세부 정보

Tulip의 캘린더 커넥터에 다음 정보를 구성해야 합니다.

커넥터에서 구성해야 합니다.

1. 실행 대상: 클라우드 커넥터 호스트
2. 호스트: graph.microsoft.com
3. 포트: 443
4. TLS: 예

OAuth 2: 모든 커넥터 함수에 인증이 이월됩니다.

커넥터 기능

1) 모든 캘린더 이벤트 가져오기

목적

이 커넥터는 M365 캘린더에서 모든 캘린더 이벤트를 가져옵니다.

엔드포인트

엔드포인트에 대한 HTTP GET 호출: https://graph.micrsoft.com:443/v1.0/me/events

필수 입력

입력이 필요하지 않습니다.

출력 추출기

1. eventID: 다른 작업을 수행하는 데 사용되는 이벤트의 고유 식별자입니다.
2. eventSubject: 이벤트의 제목입니다.
3. eventContent: 이벤트의 콘텐츠입니다.
4. eventStartDate: 이벤트의 시작 날짜 및 시간입니다.
5. eventEndDate: 이벤트 종료 날짜 및 시간입니다.
6. eventLocation: 이벤트의 위치입니다.
7. eventAttendees: 이벤트의 참석자입니다.
8. eventOrganizer: 이벤트의 주최자.
9. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함됩니다.

2) 사용자 미팅 일정 조회

목적

이 커넥터는 지정된 기간 동안 사용자, 배포 목록 또는 리소스(회의실 또는 장비) 모음에 대한 사용 가능/사용 불가 정보를 가져옵니다.

엔드포인트

엔드포인트 -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule 에 대한 HTTP GET 호출

필수 입력

요청 본문에 전달해야 하는 매개변수는 다음과 같습니다.

1. 이메일 주소: 사용 가능 여부 정보를 가져올 사용자, 배포 목록 또는 리소스의 SMTP 주소 모음입니다.
2. 스케줄 시작 날짜 시간: 해당 기간이 시작되는 날짜, 시간 및 표준 시간대입니다.
3. 스케줄 종료 날짜 시간: 해당 기간이 종료되는 날짜, 시간 및 표준 시간대입니다.
4. 표준 시간대: 이벤트 표준 시간대입니다.

출력 추출기

1. scheduleUserId: 스케줄 사용자 이메일 주소입니다.
2. startTime: 기간이 시작되는 날짜, 시간 및 표준 시간대입니다.
3. endTime: 기간이 종료되는 날짜, 시간 및 표준 시간대입니다.
4. timeZone: 표준 시간대입니다.
5. scheduleStatus: 사용자 스케줄의 응답 상태입니다.
6. scheduleSubject: 예약된 이벤트 제목입니다.
7. scheduleLocation: 예약된 이벤트 위치.
8. scheduleStartDateTime: 예약된 이벤트 시작 날짜 시간입니다.
9. scheduleEndDateTime: 예약된 이벤트 종료 날짜 시간.

3) 이벤트 만들기

목적

1. 사용자는 이벤트 제목, 콘텐츠, 시작 날짜 시간, 종료 날짜 시간 및 기타 매개 변수를 입력으로 전달할 수 있으며, Tulip은 제공된 입력으로 새 캘린더 이벤트를 생성합니다. API의 응답은 캘린더 이벤트의 메타데이터와 다양한 속성이 됩니다. 이를 통해 이벤트를 가져오고 업데이트하는 데 추가로 사용할 수 있습니다.
2. 이 커넥터는 사용자의 기본 캘린더 또는 특정 사용자나 그룹 사용자 또는 여러 사용자에 대한 지정된 캘린더에 이벤트를 만들 수 있습니다.
3. Microsoft Graph V1.0 API에서 가져온 정보는 다른 커넥터 기능으로 파이핑되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

엔드포인트에 대한 HTTP POST 호출: https://graph.microsoft.com:443/v1.0/me/events

필수 입력

요청 본문에서 전달해야 하는 매개변수는 다음과 같습니다.

1. 이벤트 제목: 이벤트 제목
2. 이벤트 내용: 이벤트 내용: 이벤트 내용
3. 이벤트 시작 날짜 시간: 이벤트의 시작 날짜 시간
4. 이벤트 시간대: 이벤트 표준 시간대: 이벤트의 표준 시간대
5. 이벤트 종료 날짜 시간: 이벤트 종료 날짜 시간
6. 이벤트 위치: 이벤트 위치: 이벤트의 위치
7. 참석자 이메일 주소: 참석자 이메일 주소: 참석자 이메일 주소

출력 추출기

1. eventId: 생성된 이벤트 ID
2. eventTimezone: 이벤트 시간대
3. eventSubject: 이벤트 제목
4. eventBody: 이벤트 본문: 이벤트 내용
5. eventStartDateTime: 이벤트의 시작 날짜 시간
6. eventEndDateTime: 이벤트 종료 날짜 시간
7. eventLocation: 이벤트의 위치
8. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함됩니다.

4) 반복 이벤트 만들기

목적

1. 사용자는 이벤트 제목, 콘텐츠, 시작 날짜 시간, 종료 날짜 시간 및 기타 파라미터를 입력으로 전달할 수 있으며, Tulip은 제공된 입력으로 새로운 반복 캘린더 이벤트를 생성합니다. API의 응답은 캘린더 이벤트의 메타데이터와 다양한 속성이 됩니다. 이를 통해 이벤트를 가져오고 업데이트하는 데 추가로 사용할 수 있습니다.
2. 이 커넥터는 사용자 또는 사용자 그룹에 대해 사용자의 기본 캘린더와 지정된 캘린더에 반복 이벤트를 만듭니다.
3. Microsoft Graph V1.0 API에서 가져온 정보는 다른 커넥터 기능으로 파이핑되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

엔드포인트 https://graph.microsoft.com:443/v1.0/me/events 에 대한 HTTP POST 호출

필수 입력

요청 본문에 전달해야 하는 파라미터는 다음과 같습니다.

1. 이벤트 제목: 이벤트 제목
2. 이벤트 내용: 이벤트 내용: 이벤트 내용
3. 이벤트 시작 날짜 시간: 이벤트의 시작 날짜 시간
4. 이벤트 시간대: 이벤트 표준 시간대: 이벤트의 표준 시간대
5. 이벤트 종료 날짜 시간: 이벤트 종료 날짜 시간
6. 이벤트 위치: 이벤트 위치: 이벤트의 위치
7. 참석자 이메일 주소: 참석자 이메일 주소: 참석자 이메일 주소
8. 반복 이벤트 유형: 반복 이벤트 유형: 반복 이벤트 유형
9. 반복 요일: 반복 이벤트 요일
10. 반복 시작 날짜: 반복 이벤트 시작 날짜
11. 반복 종료 날짜: 반복 이벤트 종료일: 반복 이벤트 종료일

출력 추출기

1. eventId: 생성된 이벤트 ID
2. eventTimezone: 이벤트 시간대
3. eventSubject: 이벤트 제목
4. eventBody: 이벤트 본문: 이벤트 내용
5. eventStartDateTime: 이벤트의 시작 날짜 시간
6. eventEndDateTime: 이벤트 종료 날짜 시간
7. eventLocation: 이벤트의 위치
8. eventRecurrenceRangeStartDate: 반복 이벤트 시작 날짜
9. eventRecurrenceRangeEndDate: 반복 이벤트 종료일
10. eventAttendees: 이벤트의 참석자입니다.
11. eventOrganizer: 이벤트의 주최자.
12. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함됩니다.

5) 이벤트 업데이트

목적

1. 사용자가 이벤트 ID, 제목, 내용 및 기타 파라미터를 입력으로 전달하면 Tulip이 캘린더의 이벤트를 업데이트합니다. API의 응답은 캘린더 이벤트의 메타데이터와 다양한 속성이 됩니다.
2. Microsoft Graph V1.0 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.

엔드포인트

엔드포인트 https://graph.microsoft.com:443/v1.0/me/events/{eventID}에 대한 HTTP PATCH 호출

필수 입력

요청 본문으로 전송되는 파라미터는 다음과 같습니다.

1. 이벤트 제목: 이벤트 제목
2. 이벤트 내용: 이벤트 내용: 이벤트 내용
3. 이벤트 시작 날짜 시간: 이벤트의 시작 날짜 시간
4. 이벤트 시간대: 이벤트의 시간대
5. 이벤트 종료 날짜 시간: 이벤트 종료 날짜 시간
6. 이벤트 위치: 이벤트 위치: 이벤트의 위치
7. 참석자 이메일 주소: 참석자의 이메일 주소입니다: 참석자 이메일 주소: 참석자 이메일 주소

출력 추출기

1. eventId: 생성된 이벤트 ID
2. eventTimezone: 이벤트 시간대
3. eventSubject: 이벤트 제목
4. eventBody: 이벤트 본문: 이벤트 내용
5. eventStartDateTime: 이벤트의 시작 날짜 시간
6. eventEndDateTime: 이벤트 종료 날짜 시간
7. eventLocation: 이벤트의 위치
8. 응답과 함께 반환되는 추가 파라미터는 출력 파라미터의 일부로 포함됩니다.

6) 이벤트 삭제

목적

1. 사용자가 이벤트 ID를 입력으로 전달하면 Tulip이 캘린더에서 이벤트를 삭제합니다.

엔드포인트

엔드포인트에 대한 HTTP DELETE 호출 - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

필수 입력

요청 본문으로 전송되는 파라미터는 다음과 같습니다.

1. 이벤트 ID - 이벤트 ID

추가 읽기

Microsoft 커넥터에 관한 자세한 정보를 확인하세요.

• Microsoft Outlook 커넥터
• Microsoft 팀즈 커넥터
• Microsoft Excel 커넥터