内容提要
微软宣布了Microsoft Graph callRecords API的新功能,以回应客户的需求。这些新功能将于2月初推出,通过列出和筛选可用记录,简化和扩展开发人员访问通话记录的方式。callRecords API提供有关使用Microsoft Teams或Skype for Business时组织内发生的通话和在线会议的使用和诊断信息。新的List方法可用于列出组织的所有可用通话记录,并可使用$filter参数对返回的列表进行筛选,以仅返回与特定搜索条件相关的记录。此外,还引入了两个新对象participants_v2和organizer_v2,以提供有关用户身份的附加上下文。这些变化现在在Beta版中可用,并将于2月初正式发布。
延伸解读
按需拉取与变更通知互补
新 List 方法支持按需获取全部通话记录,并可用 $filter 按参与者 Entra 对象 ID 或 startDateTime 时间范围筛选。文章指出,现有变更通知仍可用,用于在新记录产生时接收通知;List 则适合一次性拉取特定参与者或时间段的记录。两者定位不同,开发者可根据场景选择,而非相互替代。
participants_v2 解决大型会议分页问题
新对象 participants_v2 可展开并分页,能完整反映大型会议中的所有用户,还提供专门列出通话参与者的方法。相比旧属性,这更适应参会者众多的场景。organizer_v2 则补充组织者的用户主体名称,为身份识别提供更多上下文。这些变化直接回应了客户对身份信息和大规模会议数据完整性的需求。
旧属性弃用但有 36 个月过渡期
引入新对象后,call record 上的旧 participant 和 organizer 属性被弃用,但微软承诺在 36 个月过渡期内继续支持。这意味着现有集成不会立即失效,但开发者应规划迁移到 participants_v2 和 organizer_v2,以避免过渡期结束后出现兼容问题。文章未说明具体迁移步骤,需关注后续文档。
Beta 已可用,2 月初正式发布
这些新功能目前处于 Beta 版,将于 2 月初正式发布。对于生产环境,建议等待正式版后再依赖;若在 Beta 阶段试用,需注意接口可能调整。文章未提及具体定价或额外许可要求,读者应结合自身租户和合规要求评估采用时机。
Q&A
微软 Graph callRecords API 新增了哪些功能?
新增了 List 方法,可以列出组织的所有可用通话记录,并支持使用 $filter 参数按条件筛选;同时引入了 participants_v2 和 organizer_v2 两个新对象,提供用户身份附加信息,其中 participants_v2 支持展开和分页,并有专门列出通话参与者的方法。
如何使用 callRecords API 的 List 方法筛选通话记录?
List 方法返回组织的所有可用通话记录,可通过 $filter 参数筛选,例如按通话参与者的 Entra 对象 ID 或基于 startDateTime 的时间范围来仅返回相关记录。
participants_v2 和 organizer_v2 对象有什么改进?
这两个新对象分别代表通话参与者和组织者,包含用户的 User Principal Name 以提供更多身份上下文;participants_v2 还支持展开和分页,能完整反映大型会议中的所有用户,并有专门方法列出通话参与者。
旧的参与者和组织者属性会被弃用吗?过渡期多长?
是的,随着新对象的引入,通话记录对象上的旧版参与者和组织者属性将被弃用,但微软会继续支持这些弃用属性,过渡期为 36 个月。
这些新功能何时正式发布?目前可用吗?
这些变化目前已在 Beta 版中可用,并将于 2 月初正式发布(一般可用)。
callRecords API 主要提供什么信息?
callRecords API 提供组织内使用 Microsoft Teams 或 Skype for Business 时发生的通话和在线会议的使用和诊断信息。