使用Microsoft Graph API更新多个微软账户现有日程事件的最优方案

方案1：自建全局事件-微软事件ID映射表（首选方案） #

• 新增一张映射表，存储字段包括：自研系统的全局唯一事件ID、用户唯一标识、微软Graph返回的事件id、用户绑定的微软日历ID、可选存储微软生成的iCalUId
• 首次给用户同步新建事件时，调用POST https://graph.microsoft.com/v1.0/me/events接口插入事件，将接口返回的事件ID写入映射表，和自研系统的全局事件ID做关联
• 后续需要更新/删除事件时，直接通过自研全局事件ID+用户ID查询映射表，拿到对应的微软事件ID，调用PATCH https://graph.microsoft.com/v1.0/me/events/{event-id}提交更新内容，或调用DELETE接口删除即可，完全不需要依赖iCalUId字段
• 跨用户批量更新同一个事件时，直接拉取该全局事件ID下关联的所有用户的微软事件ID，批量调用更新接口即可，不受微软多用户同事件生成不同iCalUId的逻辑影响

方案2：添加事件扩展属性做冗余溯源（可选补充方案） #

为了避免映射表数据丢失、或者需要反向从微软日历拉取事件匹配自研系统的场景，可以在插入微软事件时自定义开放扩展属性，将自研系统的全局事件ID存入事件属性中：

• 插入事件的请求Body中新增扩展字段，将自研事件ID作为自定义属性写入
• 后续需要从用户微软日历中匹配自研事件时，可调用Graph的事件列表接口，通过扩展属性筛选直接定位到对应的微软事件ID，无需依赖iCalUId匹配

注意事项 #

• 映射表需新增唯一约束：用户ID + 自研全局事件ID，避免重复插入映射数据
• 用户重新授权微软日历权限后，可通过遍历用户日历事件读取自定义扩展属性的方式，快速重建映射关系，无需全量重新同步
• 若需要兼容用户手动修改微软日历事件后同步回自研系统的场景，可优先用iCalUId匹配，匹配不到时再读取事件扩展属性匹配自研全局事件ID，双重校验提升准确率

内容的提问来源于stack exchange，提问作者Mauricio Cantú