Google 日历事件操作

¥Google Calendar Event operations

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

¥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 日历凭据。

¥Credential to connect with: Create or select an existing Google Calendar credentials.

• 资源：选择“事件”。

¥Resource: Select Event.

• 操作：选择“创建”。

¥Operation: Select Create.

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

¥Calendar: Choose a calendar you want to add an event to. Select From list to choose the title from the dropdown list or By ID to enter a calendar ID.

• 开始时间：事件的开始时间。默认情况下，此选项使用一个表达式，计算结果为当前时间（{{ $now }}）。

¥Start Time: The start time for the event. By default, uses an expression evaluating to the current time ({{ $now }}).

• 结束时间：事件的结束时间。默认情况下，这将使用一个表达式，该表达式的计算结果为从现在起一小时后 ({{ $now.plus(1, 'hour') }})。

¥End Time: The end time for the event. By default, this uses an expression evaluating to an hour from now ({{ $now.plus(1, 'hour') }}).

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

¥Use Default Reminders: Whether to enable default reminders for the event according to the calendar configuration.

选项

¥Options

• 全天：此事件是否持续一整天。

¥All Day: Whether the event is all day or not.

• 与会者：要邀请参加活动的参与者。

¥Attendees: Attendees to invite to the event.

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

¥Color Name or ID: The color of the event. Choose from the list or specify the ID using an expression.

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

¥Conference Data: Creates a conference link (Hangouts, Meet, etc.) and attaches it to the event.

• 描述：事件描述。

¥Description: A description for the event.

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

¥Guests Can Invite Others: Whether attendees other than the organizer can invite others to the event.

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

¥Guests Can Modify: Whether attendees other than the organizer can modify the event.

• 访客可以看到其他访客：除组织者之外的其他参会者是否可以看到活动的参会者名单。

¥Guests Can See Other Guests: Whether attendees other than the organizer can see who the event's attendees are.

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

¥ID: Opaque identifier of the event.

• 位置：事件的地理位置（自由文本格式）。

¥Location: Geographic location of the event as free-form text.

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

¥Max Attendees: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.

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

¥Repeat Frequency: The repetition interval for recurring events.

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

¥Repeat How Many Times?: The number of instances to create for recurring events.

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

¥Repeat Until: The date at which recurring events should stop.

• RRULE:重复规则。设置后，将忽略“重复频率”、“重复次数”和“重复直到”参数。

¥RRULE: Recurrence rule. When set, ignores the Repeat Frequency, Repeat How Many Times, and Repeat Until parameters.

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

¥Send Updates: Whether to send notifications about the creation of the new event.

• 显示身份：此事件是否会在日历上阻塞时间。

¥Show Me As: Whether the event blocks time on the calendar.

• 摘要：事件的标题。

¥Summary: The title of the event.

请参阅 事件：插入 | 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 日历凭据。

¥Credential to connect with: Create or select an existing Google Calendar credentials.

• 资源：选择“事件”。

¥Resource: Select Event.

• 操作：选择“删除”。

¥Operation: Select Delete.

• 日历：选择要从中删除事件的日历。选择“从列表”从下拉列表中选择标题，或选择“通过 ID”输入日历 ID。

¥Calendar: Choose a calendar you want to delete an event from. Select From list to choose the title from the dropdown list or By ID to enter a calendar ID.

• 事件 ID：要删除的事件 ID。

¥Event ID: The ID of the event to delete.

选项

¥Options

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

¥Send Updates: Whether to send notifications about the deletion of the event.

请参阅 事件：删除 | 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 日历凭据。

¥Credential to connect with: Create or select an existing Google Calendar credentials.

• 资源：选择“事件”。

¥Resource: Select Event.

• 操作：选择“获取”。

¥Operation: Select Get.

• 日历：选择要从中获取事件的日历。选择“从列表”从下拉列表中选择标题，或选择“通过 ID”输入日历 ID。

¥Calendar: Choose a calendar you want to get an event from. Select From list to choose the title from the dropdown list or By ID to enter a calendar ID.

• 事件 ID：要获取的事件 ID。

¥Event ID: The ID of the event to get.

选项

¥Options

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

¥Max Attendees: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.

• 返回下一个重复事件实例：是否返回重复事件的下一个实例，而非事件本身。

¥Return Next Instance of Recurrent Event: Whether to return the next instance of a recurring event instead of the event itself.

• 时区：响应中使用的时区。默认情况下，此选项使用 n8n 时区。

¥Timezone: The timezone used in the response. By default, uses the n8n timezone.

请参阅 事件：get | 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 日历凭据。

¥Credential to connect with: Create or select an existing Google Calendar credentials.

• 资源：选择“事件”。

¥Resource: Select Event.

• 操作：选择“获取多个”。

¥Operation: Select Get Many.

• 日历：选择要从中获取事件的日历。选择“从列表”从下拉列表中选择标题，或选择“通过 ID”输入日历 ID。

¥Calendar: Choose a calendar you want to get an event from. Select From list to choose the title from the dropdown list or By ID to enter a calendar ID.

• 返回全部：是否返回所有结果，还是仅返回指定数量范围内的结果。

¥Return All: Whether to return all results or only up to a given limit.

• 限制：(当未选择 "全部返回" 时)要返回的最大结果数。

