谷歌日历连接器
  • 03 Nov 2023
  • 2 阅读时间
  • 贡献者

谷歌日历连接器


Article Summary

谷歌日历连接器

将郁金香与谷歌日历集成

简介

谷歌日历应用程序接口(Google Calendar API)允许用户通过对其谷歌账户设置正确的访问权限来创建、读取和编辑谷歌日历事件。该连接器的目标是使用 OAuth 身份验证,并通过 HTTP连接器与谷歌日历 V3 Api 和 Tulip 集成,为客户提供一个可导入其实例的开箱即用连接器。

目的

本文档重点介绍了不同的 HTTP 连接器功能,这些功能可通过 HTTP 调用谷歌日历 V3 API 端点来与谷歌日历进行交互,从而尝试对日历进行各种读写操作,这些操作可用于各种用例。

API 文档

  1. 谷歌日历

前提条件

  1. 在 Google 云控制台创建账户并配置 OAuth 2.0 凭据。更多信息请参阅 Google 的 API 文档。
  2. 在 Google API 控制台中激活 Google Calendar API。

郁金香连接详情

需要在 Tulip 连接器上配置以下信息。

  1. 运行于:云连接器主机
  2. 主机:www.googleapis.com
  3. 端口:443
  4. TLS: 是
  5. 连接器身份验证:OAuth2.0(管理员/操作员)
  6. 以下是需要传递的作用域:
  7. https://www.googleapis.com/auth/calendar
  8. https://www.googleapis.com/auth/calendar.events

连接器功能

获取所有日历

目的

此连接器将获取用户 google 日历中的所有日历。

端点

HTTP GET 调用端点 https://www.googleapis.com:443/calendar/v3/users/me/calendarList

所需输入

无需输入

所需输出提取器

  1. 日历 ID:日历的唯一标识符,用于执行其他任务
  2. 标题:日历标题
  3. 随响应返回的其他参数可作为输出参数的一部分

获取所有事件

目的

此连接器将获取特定日历的所有事件。

端点

HTTP GET 调用端点 -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

所需输入

以下是需要传递的 URL 参数

  1. 日历 ID - 日历 ID/在日历 ID 参数中输入 "Primary "作为值。指定 "Primary "可获取用户主日历上的所有事件。

所需输出提取器

  1. 日历 ID:用于执行其他任务的日历的唯一标识符
  2. 事件 ID:事件的唯一标识符,用于提取特定事件的详细信息。
  3. 标题:事件的标题
  4. 随响应返回的其他参数可作为输出参数的一部分包含在内

通过过滤器获取事件

用途

该连接器获取查询参数指定日期范围内的所有事件。

端点

HTTP GET 调用端点 -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true

必须输入

以下是需要传递的 URL 参数

  1. 日历 ID:日历 ID
  2. MaxResults: 最大结果数要获取的记录数
  3. MinTime:要获取的事件的开始日期时间
  4. MaxTime:要获取的事件的结束日期时间

所需输出提取器

  1. 日历 ID:日历的唯一标识符,用于执行其他任务
  2. 事件 ID:事件 ID: 用于执行其他任务的事件的唯一标识符
  3. 标题:事件标题
  4. 随响应返回的其他参数可作为输出参数的一部分包含在内

为单个/组/多个用户创建新事件

目的

  1. 用户可将事件标题、描述、开始日期时间、结束日期时间作为输入,Tulip 将根据所提供的事件标题创建一个新事件。API 的响应将是文件的元数据和各种属性。
  2. 从 Google Calendar V3 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用,这些变量将被输送到其他连接器功能中。

端点

HTTP POST 调用端点 https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

所需输入

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

  1. 日历 ID - 选定的日历 ID
  2. 事件标题 - 事件标题
  3. 开始日期时间 - 事件开始日期时间
  4. 结束日期 时间 - 事件结束日期 时间
  5. 时区 - 事件时区
  6. 出席者 - 活动出席者
  7. 地点--活动地点
  8. Description - 活动描述

所需的输出提取器

  1. 事件 ID:事件的唯一标识符,用于执行其他任务
  2. 事件标题:活动标题
  3. 组织者:活动组织者名称
  4. 随响应返回的其他参数可作为输出参数的一部分

为单个/群组/多个用户创建新的重复事件

目的

  1. 用户可将事件标题、描述、开始日期时间、结束日期时间、重复发生结束日期时间、重复发生类型和其他参数作为输入,Tulip 将根据提供的事件标题创建一个新事件。API 的响应将是文件的元数据和各种属性。
  2. 从 Google Calendar V3 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用,这些变量将被输送到其他连接器功能中。

