Share via

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

  • Статья

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

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

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

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

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

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

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

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

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

Связанные материалы