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.