Google Calendar 事件操作#
使用这些操作在 Google Calendar 中创建、删除、获取和更新事件。有关 Google Calendar 节点本身的更多信息,请参阅 Google Calendar。
创建#
使用此操作将事件添加到 Google Calendar。
输入以下参数:
- Credential to connect with(用于连接的凭据): 创建或选择现有的 Google Calendar 凭据。
- Resource(资源): 选择 Event(事件)。
- Operation(操作): 选择 Create(创建)。
- Calendar(日历): 选择要添加事件的日历。选择 From list(从列表中选择)以从下拉列表中选择标题,或选择 By ID(通过 ID)输入日历 ID。
- Start Time(开始时间): 事件的开始时间。默认使用一个表达式表示当前时间 (
{{ $now }})。 - End Time(结束时间): 事件的结束时间。默认使用一个表达式表示一小时后的时间 (
{{ $now.plus(1, 'hour') }})。 - Use Default Reminders(使用默认提醒): 是否根据日历配置为事件启用默认提醒。
选项#
-
All Day(全天): 指定事件是否为全天事件。
-
Attendees(参会人): 邀请参加该事件的人员。
-
Color Name or ID(颜色名称或 ID): 事件的颜色。可从列表中选择,或使用表达式指定 ID。
-
Conference Data(会议数据): 创建会议链接(如 Hangouts、Meet 等),并将其附加到事件中。
-
Description(描述): 事件的描述信息。
-
Guests Can Invite Others(访客可邀请他人): 除组织者外的参会人是否可以邀请其他人参加事件。
-
Guests Can Modify(访客可修改): 除组织者外的参会人是否可以修改事件。
-
Guests Can See Other Guests(访客可见其他访客): 除组织者外的参会人是否可以看到事件的所有参会人。
-
ID(ID): 事件的不透明标识符。
-
Location(位置): 事件的地理位置,以自由文本形式填写。
-
Max Attendees(最大参会人数): 响应中包含的最大参会人数。如果实际人数超过此值,则仅返回参与者信息。
-
Repeat Frequency(重复频率): 重复事件的间隔周期。
-
Repeat How Many Times?(重复多少次?): 为重复事件创建的实例数量。
-
Repeat Until(重复截止日期): 重复事件应停止的日期。
-
RRULE(重复规则): 事件的重复规则。设置后,将忽略“重复频率”、“重复多少次”和“重复截止日期”参数。
-
发送更新 (Send Updates) :是否发送关于新事件创建的通知。
- 显示我的状态为 (Show Me As) :该事件是否在日历上占用时间。
- 摘要 (Summary) :事件的标题。
更多信息请参考 Events: insert | Google Calendar API 文档。
删除#
使用此操作从 Google 日历中删除一个事件。 输入以下参数:
- 用于连接的凭据 (Credential to connect with) :创建或选择现有的 Google Calendar 凭据。
- 资源 (Resource) :选择 事件 (Event)。
- 操作 (Operation) :选择 删除 (Delete)。
- 日历 (Calendar) :选择要从中删除事件的日历。选择 从列表中选择 (From list) 以从下拉列表中选择标题,或选择 通过 ID (By ID) 输入日历 ID。
- 事件 ID (Event ID) :要删除的事件的 ID。
选项#
- 发送更新 (Send Updates) :是否发送关于事件删除的通知。
更多信息请参考 Events: delete | Google Calendar API 文档。
获取#
使用此操作从 Google 日历中获取某个事件。 输入以下参数:
- 用于连接的凭据 (Credential to connect with) :创建或选择现有的 Google Calendar 凭据。
- 资源 (Resource) :选择 事件 (Event)。
- 操作 (Operation) :选择 获取 (Get)。
- 日历 (Calendar) :选择要从中获取事件的日历。选择 从列表中选择 (From list) 以从下拉列表中选择标题,或选择 通过 ID (By ID) 输入日历 ID。
- 事件 ID (Event ID) :要获取的事件的 ID。
选项#
- 最大参会人数 (Max Attendees) :响应中包含的最大参会者数量。如果实际参会人数超过指定数量,则仅返回参与者信息。
- 返回重复事件的下一个实例 (Return Next Instance of Recurrent Event) :是否返回重复事件的下一个实例,而不是事件本身。
- 时区 (Timezone) :响应中使用的时区。默认使用 n8n 的时区设置。
请参考 Events: get | Google Calendar API 文档以获取更多信息。
获取多个事件#
使用此操作从 Google Calendar 中检索多个事件。 输入以下参数:
- 连接凭据(Credential to connect with) : 创建或选择一个现有的 Google Calendar 凭据。
- 资源(Resource) : 选择 Event。
- 操作(Operation) : 选择 Get Many。
- 日历(Calendar) : 选择要从中获取事件的日历。选择 From list 可从下拉列表中选择标题,或选择 By ID 手动输入日历 ID。
- 返回全部(Return All) : 是否返回所有结果,或仅返回指定数量的限制结果。
- 限制数量(Limit) : (当未选择“Return All”时)返回结果的最大数量。
- 之后(After) : 检索在此时间之后发生的事件。事件至少有一部分需在此时间之后。默认使用表达式表示当前时间(
{{ $now }})。可将字段切换为“fixed”模式,通过日期控件选择固定日期。 - 之前(Before) : 检索在此时间之前发生的事件。事件至少有一部分需在此时间之前。默认使用表达式表示当前时间加一周(
{{ $now.plus({ week: 1 }) }})。可将字段切换为“fixed”模式,通过日期控件选择固定日期。
选项#
-
字段(Fields) : 指定要返回的字段。默认返回 Google 预定义的一组常用字段。使用 "*" 可返回所有字段。更多详情请参阅 Google Calendar 关于部分资源操作的文档。
-
iCalUID : 指定要在响应中包含的事件 ID(采用 iCalendar 格式)。
-
最大参会人数(Max Attendees) : 响应中包含的最多参会者数量。如果实际参会者超过指定数量,则仅返回部分参与者。
- 排序方式(Order By) : 指定响应中事件的排序顺序。
- 查询条件(Query) : 用于搜索匹配事件的自由文本搜索词。该搜索将涵盖所有字段,但不包括扩展属性(extended properties)。
- 重复事件处理(Recurring Event Handling) : 对于重复事件的处理方式:
- 所有实例(All Occurrences) : 返回指定时间范围内重复事件的所有实例。
- 首个实例(First Occurrence) : 返回指定时间范围内重复事件的第一个实例。
- 下一个实例(Next Occurrence) : 返回指定时间范围内重复事件的下一个实例。
- 显示已删除事件(Show Deleted) : 是否在结果中包含已被删除的事件(状态为 "cancelled" 的事件)。
- 显示隐藏邀请(Show Hidden Invitations) : 是否在结果中包含被隐藏的邀请。
- 时区(Timezone) : 响应中使用的时区。默认使用 n8n 的时区设置。
- 更新时间下限(Updated Min) : 事件最后修改时间的下限(格式为 RFC 3339 时间戳)。
更多详情,请参考 Events: list | Google Calendar API 文档。
更新#
使用此操作可在 Google Calendar 中更新一个事件。
输入以下参数:
-
连接凭据(Credential to connect with) : 创建或选择一个现有的 Google Calendar 凭据。
-
资源类型(Resource) : 选择 Event。
-
操作类型(Operation) : 选择 Update。
-
日历(Calendar) : 选择要添加事件的日历。可选择 From list 从下拉列表中选择日历标题,或选择 By ID 手动输入日历 ID。
-
事件 ID(Event ID) : 要更新的事件的 ID。
-
修改对象(Modify) : 对于重复事件,选择是更新整个重复事件本身,还是仅更新其中某个具体实例。
-
使用默认提醒 : 是否根据日历配置为事件启用默认提醒。
- 更新字段 : 要更新的事件字段:
- 全天 : 该事件是否为全天事件。
- 参会人员 : 邀请参加该事件的人员。可以选择添加参会者,或替换现有的参会者列表。
- 颜色名称或 ID : 事件的颜色。可从列表中选择,或使用表达式指定 ID。
- 描述 : 事件的描述信息。
- 结束时间 : 事件的结束时间。
- 参会者可邀请他人 : 除组织者外的参会者是否可以邀请其他人参加该事件。
- 参会者可修改 : 除组织者外的参会者是否可以对该事件进行更改。
- 参会者可见其他参会者 : 除组织者外的参会者是否可以看到该事件的所有参会人员。
- ID : 事件的不透明标识符(opaque identifier)。
- 位置 : 事件的地理位置,以自由文本形式表示。
- 最大参会人数 : 响应中包含的最大参会人数。如果实际人数超过此数值,则仅返回参与者信息。
- 重复频率 : 周期性事件的重复间隔。
- 重复多少次? : 为周期性事件创建的实例数量。
- 重复截止日期 : 周期性事件应停止的日期。
- RRULE : 重复规则(Recurrence rule)。设置后,将忽略“重复频率”、“重复多少次”和“重复截止日期”参数。
- 发送更新通知 : 是否发送有关新事件创建的通知。
- 显示我的状态为 : 该事件是否在日历上占用时间。
- 开始时间 : 事件的开始时间。
- 标题 : 事件的标题。
- 可见性 : 事件的可见范围:
- Confidential(机密) : 事件为私有。此值用于兼容性目的。
- Default(默认) : 使用日历上事件的默认可见性设置。
- Public(公开) : 事件为公开,所有日历读者均可查看事件详情。
- Private(私有) : 事件为私有,仅事件参会者可查看详细信息。
- 更新字段 : 要更新的事件字段:
更多信息请参考 Events: update | Google Calendar API 文档。