Google Calendar API返回已删除重复事件问题咨询

架构老林

2026-6-13

谷歌日历API返回已删除重复事件的解决方案建议

临时修复方案

过滤status字段：API返回的每个事件都带有status属性，已删除的重复事件通常会被标记为"cancelled"。在应用的事件处理逻辑中添加判断，直接剔除所有status为cancelled的条目，无需修改singleEvents参数即可避免旧事件干扰。
利用事件关联字段区分：替换重复事件时，旧事件可能并未被彻底移除，而是作为重复系列的废弃条目存在。检查返回事件的recurrenceId（重复实例ID）和originalId（原始事件ID）字段，新事件的originalId应指向当前有效的重复系列主事件，而旧事件的这些字段会与新事件存在差异，可通过字段匹配筛选有效事件。
时间范围过滤：在API请求中添加updatedMin参数，设置为用户替换事件的时间节点之后，仅拉取该时间点后更新或创建的事件，避免获取历史遗留的已删除条目。示例请求：
```
GET https://www.googleapis.com/calendars/calendarId/events?updatedMin=YYYY-MM-DDTHH:MM:SSZ
```

提交官方Bug报告：如果上述方案无法解决，确认是API的异常返回行为，需向谷歌官方提交问题报告，报告中需包含：
- 问题发生的具体时间范围
- 受影响的日历ID、新旧事件的ID
- 完整的API请求参数（隐去敏感信息）
- 新旧事件的完整JSON响应数据（标注出关键差异字段，如status、recurrence、attendees等）
单独验证重复事件实例：调用events.instances接口获取指定重复事件的所有实例：
```
GET https://www.googleapis.com/calendars/calendarId/events/{eventId}/instances
```
对比该接口返回的实例是否包含已删除条目，以此确认问题出在事件列表接口还是重复事件的实例处理逻辑，为Bug报告补充更多细节。