使用 Microsoft Graph 中的通话记录 API

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

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

重要资源类型

Resource Methods
callRecord 列出 callRecords
获取 callRecord
directRoutingLogRow getDirectRoutingCalls
participant 列出participants_v2
pstnCallLogRow getPstnCalls
segment 列表会话
获取 callRecord
Session 列表会话
获取 callRecord

呼叫记录结构

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

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

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

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

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