N8N中文教程
集成节点/Built in_nodes/Actions/Google_Calendar

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