Skip to content

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 }) }})。将字段切换为"固定"可从日期小部件中选择日期。

选项#

  • 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 文档。