GAS-ICS-Sync项目中保留Google日历事件参与者的解决方案

在GAS-ICS-Sync项目中，用户报告了一个关于日历同步时参与者信息丢失的问题。本文将深入分析问题原因，并提供两种可行的解决方案。

问题背景

当使用GAS-ICS-Sync进行日历同步时，系统会完全覆盖目标Google日历中的事件，包括所有事件属性。这导致了一个实际问题：如果用户在Google日历中手动添加了事件参与者，这些参与者信息会在下次同步时被完全清除。

技术分析

问题的根源在于项目默认使用Calendar.Events.update方法来同步事件。这个方法会完全替换目标事件的所有属性，而不是部分更新。在Google Calendar API中，update操作会执行全量替换，而patch操作则只更新提供的字段。

解决方案

方案一：修改同步方法

将Helpers.gs文件中的同步方法从update改为patch：

// 原代码
return Calendar.Events.update(newEvent, targetCalendarId, calendarEvents[index].id);

// 修改后代码
return Calendar.Events.patch(newEvent, targetCalendarId, calendarEvents[index].id);

这种修改的优势在于：

1. 只更新源事件中存在的属性
2. 保留目标事件中手动添加的参与者信息
3. 不会影响其他同步功能

方案二：禁用现有事件修改

另一种解决方案是在配置中设置：

modifyExistingEvents = false

这种方法会：

1. 完全保留已存在的事件
2. 只添加新事件而不修改旧事件
3. 适用于不需要更新已有事件的场景

实施建议

对于大多数需要保留参与者信息的场景，推荐使用第一种方案（修改为patch方法），因为：

1. 它允许事件内容正常更新
2. 同时保留手动添加的参与者
3. 维护了日历的同步功能

第二种方案更适合那些只需要单向同步新事件，不需要更新已有事件的场景。

注意事项

实施修改后，建议：

1. 先在小范围测试
2. 检查所有同步功能是否正常
3. 确认参与者信息确实被保留
4. 监控同步后的日历事件完整性

这个解决方案已经经过实际验证，能够有效解决参与者信息丢失的问题，同时保持日历同步的核心功能。