Работа с API записей звонков в Microsoft Graph
Записи звонков содержат сведения об использовании и диагностике, касающиеся звонков и собраний по сети в вашей организации при применении Microsoft Teams или Skype для бизнеса. API записей вызовов можно использовать для подписки на записи вызовов, перечисление записей вызовов и поиск записей вызовов по идентификаторам. Запись звонка создается после завершения звонка или собрания и сохраняется в течение 30 дней.
API записи звонков задается в подпространстве имен OData, microsoft.graph.callRecords.
Ключевые типы ресурсов
Структура записи звонка
Сущность callRecord представляет один одноранговый вызов или групповой вызов между несколькими участниками, иногда называемый собранием по сети.
Одноранговый звонок содержит один объект sessionмежду двумя участниками звонка. Групповые звонки содержат один или несколько объектов session. В групповом звонке каждый объект session находится между участником и конечной точкой службы.
Каждый объект session содержит один или несколько объектов segment. Объект segment представляет ссылку на носитель между двумя конечными точками. В большинстве звонков для каждого объекта session будет существовать только один объект segment, но иногда может иметься одна или несколько промежуточных конечных точек.
На схеме выше числа обозначают допустимое количество дочерних элементов каждого типа. Например, связь 1..N между callRecord и session означает, что один экземпляр callRecord может содержать один или несколько экземпляров session. Таким же образом, связь 1..N между segment и media означает, что один экземпляр segment может содержать один или несколько потоков media.
Журналы ТСОП и прямой маршрутизации
Ресурсы pstnCallLogRow и directRoutingLogRow содержат только сведения о звонках, использующих инфраструктуру телефонной сети общего пользования (ТСОП). Эти сведения могут быть полезны для понимания использования вызывающих продуктов в вашей организации. Однако эти ресурсы могут отражать только часть более крупного вызова или собрания. Например, строка журнала содержит сведения о пользователе, который размещает вызов ТСОП для присоединения к собранию по сети, но не содержит сведения о других участниках этого собрания по сети. Так как строка журнала также является лишь подмножеством сведений о записи вызовов, идентификатор для определенной строки журнала нельзя использовать для получения объекта callRecord .