Java Google Calendar API 如何为重复事件的单个实例添加参会人

核心思路 #

要获取重复日程的指定日期单例，需要使用Google Calendar API提供的events.instances接口，该接口专门用于返回重复母事件下的所有单次实例，你可以通过时间范围参数筛选出目标日期的特定实例。

具体实现步骤 #

• 第一步：构造目标日期的起止时间，格式要求为RFC3339标准（带时区信息），比如要获取2021年8月30日的实例，对应的起止时间示例为2021-08-30T00:00:00+08:00和2021-08-30T23:59:59+08:00，注意替换为你实际使用的时区。
• 第二步：调用events.instances接口查询该时间范围内的实例，你的场景为每周重复一次，所以返回的实例列表中只会有一个目标单例。
• 第三步：拿到目标实例后，按照你原有逻辑添加参会人后更新即可，更新后该实例会成为母事件的例外项，不会影响其他日期的重复日程。

代码示例（Java 对应你当前使用的客户端库） #

// 构造目标日期的起止时间（RFC3339格式，示例为东八区时间，按需替换时区和日期）
DateTime timeMin = new DateTime("2021-08-30T00:00:00+08:00");
DateTime timeMax = new DateTime("2021-08-30T23:59:59+08:00");

// 调用instances接口查询指定时间范围内的重复事件实例
Events instances = calendar.events().instances(calendarId, recurringEventId)
        .setTimeMin(timeMin)
        .setTimeMax(timeMax)
        .execute();

// 取查询到的目标实例
Event targetInstance = instances.getItems().get(0);

// 后续添加参会人逻辑和你原有逻辑一致
List<EventAttendee> attendees = CollectionUtils.isEmpty(targetInstance.getAttendees()) ?
        new ArrayList<>() : targetInstance.getAttendees();
attendees.add(testAttendee);
targetInstance.setAttendees(attendees);

// 注意更新时传入的是单例实例的ID，不是母事件ID
calendar.events()
        .update(calendarId, targetInstance.getId(), targetInstance)
        .execute();

注意事项 #

• 如果你要查询的日期没有对应的重复实例（比如母事件的重复结束时间早于目标日期、目标日期不在重复规则覆盖范围内），接口返回的列表会为空，建议增加空判断避免空指针。
• 更新单例实例后，该实例和母事件的关联不会完全断开，除非你主动删除该实例的recurringEventId属性，否则母事件的其他非参会人属性（比如标题、地点）更新时，依然会同步到该单例。

内容的提问来源于stack exchange，提问作者Tomas Marik