Arbeiten mit der Anrufdatensatz-API in Microsoft Graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Anrufdatensätze bieten unter Verwendung von Microsoft Teams oder Skype for Business Verwendungs- und Diagnoseinformationen zu den Anrufen und Onlinebesprechungen, die in Ihrer Organisation stattfinden. Sie können die Anrufdatensätze-APIs verwenden, um Anrufdatensätze zu abonnieren, Anrufdatensätze aufzulisten und Anrufdatensätze nach IDs nachzuschlagen. Ein Anrufdatensatz wird erstellt, nachdem ein Anruf oder eine Besprechung beendet wurde, und der Datensatz wird 30 Tage lang aufbewahrt.

Die Anrufdatensatz-API wird im OData-Unter-Namespace, microsoft.graph.callRecords, definiert.

Schlüsselressourcentypen

Ressource Methoden
callRecord Auflisten von callRecords
Get callRecord
directRoutingLogRow getDirectRoutingCalls
participant participants_v2 auflisten
pstnBlockedUsersLogRow getPstnBlockedUsersLog
pstnCallLogRow getPstnCalls
pstnOnlineMeetingDialoutReport getPstnOnlineMeetingDialoutReport
segment List sessions
Get callRecord
session List sessions
Get callRecord
smsLogRow getSmsLog

Struktur eines Anrufdatensatzes

Die Entität callRecord stellt einen einzelnen Peer-to-Peer-Anruf oder einen Gruppenanruf zwischen mehreren Teilnehmern dar, der manchmal auch als Onlinebesprechung bezeichnet wird.

Ein Peer-zu-Peer-Anruf enthält eine einzelne session zwischen den beiden Anrufteilnehmern. Gruppenanrufe enthalten mindestens eine session-Entität. Bei einem Gruppenanruf findet jede session zwischen dem Teilnehmer und einem Dienstendpunkt statt.

Jede session enthält mindestens eine segment-Entität. Ein segment stellt einen Medienlink zwischen zwei Endpunkten dar. Bei den meisten Anrufen wird nur ein segment für jede session vorhanden sein. Es kann jedoch vorkommen, dass ein oder mehrere Zwischenendpunkte vorhanden sind.

Bild einer Datenstruktur, die einen vollständigen Anrufdatensatz darstellt

Im obigen Diagramm deuten die Zahlen darauf hin, wie viele untergeordnete Elemente jedes Typs vorhanden sein können. Beispielsweise bedeutet eine 1..N-Beziehung zwischen einem callRecord und einer session, dass eine callRecord-Instanz eine oder mehrere session-Instanzen enthalten kann. In ähnlicher Weise bedeutet eine 1..N-Beziehung zwischen einem segment und einem media, dass eine segment-Instanz einen oder mehrere media-Datenströme enthalten kann.