Google 日历事件操作(Google Calendar Event operations)#
使用这些作创建、删除、获取和更新谷歌日历中的事件。有关谷歌日历节点的更多信息,请参阅[谷歌日历](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/index.md)。
🌐 Use these operations to create, delete, get, and update events in Google Calendar. Refer to Google Calendar for more information on the Google Calendar node itself.
创建(Create)#
使用此操作将事件添加到 Google 日历。
🌐 Use this operation to add an event to a Google Calendar.
请输入以下参数:
🌐 Enter these parameters:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择事件。
- 操作:选择 创建。
- 日历:选择你想要添加事件的日历。选择 从列表中 从下拉列表中选择标题,或选择 按 ID 输入日历 ID。
- 开始时间:事件的开始时间。默认情况下,使用一个计算当前时间的表达式(
{{ $now }})。 - 结束时间:事件的结束时间。默认情况下,这使用评估为从现在起一小时的表达式(
{{ $now.plus(1, 'hour') }})。 - 使用默认提醒:是否根据日历设置为事件启用默认提醒。
选项(Options)#
- 全天:事件是否为全天活动。
- 参与者:需要邀请参加活动的人员。
- 颜色名称或ID:事件的颜色。从列表中选择或使用表达式指定ID。
- 会议数据:创建一个会议链接(Hangouts、Meet 等)并将其附加到活动中。
- 描述:活动的描述。
- 嘉宾可以邀请其他人:除组织者外的与会者是否可以邀请其他人参加活动。
- 访客可以修改:除了组织者之外,与会者是否可以修改活动。
- 客人可以查看其他客人:除组织者之外的与会者是否可以看到活动的其他参与者。
- ID:事件的不透明标识符。
- 地点:事件的地理位置,自由格式文本。
- 最大参与者数:响应中包含的最大参与者人数。如果参与者超过指定数量,则只返回参与者。
- 重复频率:重复事件的间隔时间。
- 重复次数?:要为重复事件创建的实例数量。
- 重复直到:循环事件应停止的日期。
- RRULE:重复规则。设置后,将忽略重复频率、重复次数和重复直到参数。
- 发送更新:是否发送关于新事件创建的通知。
- 显示为:此事件是否会在日历上占用时间。
- 摘要:活动的标题。
有关更多信息,请参阅 事件:插入 | Google 日历 API 文档。
🌐 Refer to the Events: insert | Google Calendar API documentation for more information.
删除(Delete)#
使用此操作可从 Google 日历中删除事件。
🌐 Use this operation to delete an event from a Google Calendar.
请输入以下参数:
🌐 Enter these parameters:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择事件。
- 操作:选择删除。
- 日历:选择一个你想要删除事件的日历。选择 从列表中 从下拉列表中选择标题,或选择 按 ID 输入日历 ID。
- 事件 ID:要删除的事件的 ID。
选项(Options)#
- 发送更新:是否发送关于事件删除的通知。
有关更多信息,请参阅 事件:删除 | Google 日历 API 文档。
🌐 Refer to the Events: delete | Google Calendar API documentation for more information.
获取(Get)#
使用此操作可从 Google 日历中检索事件。
🌐 Use this operation to retrieve an event from a Google Calendar.
请输入以下参数:
🌐 Enter these parameters:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择事件。
- 操作:选择 获取。
- 日历:选择你想获取事件的日历。选择 从列表中 以从下拉列表中选择标题,或选择 按 ID 输入日历 ID。
- 事件 ID:要获取的事件的 ID。
选项(Options)#
- 最大参与者数:响应中包含的最大参与者人数。如果参与者超过指定数量,则只返回参与者。
- 返回循环事件的下一个实例:是否返回循环事件的下一个实例,而不是事件本身。
- 时区:响应中使用的时区。默认使用 n8n 时区。
有关更多信息,请参阅 事件: 获取 | Google 日历 API 文档。
🌐 Refer to the Events: get | Google Calendar API documentation for more information.
获取多个(Get Many)#
使用此操作可从 Google 日历中检索多个事件。
🌐 Use this operation to retrieve more than one event from a Google Calendar.
请输入以下参数:
🌐 Enter these parameters:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择事件。
- 操作:选择 获取多个。
- 日历:选择你想获取事件的日历。选择 从列表中 以从下拉列表中选择标题,或选择 按 ID 输入日历 ID。
- 返回全部:是否返回所有结果,还是仅返回到指定的限制数。
- 限制:(当未选择“返回全部”时) 返回结果的最大数量。
- 之后:检索发生在此时间之后的事件。事件的至少部分必须在此时间之后。默认情况下,这使用一个评估为当前时间(
{{ $now }})的表达式。将字段切换为“固定”,即可从日期控件中选择日期。 - 之前:检索发生在此时间之前的事件。事件的至少一部分必须发生在此时间之前。默认情况下,这使用一个表达式,该表达式计算当前时间加上一周(
{{ $now.plus({ week: 1 }) }})。将字段切换为“固定”,即可从日期选择器中选择日期。
选项(Options)#
- 字段:指定要返回的字段。默认情况下,将返回 Google 预定义的一组常用字段。使用“*”返回所有字段。你可以在 Google 日历关于部分资源操作的文档 中了解更多信息。
- iCalUID:指定要包含在响应中的事件 ID(iCalendar 格式)。
- 最大参与者数:响应中包含的最大参与者人数。如果参与者超过指定数量,则只返回参与者。
- 排序方式:在响应中的事件使用的顺序。
- 查询:用于查找匹配事件的自由文本搜索词。此搜索会查找除扩展属性之外的所有字段。
- 重复事件处理:针对重复事件的操作如下:
- 所有事件:返回指定时间范围内重复事件的所有实例。
- 首次出现:在指定时间范围内返回重复事件的第一次发生。
- 下次发生:返回指定时间范围内重复事件的下一个实例。
- 显示已删除:是否在结果中包含已删除的事件(状态为“已取消”)。
- 显示隐藏邀请:是否在结果中包括隐藏的邀请。
- 时区:响应中使用的时区。默认使用 n8n 时区。
- 更新最小值:事件最后修改时间的下限(以 RFC 3339 时间戳 表示)
有关更多信息,请参阅 事件:列表 | Google 日历 API 文档。
🌐 Refer to the Events: list | Google Calendar API documentation for more information.
更新(Update)#
使用此操作更新 Google 日历中的事件。
🌐 Use this operation to update an event in a Google Calendar.
请输入以下参数:
🌐 Enter these parameters:
- 连接凭证:创建或选择现有的 Google 日历凭证。
- 资源:选择事件。
- 操作:选择更新。
- 日历:选择你想要添加事件的日历。选择 从列表中 从下拉列表中选择标题,或选择 按 ID 输入日历 ID。
- 事件 ID:要更新的事件 ID。
- 修改:对于重复事件,选择是更新整个重复事件还是仅更新重复事件的某个特定实例。
- 使用默认提醒:是否根据日历设置为事件启用默认提醒。
- 更新字段:要更新的事件字段:
- 全天:事件是否为全天活动。
- 与会者:要邀请参加活动的与会者。你可以选择添加与会者或替换现有的与会者列表。
- 颜色名称或ID:事件的颜色。从列表中选择或使用表达式指定ID。
- 描述:活动的描述。
- 结束:事件的结束时间。
- 客人可以邀请其他人:除了组织者之外的与会者是否可以邀请其他人参加活动。
- 访客可以修改:除组织者外,其他与会者是否可以对活动进行更改。
- 客人可以查看其他客人:除组织者之外的与会者是否可以看到活动的其他参与者。
- ID:事件的不透明标识符。
- 地点:事件的地理位置,自由格式文本。
- 最大参与者数:响应中包含的最大参与者人数。如果参与者超过指定数量,则只返回参与者。
- 重复频率:重复事件的间隔时间。
- 重复次数?:要为重复事件创建的实例数量。
- 重复直到:循环事件应停止的日期。
- RRULE:重复规则。设置后,将忽略重复频率、重复次数和重复直到参数。
- 发送更新:是否发送关于新事件创建的通知。
- 显示为:此事件是否会在日历上占用时间。
- 开始:活动的开始时间。
- 摘要:活动的标题。
- 可见性:事件的可见性:
- 机密:该活动为私密活动。此值用于兼容性。
- 默认:在日历上使用事件的默认可见性。
- 公开:该活动为公开活动,其详细信息对日历的所有读者可见。
- 私有:该活动为私有活动,只有活动参与者才能查看活动详情。
有关更多信息,请参阅 事件:更新 | Google 日历 API 文档。
🌐 Refer to the Events: update | Google Calendar API documentation for more information.