Arbeiten mit der Anrufdatensatz-API in Microsoft Graph
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
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.
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.
PSTN- und Direct Routing-Protokolle
Die Ressourcen pstnCallLogRow und directRoutingLogRow enthalten nur Informationen zu Anrufen, die pstN-Infrastruktur (Public Switched Telephone Network) nutzen. Diese Informationen können hilfreich sein, um die Verwendung von aufrufenden Produkten in Ihrer organization zu verstehen. Diese Ressourcen spiegeln jedoch möglicherweise nur einen Teil einer größeren Anruf- oder Besprechungserfahrung wider. Beispielsweise enthält eine Protokollzeile Informationen zu einem Benutzer, der einen PSTN-Anruf an einer Onlinebesprechung abgibt, aber keine Informationen zu anderen Teilnehmern dieser Onlinebesprechung. Da eine Protokollzeile auch nur eine Teilmenge der Aufrufdatensatzinformationen ist, kann die ID für eine bestimmte Protokollzeile nicht zum Abrufen eines callRecord-Objekts verwendet werden.