端点

HTTP POST 调用端点 https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

所需输入

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

  1. 日历 ID - 选定的日历 ID
  2. 事件标题 - 事件标题
  3. 开始日期时间 - 事件开始日期时间
  4. 结束日期 时间 - 事件结束日期 时间
  5. 时区 - 事件时区
  6. 出席者 - 活动出席者
  7. Description - 活动描述
  8. 地点--活动地点
  9. 重现规则-- 重现规则包含事件重现的方式和时间的所有细节。以下是在应用程序中添加的一些递归规则(参见 [RFC5545](https://tools.ietf.org/html/rfc5545

第 3.8.5 节)文件了解详细的重现规则):

出现的每日事件:

Rrule:freq=daily;count=

例如:RRULE:FREQ=DAILY;COUNT=5

事件从事件开始日期起 5 天内发生,开始时间和结束时间相同。

每天一次,直至 :

Rrule:FREQ=DAILY;ILET=

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

事件从事件开始日期起每天发生,直到 "9 月 24 2021",开始时间和结束时间相同。

每周发生一次, :

Rrule:freq=weekly;count=

例如:RRULE:FREQ=WEEKLY;COUNT=3

事件每周发生一次,连续 3 周,事件开始日期为工作日的同一天,开始时间和结束时间相同。

每周一次,直至 :

Rrule:FREQ=WEEKLY;until=

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

事件每周发生一次,直至 "2021 年 9 月 24 日",事件开始日期为工作日的同一天,开始时间和结束时间相同

隔月的每个星期二:(this)

rrule:freq=monthly;interval=;byday=

例如:RRULE:FREQ=MONTHLY;INTERVAL=2;BYDAY=TU

事件每隔一个月的星期二发生一次,开始时间和结束时间相同。

所需输出提取器

  1. 事件 ID:事件的唯一标识符,用于执行其他任务
  2. 事件标题:活动标题
  3. 组织者:活动组织者名称
  4. 随响应返回的其他参数可作为输出参数的一部分

更新事件元数据

目的

  1. 用户可将事件标题、描述、开始日期时间、结束日期时间和其他参数作为输入,郁金香会根据所提供的输入更新现有事件。API 的响应将是文件的元数据和各种属性。
  2. 从 Google Calendar V3 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用,这些变量将被输送到其他连接器功能中。

端点

HTTP PATCH 调用端点https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

所需输入

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

  1. 日历 ID - 选定的日历 ID
  2. 事件 ID - 选定的事件 ID
  3. 事件标题 - 事件标题
  4. 开始日期时间 - 事件开始日期时间
  5. 结束日期 时间 - 事件结束日期 时间
  6. 时区 - 事件时区
  7. 地点 - 事件地点
  8. Description - 事件描述

所需的输出提取器

  1. 事件 ID:事件的唯一标识符,用于执行其他任务
  2. 事件标题:事件标题
  3. 事件描述:事件标题
  4. 随响应返回的其他参数可作为输出参数的一部分

更新重复事件

目的

  1. 用户可将事件标题、描述、开始日期时间、结束日期时间、重现规则和其他参数作为输入,Tulip 将根据所提供的输入更新现有事件。API 的响应将是文件的元数据和各种属性。
  2. 从 Google Calendar V3 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用,这些变量将被输送到其他连接器功能中。

端点

HTTP PATCH 调用端点https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*

所需输入

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

  1. 日历 ID - 选定的日历 ID
  2. 事件 ID - 选定的事件 ID
  3. 事件标题 - 事件标题
  4. 开始日期时间 - 事件开始日期时间
  5. 结束日期 时间 - 事件结束日期 时间
  6. 时区 - 事件时区
  7. Location(位置)- 事件位置
  8. Description- 事件描述
  9. 重现规则-- 重现规则包含事件重现的方式和时间的所有细节。有关详细的重现规则,请参阅上述文件中提到的在应用程序中添加的几个重现规则列表)。

所需输出提取器

  1. 事件 ID:事件的唯一标识符,用于执行其他任务
  2. 事件标题:事件标题
  3. 事件描述:事件标题
  4. 随响应返回的其他参数可作为输出参数的一部分

删除事件

目的

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

端点

调用 HTTP DELETE 端点-https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}

所需输入

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

  1. 日历 ID - 所选日历 ID
  2. 事件 ID - 选定的事件 ID

本文对您有帮助吗?