跳到主要内容

Google Calendar 事件操作#

使用这些操作可在 Google 日历中创建、删除、获取和更新事件。有关 Google Calendar 节点本身的更多信息，请参阅 Google Calendar。

创建#​

使用此操作向 Google 日历添加事件。

输入以下参数：

  • 用于连接的凭据：创建或选择现有的 Google Calendar 凭据。
  • 资源：选择 事件。
  • 操作：选择 创建。
  • 日历：选择要添加事件的日历。选择 从列表 以从下拉列表中选择标题，或选择 按 ID 以输入日历 ID。
  • 开始时间：事件的开始时间。默认使用计算结果为当前时间的表达式 ({{ $now }})。
  • 结束时间：事件的结束时间。默认使用计算结果为当前时间一小时后 ({{ $now.plus(1, 'hour') }}) 的表达式。
  • 使用默认提醒：是否根据日历配置为事件启用默认提醒。

选项#​

  • 全天：事件是否为全天事件。

  • 参与者：要邀请参加事件的参与者。

  • 颜色名称或 ID：事件的颜色。从列表中选择或使用表达式指定 ID。

  • 会议数据：创建会议链接（Hangouts、Meet 等）并将其附加到事件。

  • 描述：事件的描述。

  • 参与者可邀请其他人：除组织者外的参与者是否可以邀请其他人参加活动。

  • 参与者可修改：除组织者外的参与者是否可以修改活动。

  • 参与者可查看其他参与者：除组织者外的参与者是否可以查看活动的参与者。

  • ID：事件的不透明标识符。

  • 地点：事件的物理位置，以自由格式文本表示。

  • 最大参与者数：响应中包含的最大参与者数。如果参与者数量超过指定数量，则仅返回参与者。

  • 重复频率：重复事件的重复间隔。

  • 重复多少次？：为重复事件创建的实例数。

  • 重复截止日期：重复事件应停止的日期。

  • RRULE：重复规则。设置后，将忽略"重复频率"、"重复多少次"和"重复截止日期"参数。

  • 发送更新：是否发送有关新事件创建的通知。

  • 我的状态显示为：事件是否在日历上占用时间。

  • 摘要：事件的标题。

有关更多信息，请参阅 Events: insert | Google Calendar API 文档。

删除#​

使用此操作从 Google 日历中删除事件。

输入以下参数：

  • 用于连接的凭据：创建或选择现有的 Google Calendar 凭据。
  • 资源：选择 事件。
  • 操作：选择 删除。
  • 日历：选择要从中删除事件的日历。选择 从列表 以从下拉列表中选择标题，或选择 按 ID 以输入日历 ID。
  • 事件 ID：要删除的事件的 ID。

选项#​

  • 发送更新：是否发送有关事件删除的通知。

有关更多信息，请参阅 Events: delete | Google Calendar API 文档。

获取#​

使用此操作从 Google 日历中检索事件。

输入以下参数：

  • 用于连接的凭据：创建或选择现有的 Google Calendar 凭据。
  • 资源：选择 事件。
  • 操作：选择 获取。
  • 日历：选择要从中获取事件的日历。选择 从列表 以从下拉列表中选择标题，或选择 按 ID 以输入日历 ID。
  • 事件 ID：要获取的事件的 ID。

选项#​

  • 最大参与者数：响应中包含的最大参与者数。如果参与者数量超过指定数量，则仅返回参与者。
  • 返回重复事件的下一个实例：是否返回重复事件的下一个实例而不是事件本身。
  • 时区：响应中使用的时区。默认使用 n8n 时区。

有关更多信息，请参阅 Events: get | Google Calendar API 文档。

获取多个#​

使用此操作从 Google 日历中检索多个事件。

