求含Teams Room设备的Microsoft Graph通话记录API示例Payload

调用API地址 #

https://graph.microsoft.com/v1.0/communications/callRecords/<CallerId>?$expand=sessions($expand=segments)

Teams Room设备核心字段说明 #

• caller.identity.device：专属设备身份标识段，包含设备唯一ID和会议室名称
• caller.userAgent：明确标记为Microsoft Teams Rooms客户端，包含版本号、运行平台等信息
• segments[].media[].device：通话段内的设备详情，标注设备类型为roomSystem

完整返回Payload示例 #

{
    "startDateTime": "2024-12-13T15:00:00Z",
    "endDateTime": "2024-12-13T16:00:00Z",
    "sessions": [
        {
            "id": "session1",
            "startDateTime": "2024-12-13T15:05:00Z",
            "endDateTime": "2024-12-13T15:35:00Z",
            "caller": {
                "name": "A会议室",
                "identity": {
                    "device": {
                        "id": "device-123",
                        "displayName": "A会议室"
                    }
                },
                "userAgent": {
                    "headerValue": "Microsoft Teams Rooms (v4.16.40.0)",
                    "platform": "windows",
                    "productFamily": "teams"
                }
            },
            "segments": [
                {
                    "id": "segment1",
                    "startDateTime": "2024-12-13T15:05:00Z",
                    "endDateTime": "2024-12-13T15:20:00Z",
                    "media": [
                        {
                            "callerNetwork": {
                                "bandwidthLowEventRatio": 0.0,
                                "averageJitter": 10.0
                            },
                            "device": {
                                "type": "roomSystem",
                                "name": "A会议室Teams设备"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "id": "session2",
            "startDateTime": "2024-12-13T15:10:00Z",
            "endDateTime": "2024-12-13T15:50:00Z",
            "caller": {
                "name": "张三的笔记本电脑",
                "identity": {
                    "user": {
                        "id": "user-456",
                        "displayName": "张三"
                    }
                },
                "userAgent": {
                    "headerValue": "Microsoft Teams (v1.5.0)",
                    "platform": "macOS",
                    "productFamily": "teams"
                }
            },
            "segments": [
                {
                    "id": "segment2",
                    "startDateTime": "2024-12-13T15:10:00Z",
                    "endDateTime": "2024-12-13T15:50:00Z",
                    "media": [
                        {
                            "callerNetwork": {
                                "bandwidthLowEventRatio": 0.1,
                                "averageJitter": 15.0
                            },
                            "device": {
                                "type": "laptop",
                                "name": "MacBook Pro"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

内容的提问来源于stack exchange，提问作者kanneti jhansi