¥Limit: (When "Return All" isn't selected) The maximum number of results to return.

• 之后：检索此时间之后发生的事件。事件的至少一部分必须在此时间之后发生。默认情况下，此选项使用一个表达式，计算结果为当前时间（{{ $now }}）。将字段类型切换为 "fixed" 以从日期控件中选择日期。

¥After: Retrieve events that occur after this time. At least part of the event must be after this time. By default, this uses an expression evaluating to the current time ({{ $now }}). Switch the field to "fixed" to select a date from a date widget.

• 之前：检索此时间之前发生的事件。事件的至少一部分必须在此时间之前发生。默认情况下，此选项使用一个表达式，计算结果为当前时间加一周（{{ $now.plus({ week: 1 }) }}）。将字段类型切换为 "fixed" 以从日期控件中选择日期。

¥Before: Retrieve events that occur before this time. At least part of the event must be before this time. By default, this uses an expression evaluating to the current time plus a week ({{ $now.plus({ week: 1 }) }}). Switch the field to "fixed" to select a date from a date widget.

选项

¥Options

• 字段：指定要返回的字段。默认情况下，返回一组由 Google 预定义的常用字段。使用 "*" 返回所有字段。你可以在 Google 日历关于使用部分资源的文档 中找到更多信息。

¥Fields: Specify the fields to return. By default, returns a set of commonly used fields predefined by Google. Use "*" to return all fields. You can find out more in Google Calendar's documentation on working with partial resources.

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

¥iCalUID: Specifies an event ID (in the iCalendar format) to include in the response.

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

¥Max Attendees: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.

• 排序依据：响应中事件的顺序。

¥Order By: The order to use for the events in the response.

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

¥Query: Free text search terms to find events that match. This searches all fields except for extended properties.

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

¥Recurring Event Handling: What to do for recurring events:

• 所有出现次数：返回指定时间范围内重复事件的所有实例。

  ¥All Occurrences: Return all instances of the recurring event for the specified time range.

• 首次出现：返回指定时间范围内重复事件的第一个事件。

  ¥First Occurrence: Return the first event of a recurring event within the specified time range.

• 下次出现：返回指定时间范围内重复事件的下一个实例。

  ¥Next Occurrence: Return the next instance of a recurring event within the specified time range.

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

¥Show Deleted: Whether to include deleted events (with status equal to "cancelled") in the results.

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

¥Show Hidden Invitations: Whether to include hidden invitations in the results.

• 时区：响应中使用的时区。默认情况下，此选项使用 n8n 时区。

¥Timezone: The timezone used in the response. By default, uses the n8n timezone.

• 更新最小版本：事件最后修改时间的下限（以 RFC 3339 时间戳 表示）

¥Updated Min: The lower bounds for an event's last modification time (as an RFC 3339 timestamp)

请参阅 事件：列表 | 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 日历凭据。

¥Credential to connect with: Create or select an existing Google Calendar credentials.

• 资源：选择“事件”。

¥Resource: Select Event.

• 操作：选择“更新”。

¥Operation: Select Update.

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

¥Calendar: Choose a calendar you want to add an event to. Select From list to choose the title from the dropdown list or By ID to enter a calendar ID.

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

¥Event ID: The ID of the event to update.

• 修改：对于周期性事件，请选择是更新周期性事件本身，还是更新周期性事件的特定实例。

¥Modify: For recurring events, choose whether to update the recurring event or a specific instance of the recurring event.

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

¥Use Default Reminders: Whether to enable default reminders for the event according to the calendar configuration.

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

¥Update Fields: The fields of the event to update:

• 全天：此事件是否持续一整天。

  ¥All Day: Whether the event is all day or not.

• 与会者：要邀请参加活动的参与者。你可以选择添加与会者或替换现有与会者列表。

  ¥Attendees: Attendees to invite to the event. You can choose to either add attendees or replace the existing attendee list.

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

  ¥Color Name or ID: The color of the event. Choose from the list or specify the ID using an expression.

• 描述：事件描述。

  ¥Description: A description for the event.

• 结束：事件的结束时间。

  ¥End: The end time of the event.

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

  ¥Guests Can Invite Others: Whether attendees other than the organizer can invite others to the event.

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

  ¥Guests Can Modify: Whether attendees other than the organizer can make changes to the event.

• 访客可以看到其他访客：除组织者之外的其他参会者是否可以看到活动的参会者名单。

  ¥Guests Can See Other Guests: Whether attendees other than the organizer can see who the event's attendees are.

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

  ¥ID: Opaque identifier of the event.

• 位置：事件的地理位置（自由文本格式）。

  ¥Location: Geographic location of the event as free-form text.

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

  ¥Max Attendees: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.

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

  ¥Repeat Frequency: The repetition interval for recurring events.

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

  ¥Repeat How Many Times?: The number of instances to create for recurring events.

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

  ¥Repeat Until: The date at which recurring events should stop.

• RRULE:重复规则。设置后，将忽略“重复频率”、“重复次数”和“重复直到”参数。

  ¥RRULE: Recurrence rule. When set, ignores the Repeat Frequency, Repeat How Many Times, and Repeat Until parameters.

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

  ¥Send Updates: Whether to send notifications about the creation of the new event.

• 显示身份：此事件是否会在日历上阻塞时间。

  ¥Show Me As: Whether the event blocks time on the calendar.

• 开始：事件的开始时间。

  ¥Start: The start time of the event.

• 摘要：事件的标题。

  ¥Summary: The title of the event.

• 可见性：事件的可见性：

  ¥Visibility: The visibility of the event:

  • 机密：事件为私有事件。提供此值是为了兼容性。

  ¥Confidential: The event is private. This value is provided for compatibility.

  • 默认：使用日历事件的默认可见性。

  ¥Default: Uses the default visibility for events on the calendar.

  • 公开：此活动为公开活动，日历中的所有读者均可查看活动详情。

  ¥Public: The event is public and the event details are visible to all readers of the calendar.

  • 私有：此活动为私有活动，只有活动参与者才能查看活动详情。

  ¥Private: The event is private and only event attendees may view event details.

请参阅 事件：更新 | Google 日历 API 文档了解更多信息。

¥Refer to the Events: update | Google Calendar API documentation for more information.