Google Calendar API中Sequence是什么？是否仅活动开始日期变更时递增

首先直接回应核心问题：并不是只有活动开始日期变更时，Sequence 才会递增。

sequence 是 Google Calendar 遵循 iCalendar 标准实现的元字段，作用是标记事件的「重大行程类变更」——所有可能影响参会者行程安排的调整，都会触发该字段自增，仅修改不影响行程的次要信息时不会变动。

会触发 sequence 递增的常见操作： #

• 调整事件开始/结束时间、所属时区
• 修改循环事件的循环规则（如重复周期、例外日期）
• 变更事件状态（如从「已确认」改为「已取消」）
• 修改事件线下地点、线上会议链接
• 组织者新增/移除参会人员

不会触发 sequence 递增的常见操作： #

• 仅修改事件标题、描述、附件
• 仅调整个人专属的提醒规则
• 仅新增/修改个人对该事件的私有备注

适配你的需求的实现方案 #

你的需求是不存储原始事件的前提下检测开始日期更新，仅靠 sequence 无法实现，因为其他行程类变更也会触发其递增，可以采用以下极低存储成本的方案：

1. 首次拉取目标事件时，仅存储两个值：当前 sequence 的数值、事件 start 字段（包含 date/dateTime、timeZone 属性）的哈希值（直接拼接属性值后计算 MD5/SHA1 即可，不需要存储原始字段内容）
2. 后续拉取事件时，先比对 sequence 数值：如果和你存储的数值一致，说明事件没有发生任何行程类变更，开始日期必然没有更新
3. 如果 sequence 数值递增，再计算当前 start 字段的哈希值，和你存储的哈希值比对：不一致则说明开始日期发生了更新，一致则说明是其他行程类变更触发的 sequence 递增，仅更新你存储的 sequence 数值即可

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