Google Calendar API同步Outlook事件：ID匹配异常与删除失败问题排查

核心原因 #

你遇到的「删除时返回Not Found」问题，和Google Calendar API的事件ID使用规则直接相关：

• 虽然创建事件时你可以自定义id（传入Outlook的EntryID），且API返回的id字段和你传入的值一致，但删除事件必须结合对应的calendarId才能定位到目标事件——你大概率是调用删除接口时没有指定正确的calendarId，或者使用了错误的日历上下文。
• htmlLink中的eid是Google用于网页端跳转的内部标识符，完全不需要用它来做API调用，API只认返回的id字段，但必须搭配正确的calendarId。

正确处理流程 #

1. 创建事件时存储关键信息
   调用Google Calendar API创建事件成功后，从响应中提取两个核心值：

   • id：即你传入的Outlook EntryID（API返回的该字段值和你传入的一致）
   • calendarId：事件所属的日历ID（如果是主日历，通常是primary；如果是其他日历，是该日历的唯一ID）
     将这两个值存储到Outlook事件的自定义属性中（比如通过Outlook VBA的UserProperties.Add方法，新增GoogleEventId和GoogleCalendarId两个属性）。

2. 删除事件时的正确调用方式
   后续需要同步删除时，从Outlook事件的自定义属性中取出GoogleEventId和GoogleCalendarId，构造删除接口的请求：

   DELETE https://www.googleapis.com/calendar/v3/calendars/{GoogleCalendarId}/events/{GoogleEventId}
   

   确保请求头中携带有效的accessToken，且该token拥有calendar.events.delete的权限范围。

额外排查点 #

• 检查Outlook EntryID是否包含Google Calendar自定义ID不允许的字符：Google允许的字符为字母、数字、下划线、连字符、点号。如果EntryID有斜杠、等号等特殊字符，可能导致创建时API表面返回成功，但实际存储的ID被隐式处理，删除时无法匹配。这种情况建议对EntryID做哈希（比如MD5）或Base64编码，生成符合规则的自定义ID后再传入。
• 确认创建和删除时使用的是同一个Google账号的accessToken，避免跨账号操作导致的找不到事件问题。

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