Google Calendar 事件操作#
使用这些操作可以在 Google Calendar 中创建、删除、获取和更新事件。有关 Google Calendar 节点本身的更多信息,请参阅 Google Calendar。
创建#
使用此操作向 Google Calendar 添加事件。
输入以下参数:
- 连接凭证:创建或选择现有的 Google Calendar 凭证。
- 资源:选择 Event。
- 操作:选择 Create。
- 日历:选择要添加事件的日历。选择 From list 从下拉列表中选择标题,或选择 By ID 输入日历 ID。
- 开始时间:事件的开始时间。默认使用计算当前时间的表达式 (
{{ $now }}
)。 - 结束时间:事件的结束时间。默认使用计算当前时间一小时后时间的表达式 (
{{ $now.plus(1, 'hour') }}
)。 - 使用默认提醒:是否根据日历配置启用事件的默认提醒。
选项#
- 全天事件:该事件是否为全天事件。
- 参会者:邀请参加该事件的参会者列表。
- 颜色名称或ID:事件的显示颜色。从列表中选择或使用表达式指定ID。
- 会议数据:创建会议链接(如Hangouts、Meet等)并附加到事件中。
- 描述:事件的描述信息。
- 来宾可邀请他人:除组织者外的参会者是否可以邀请其他人参加该事件。
- 来宾可修改:除组织者外的参会者是否可以修改该事件。
- 来宾可查看其他来宾:除组织者外的参会者是否可以查看其他参会者信息。
- ID:事件的不透明标识符。
- 地点:事件的物理位置(自由格式文本)。
- 最大参会人数:响应中包含的最大参会人数。如果实际人数超过此值,则只返回部分参会者。
- 重复频率:周期性事件的重复间隔。
- 重复次数:为周期性事件创建的实例数量。
- 重复截止日期:周期性事件应停止的日期。
- RRULE规则:周期性规则。设置后将忽略"重复频率"、"重复次数"和"重复截止日期"参数。
- 发送更新通知:是否发送关于新事件创建的通知。
- 显示状态:该事件是否在日历上占用时间。
- 摘要:事件的标题。
更多信息请参考 Events: insert | Google Calendar API文档。
删除#
使用此操作从 Google 日历中删除事件。
输入以下参数:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择 Event(事件)。
- 操作:选择 Delete(删除)。
- 日历:选择要从中删除事件的日历。选择 From list(从列表)从下拉列表中选择标题,或选择 By ID(按 ID)输入日历 ID。
- 事件 ID:要删除的事件 ID。
选项#
- 发送更新:是否发送关于事件删除的通知。
更多信息请参考 Events: delete | Google Calendar API 文档。
获取#
使用此操作从 Google 日历中检索事件。
输入以下参数:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择 Event(事件)。
- 操作:选择 Get(获取)。
- 日历:选择要从中获取事件的日历。选择 From list(从列表)从下拉列表中选择标题,或选择 By ID(按 ID)输入日历 ID。
- 事件 ID:要获取的事件 ID。
选项#
- 最大参会人数:响应中包含的最大参会人数。如果参会人数超过指定数量,则只返回参与者。
- 返回周期性事件的下一个实例:是否返回周期性事件的下一个实例而非事件本身。
- 时区:响应中使用的时区。默认使用 n8n 时区。
更多信息请参考 Events: get | Google Calendar API 文档。
获取多个事件#
使用此操作从 Google 日历中检索多个事件。
输入以下参数:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择 事件。
- 操作:选择 获取多个。
- 日历:选择要从中获取事件的日历。选择 从列表 从下拉列表中选择标题,或选择 按 ID 输入日历 ID。
- 返回全部:是否返回所有结果或仅返回指定限制内的结果。
- 限制:(当未选择"返回全部"时)要返回的最大结果数。
- 之后:检索在此时间之后发生的事件。事件的至少部分必须在此时间之后。默认情况下,此字段使用评估为当前时间的表达式(
{{ $now }}
)。将字段切换为"固定"可从日期小部件中选择日期。 - 之前:检索在此时间之前发生的事件。事件的至少部分必须在此时间之前。默认情况下,此字段使用评估为当前时间加一周的表达式(
{{ $now.plus({ week: 1 }) }}
)。将字段切换为"固定"可从日期小部件中选择日期。
选项#
- Fields: 指定要返回的字段。默认返回一组 Google 预定义的常用字段。使用 "*" 返回所有字段。更多信息请参阅 Google Calendar 关于处理部分资源的文档。
- iCalUID: 指定要包含在响应中的事件 ID(iCalendar 格式)。
- Max Attendees: 响应中包含的参会者最大数量。如果参会者数量超过指定值,则只返回参与者。
- Order By: 响应中事件的排序方式。
- Query: 用于查找匹配事件的自由文本搜索词。这会搜索除扩展属性外的所有字段。
- 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 日历中的事件。
输入以下参数:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择 事件。
- 操作:选择 更新。
- 日历:选择要添加事件的日历。选择 从列表 从下拉菜单中选择标题,或选择 按 ID 输入日历 ID。
- 事件 ID:要更新的事件 ID。
- 修改方式:对于重复事件,选择是更新整个重复事件还是特定实例。
- 使用默认提醒:是否根据日历配置为事件启用默认提醒。
- 更新字段:要更新的事件字段:
- 全天事件:事件是否为全天。
- 参与者:邀请参加事件的参与者。可以选择添加参与者或替换现有参与者列表。
- 颜色名称或 ID:事件颜色。从列表中选择或使用表达式指定 ID。
- 描述:事件的描述。
- 结束时间:事件的结束时间。
- 允许参与者邀请他人:除组织者外,参与者是否可以邀请其他人参加活动。
- 允许参与者修改:除组织者外,参与者是否可以修改活动。
- 允许参与者查看其他参与者:除组织者外,参与者是否可以查看活动参与者名单。
- ID:事件的不透明标识符。
- 位置:以自由文本形式表示的事件地理位置。
- 最大参与者数:响应中包含的最大参与者数量。如果参与者超过指定数量,则只返回部分参与者。
- 重复频率:重复事件的重复间隔。
- 重复次数:为重复事件创建的实例数量。
- 重复截止日期:重复事件应停止的日期。
- RRULE:重复规则。设置后,将忽略重复频率、重复次数和重复截止日期参数。
- 发送更新通知:是否发送关于新事件创建的通知。
- 显示状态:事件是否在日历上占用时间。
- 开始时间:事件的开始时间。
- 摘要:事件的标题。
- 可见性:事件的可见性:
- 机密:事件为私有。提供此值是为了兼容性。
- 默认:使用日历上事件的默认可见性。
- 公开:事件是公开的,所有日历读者都可以查看事件详情。
- 私有:事件是私有的,只有活动参与者可以查看事件详情。
更多信息请参考 Events: update | Google Calendar API 文档。