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

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

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

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

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

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

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

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

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

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

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