Google Calendar API录入Google Sheet时同日程出现双ID重复条目问题咨询

根因说明 #

Google Calendar采用多副本同步的设计逻辑：同一个会议事件会在所有关联的日历中生成独立副本，包括组织者的个人日历、所有参会人的日历、有权限查看该事件的共享公共日历。不同日历中的副本核心信息（标题、时间、参会人列表等）完全一致，但所属的Calendar ID对应各自日历的ID，因此会出现你观测到的「内容完全相同仅Calendar ID不同」的重复条目。
如果你调用API时检索了所有你有权限访问的日历，未做去重处理就直接写入Sheet，就会触发该问题。

• 基于全局唯一标识去重
  每个Calendar事件都有全局唯一的iCalUID字段，同一个会议的所有副本的iCalUID完全一致。你可以将该字段作为去重主键：每次写入Sheet前先校验是否已有相同iCalUID的记录，存在则跳过新增，仅按需更新字段即可。如果需要保留关联的Calendar ID信息，可以新增单独列存储所有关联ID，不需要生成多行重复记录。

• 缩小检索范围从源头避免重复
  如果你的业务仅需要拉取特定日历的事件，调用Events.list接口时直接指定目标日历ID作为请求参数，不要拉取全量可访问日历的内容。参考示例（Python）：

event_list = service.events().list(
    calendarId='target-calendar-id@group.calendar.google.com', # 仅拉取指定日历的事件
    q='检索关键词',
    singleEvents=True, # 展开循环事件，避免拉取到异常的重复实例
    timeMin=datetime.datetime.utcnow().isoformat() + 'Z'
).execute()

• 增加本地预去重逻辑
  拉取到事件列表后先在本地基于iCalUID完成去重，再批量写入Google Sheet，既可以避免重复条目，还能减少Sheet API的调用次数，节省配额。

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