微软日历连接器

与 Microsoft 日历图形 API 集成

简介

Microsoft Calendar API 允许用户通过对其 M365 账户设置正确的访问权限来创建、读取和编辑 Microsoft 日历事件。此连接器的目标是使用 HTTP 连接器将 Tulip 与微软的 Graph API（v1.0）集成，并为客户提供可导入其实例的开箱即用连接器。

目的

我们将重点介绍不同的连接器功能，这些功能可通过 HTTP 调用 Microsoft 的 Graph Api(v1.0) 与 Microsoft 日历事件进行交互，从而展示可用于各种用例的日历上的各种读写操作。

应用程序接口文档

微软图形应用程序接口文档

前提条件

1. 在 Microsoft 365 上创建账户，并在 Microsoft Entra ID 中配置 OAuth 2.0 凭据。
2. 在 Microsoft 门户中使用所需范围注册 API。Azure - Entra ID

设置 excel 连接器的视频：

您也可以按照相同步骤设置日历连接器。

郁金香连接详细信息

需要在 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) 获取用户会议时间表

目的

该连接器将获取指定时间段内用户集合、分发列表或资源（房间或设备）的空闲/忙碌可用性信息。

端点

HTTP GET 调用端点 -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

所需输入

以下是要在请求正文中传递的参数

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. 用户可以将事件主题、内容、开始日期时间、结束日期时间和其他参数作为输入，郁金香会根据所提供的输入创建一个新的日历事件。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. 事件时区事件时区
3. eventSubject： 事件主题事件主题
4. eventBody： 事件主体事件内容
5. eventStartDateTime：事件开始日期时间
6. eventEndDateTime：事件结束日期时间
7. 事件位置：事件发生地点
8. 随响应返回的其他参数将作为输出参数的一部分。

4) 创建重复事件

目的

1. 用户可以将事件主题、内容、开始日期-时间、结束日期-时间和其他参数作为输入，郁金香将根据所提供的输入创建一个新的循环日历事件。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. 与会者电子邮件地址：与会者电子邮件地址
8. 重复事件类型： 重复事件类型重复活动类型
9. 每周复现活动日递归活动日
10. 递归开始日期递归事件开始日期
11. 递归事件结束日期递归事件结束日期

输出提取器

1. 事件 ID：创建事件 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 变量中进一步使用，这些变量将被输送到其他连接器功能中。

端点

HTTP PATCH 调用端点 https://graph.microsoft.com:443/v1.0/me/events/{eventID}

所需输入

以下是作为请求体发送的参数

1. 事件主题：事件主题
2. 事件内容：事件内容
3. 事件开始日期时间：事件开始日期时间
4. 事件时区：事件的时区
5. 事件结束日期时间：事件结束日期时间
6. 事件地点：活动地点
7. 与会者电子邮件地址：与会者电子邮件地址

输出提取器

1. eventId：创建的事件 ID
2. 事件时区事件时区
3. eventSubject： 事件主题事件主题
4. eventBody： 事件主体事件内容
5. eventStartDateTime：事件开始日期时间
6. eventEndDateTime：事件结束日期时间
7. 事件位置：事件发生地点
8. 随响应一起返回的其他参数将作为输出参数的一部分。

6) 删除事件

目的

1. 用户可将事件 ID 作为输入，Tulip 将删除日历中的事件。

端点

HTTP DELETE 调用端点 - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

所需输入

以下是作为请求体发送的参数

1. 事件 ID - 事件 ID

更多阅读

查看有关 Microsoft 连接器的更多信息

• Microsoft Outlook 连接器
• 微软团队连接器
• 微软 Excel 连接器