Поделиться через


Работа с API записей звонков в Microsoft Graph

Записи звонков содержат сведения об использовании и диагностике, касающиеся звонков и собраний по сети в вашей организации при применении Microsoft Teams или Skype для бизнеса. API записей вызовов можно использовать для подписки на записи вызовов, перечисление записей вызовов и поиск записей вызовов по идентификаторам. Запись звонка создается после завершения звонка или собрания и сохраняется в течение 30 дней.

API записи звонков задается в подпространстве имен OData, microsoft.graph.callRecords.

Ключевые типы ресурсов

Ресурс Методы
callRecord Перечисление callRecords
Получение callRecord
directRoutingLogRow getDirectRoutingCalls
participant Список participants_v2
pstnCallLogRow getPstnCalls
segment Перечисление сеансов
Получение callRecord
session Перечисление сеансов
Получение callRecord

Структура записи звонка

Сущность callRecord представляет один одноранговый вызов или групповой вызов между несколькими участниками, иногда называемый собранием по сети.

Одноранговый звонок содержит один объект sessionмежду двумя участниками звонка. Групповые звонки содержат один или несколько объектов session. В групповом звонке каждый объект session находится между участником и конечной точкой службы.

Каждый объект session содержит один или несколько объектов segment. Объект segment представляет ссылку на носитель между двумя конечными точками. В большинстве звонков для каждого объекта session будет существовать только один объект segment, но иногда может иметься одна или несколько промежуточных конечных точек.

Изображение структуры данных, представляющей полную запись звонка

На схеме выше числа обозначают допустимое количество дочерних элементов каждого типа. Например, связь 1..N между callRecord и session означает, что один экземпляр callRecord может содержать один или несколько экземпляров session. Таким же образом, связь 1..N между segment и media означает, что один экземпляр segment может содержать один или несколько потоков media.