如何在Microsoft Graph租户级监听会议更新/取消事件（无提前用户ID）

核心问题解答 #

1. 是否支持租户级全局订阅会议或日历事件变更？ #

目前Microsoft Graph不支持直接创建覆盖整个租户的全局订阅，所有事件变更订阅都需要针对单个用户（/users/{userId}/events）或组的日历资源。但可以通过应用权限批量处理用户，间接实现租户级的监控。

2. 是否可使用应用权限监控变更，无需单个用户ID？ #

可以。使用应用权限（而非委派权限），无需用户交互即可访问租户内所有用户的日历数据：

• 所需应用权限：Calendars.Read（只读，足够监控变更）或Calendars.ReadWrite（如需修改），需租户管理员预先同意
• 应用权限允许你遍历租户内所有用户，进而为每个用户创建订阅，或批量拉取所有用户的日历变更

推荐实现模式 #

模式1：批量用户订阅 + 变更通知（Webhooks） #

这是实时监控的首选方案：

1. 获取租户所有用户ID：调用GET /users（需Directory.Read.All应用权限），遍历所有用户
2. 为每个用户创建事件变更订阅：调用POST /subscriptions，目标资源设为/users/{userId}/events，配置你的webhook端点接收通知
3. 维护订阅生命周期：订阅默认有效期最长3天，需定期调用PATCH /subscriptions/{subscriptionId}续期；同时处理用户离职、订阅失效的情况，清理无效订阅

注意：每个应用最多可创建5000个订阅，若租户用户超过此数量，需结合其他方案（如按部门分组、定期轮换订阅）或使用Delta查询补充。

模式2：Delta查询 + 守护进程（定时批量拉取） #

适合用户量较大或无法通过订阅覆盖所有用户的场景：

1. 首次全量同步：对每个用户调用GET /users/{userId}/events/delta，获取该用户所有日历事件（包括Teams会议），记录Delta令牌
2. 定时增量拉取：后续每次调用时带上上次的Delta令牌，仅获取自上次同步以来的变更（更新、新增、删除）
3. 解析变更：检查事件的onlineMeeting属性（存在则为Teams会议），判断变更类型（时间更新、取消等）

模式3：针对特定会议的精准监控 #

若仅需监控已知meetingJoinUrl的会议：

1. 遍历租户用户的在线会议：调用GET /users/{userId}/onlineMeetings（应用权限OnlineMeetings.Read.All），匹配joinWebUrl找到目标会议的组织者ID和事件ID
2. 创建单事件订阅：为该会议对应的事件创建订阅（/users/{userId}/events/{eventId}），仅接收该特定会议的变更通知

最佳实践 #

• 最小权限原则：仅申请所需权限，如Calendars.Read+Directory.Read.All+OnlineMeetings.Read.All（如需查找特定会议），避免过度授权
• 订阅容错：配置webhook的重试策略，处理通知丢失的情况；定期校验订阅状态，自动续期或重建失效订阅
• 性能优化：对用户量大的租户，可分批次处理订阅或Delta查询，避免API限流；缓存用户ID列表，减少GET /users的调用频率
• 变更解析：通过事件的changedProperties字段判断具体变更内容（如时间、状态），结合isCancelled属性识别会议取消

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