Google Calendar Watch问题：如何获取已变更事件的详情

一、Webhook空请求体是正常机制 #

Google Calendar的Watch通知本身不会在请求体中包含具体的事件变更详情，它只是一个触发信号，告知对应日历资源发生了变化。你需要利用Webhook请求头里的信息，主动调用API获取变更内容：

• 从x-goog-resource-uri可获取该日历的事件列表接口地址
• 结合之前保存的syncToken，调用事件列表接口时带上syncToken参数，即可只拉取上次同步后的变更事件

二、解决single Events模式下的syncToken循环问题 #

你提到的单事件模式（展开重复事件为单个实例）下无法获取syncToken，是因为拉取逻辑有误，正确处理方式如下：

1. 首次同步：调用事件列表接口时，携带singleEvents=true（展开重复事件）、timeMin（未来两个月的起始时间），同时保存返回结果中的nextSyncToken。
2. Webhook触发后的同步：调用接口时仅携带syncToken=你保存的nextSyncToken，不要添加timeMin或timeMax参数——若加时间范围，会导致Google API返回syncToken失效错误，进而陷入循环。syncToken会自动返回所有变更事件，其中包含你需要的未来两个月范围内的内容。
3. 本地过滤：对返回的事件做本地过滤，只保留符合未来两个月时间范围的事件即可。

三、优化拉取成本的额外建议 #

• 更新syncToken：每次同步后更新保存的nextSyncToken，确保后续仅拉取增量变更，避免全量拉取。
• 调整重复事件处理逻辑：若担心展开重复事件的性能问题，可先拉取未展开的重复事件，仅在需要展示或处理具体实例时再单独展开，这样syncToken的处理会更顺畅。
• 验证Webhook合法性：收到Webhook时，用x-goog-resource-id和x-goog-channel-id匹配创建Watch时保存的对应信息，过滤无效通知。

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