输入以下参数：

  • 用于连接的凭据：创建或选择现有的 Google Calendar 凭据。
  • 资源：选择 事件。
  • 操作：选择 获取多个。
  • 日历：选择要从中获取事件的日历。选择 从列表 以从下拉列表中选择标题，或选择 按 ID 以输入日历 ID。
  • 返回全部：是返回所有结果还是仅返回给定限制内的结果。
  • 限制：（当未选择"返回全部"时）要返回的最大结果数。
  • 之后：检索在此时间之后发生的事件。事件的至少部分必须在此时间之后。默认使用计算结果为当前时间的表达式 ({{ $now }})。将字段切换到"固定"以从日期小部件中选择日期。
  • 之前：检索在此时间之前发生的事件。事件的至少部分必须在此时间之前。默认使用计算结果为当前时间加一周 ({{ $now.plus({ week: 1 }) }}) 的表达式。将字段切换到"固定"以从日期小部件中选择日期。

选项#​

  • 字段：指定要返回的字段。默认返回一组由 Google 预定义的常用字段。使用 "*" 返回所有字段。您可以在 Google Calendar 关于使用部分资源的文档 中了解更多信息。

  • iCalUID：指定要包含在响应中的事件 ID（iCalendar 格式）。

  • 最大参与者数：响应中包含的最大参与者数。如果参与者数量超过指定数量，则仅返回参与者。

  • 排序依据：用于对响应中的事件进行排序的规则。

  • 查询：用于查找匹配事件的自由文本搜索词。这将搜索除扩展属性之外的所有字段。

  • 重复事件处理：如何处理重复事件：

    • 所有实例：返回指定时间范围内重复事件的所有实例。
    • 第一个实例：返回指定时间范围内重复事件的第一个实例。
    • 下一个实例：返回指定时间范围内重复事件的下一个实例。

  • 显示已删除：是否在结果中包含已删除的事件（状态为"已取消"）。

  • 显示隐藏的邀请：是否在结果中包含隐藏的邀请。

  • 时区：响应中使用的时区。默认使用 n8n 时区。

  • 最小更新时间：事件最后修改时间的下限（作为 RFC 3339 时间戳）。

有关更多信息，请参阅 Events: list | Google Calendar API 文档。

更新#​

使用此操作更新 Google 日历中的事件。

输入以下参数：

  • 用于连接的凭据：创建或选择现有的 Google Calendar 凭据。

  • 资源：选择 事件。

  • 操作：选择 更新。

  • 日历：选择要添加事件的日历。选择 从列表 以从下拉列表中选择标题，或选择 按 ID 以输入日历 ID。

  • 事件 ID：要更新的事件的 ID。

  • 修改：对于重复事件，选择是更新重复事件还是重复事件的特定实例。

  • 使用默认提醒：是否根据日历配置为事件启用默认提醒。

  • 更新字段：要更新的事件字段：

    • 全天：事件是否为全天事件。
    • 参与者：要邀请参加事件的参与者。您可以选择添加参与者或替换现有的参与者列表。
    • 颜色名称或 ID：事件的颜色。从列表中选择或使用表达式指定 ID。
    • 描述：事件的描述。
    • 结束：事件的结束时间。
    • 参与者可邀请其他人：除组织者外的参与者是否可以邀请其他人参加活动。
    • 参与者可修改：除组织者外的参与者是否可以修改活动。
    • 参与者可查看其他参与者：除组织者外的参与者是否可以查看活动的参与者。
    • ID：事件的不透明标识符。
    • 地点：事件的物理位置，以自由格式文本表示。
    • 最大参与者数：响应中包含的最大参与者数。如果参与者数量超过指定数量，则仅返回参与者。
    • 重复频率：重复事件的重复间隔。
    • 重复多少次？：为重复事件创建的实例数。
    • 重复截止日期：重复事件应停止的日期。
    • RRULE：重复规则。设置后，将忽略"重复频率"、"重复多少次"和"重复截止日期"参数。
    • 发送更新：是否发送有关新事件创建的通知。
    • 我的状态显示为：事件是否在日历上占用时间。
    • 开始：事件的开始时间。
    • 摘要：事件的标题。
    • 可见性：事件的可见性：
      • 机密：事件是私密的。提供此值是为了兼容性。
      • 默认：使用日历上事件的默认可见性。
      • 公开：事件是公开的，所有日历读者都可以查看事件详细信息。
      • 私密：事件是私密的，只有活动参与者才能查看活动详细信息。

有关更多信息，请参阅 Events: update | Google Calendar API 文档。

回到顶部