使用 Microsoft Graph 中的通话记录 API

  • 项目

通话记录提供了使用 Microsoft Teams 或 Skype for Business 时组织内发生的通话和联机会议的使用情况和诊断信息。 可使用通话记录 API 来订阅通话记录，并按 ID 查找通话记录。 通话记录在通话或会议结束后创建，该记录将保留 30 天。

通话记录 API 在 OData 子命名空间中定，microsoft.graph.callRecords。

重要资源类型

Resource Methods
callRecord 获取 callRecord
Session 获取 callRecord
列表会话
segment 获取 callRecord
列表会话
pstnCallLogRow getPstnCalls
directRoutingLogRow getDirectRoutingCalls

呼叫记录结构

callRecord 实体表示多个参与者之间的单个对等呼叫或群组呼叫，有时称为联机会议。

对等呼叫包含呼叫中两个参与者之间的单个 session。 群组呼叫包含一个或多个 session 实体。 在群组呼叫中，每个 session 都介于参与者和服务终结点之间。

每个 session 都包含一个或多个 segment 实体。 segment 表示两个终结点之间的媒体链接。 对于大多数呼叫，每个 session 仅显示一个 segment，但有时可能会有一个或多个中间终结点。

表示完整通话记录的数据结构的图像

在上图中，数字表示每种类型可以有多少个子类型。 例如，callRecord 与 session 之间的 1..N 关系意味着一个 callRecord 实例可以包含一个或多个 session 实例。 同样，segment 与 media 之间的 1..N 关系意味着一个 segment 实例可以包含一个或多个 media 流。

相关内容