#  资源介绍
##  资源定义
用于导出一段时间内租户的会议数据，包括：[导出会议明细](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/meeting_list)、[导出参会人明细](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/participant_list)、[导出参会人会议质量数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/participant_quality_list)。

##  使用流程
导出需要使用三个接口。

【创建导出任务】传递指定参数创建导出任务获得导出任务id

【查询导出任务结果】根据导出任务id获取导出结果

【下载导出文件】根据导出结果中的fileToken，下载导出文件

curl命令举例：

>  **curl -o xxx.xlsx https://open.feishu.cn/open-apis/vc/v1/exports/download?file_token=xxxxx --header 'Authorization: Bearer t-xxxx'**

##  权限说明
导出权限需要和用户飞书管理后台上的保持一致。

当使用tenant-access-token时，需要这个应用的创建者具有飞书管理后台 > 视频会议与直播 > 会议管理的权限，最后获得的下载地址也会校验权限，只有当前应用的创建者能够访问。

（推荐）当使用user-access-token时，需要使用这个应用的用户具有飞书管理后台 > 视频会议与直播 > 会议管理的权限，最后获得的下载地址也会校验权限，只有当前用户能够访问。

##  资源：会议明细

###  字段说明

名称 | 描述
---|---
会议ID | 9位会议号<br>**示例值**："123456789"
会议主题 | 会议主题<br>**示例值**："xx的视频会议"
会议组织者 | - 日程会议：会议组织者<br>- 即时会议（包含1v1通话）：会议/通话 发起人/会议室；<br>- 面试会议：面试官<br>- 开放平台的预约会议：会议预约者<br>**示例值**："xx"
部门 | 部门名称<br>**示例值**："人事部"
用户ID | 内部员工ID<br>**示例值**："1a2b3c4d"
工号 | 工号<br>**示例值**："12345670000"
邮箱 | 邮箱<br>**示例值**："xx@email.com"
手机 | 手机号<br>**示例值**："+86123****8910"

会议开始时间 | 会议开始时间<br>**示例值**："2022.07.21 11:01:40 (GMT+08:00)"

会议结束时间 | 会议结束时间<br>**示例值**："2022.07.21 12:01:40 (GMT+08:00)"

会议持续时间 | 会议持续时间<br>**示例值**："01:00:00"

参会人数量 | 参会人数量<br>**示例值**："2"

音频 | 会中是否使用过麦克风/扬声器<br>**示例值**："是"
视频 | 会中是否使用过摄像头<br>**示例值**："是"

共享 | 会中是否使用过共享屏幕/magic-share<br>**示例值**："否"

录制 | 会中是否开启过录制<br>**示例值**："是"

电话 | 会中是否使用过pstn<br>**示例值**："否"

##  资源：参会人明细

###  字段说明

名称 | 描述
---|---
参会人 | 参会人名称<br>**示例值**："xx"
部门 | 部门名称<br>**示例值**："人事部"
用户ID | 内部员工ID<br>**示例值**："1a2b3c4d"
工号 | 工号<br>**示例值**："12345670000"
电话 | 手机号<br>**示例值**："+86123****8910"
邮箱 | 邮箱<br>**示例值**："xx@email.com"
设备 | 设备类型<br>**示例值**："WINDOWS"
客户端版本 | 应用版本<br>**示例值**："5.18.0"
公网IP | 公网IP地址<br>**示例值**："170.40.80.80"
内网IP | 内网IP地址<br>**示例值**："192.168.1.1"
代理服务 | 参会人是否开启代理服务设置<br>**示例值**："否"
位置 | 参会人所在地理位置<br>**示例值**："中国大陆"

网络类型 | 包括LAN、wifi等<br>**示例值**："wifi"

麦克风 | 麦克风设备名<br>**示例值**："与系统一致"

扬声器 | 扬声器设备名<br>**示例值**："与系统一致"
摄像头 | 摄像头设备名<br>**示例值**："Integrated Camera"
音频 | 参会人是否使用过麦克风/扬声器<br>**示例值**："是"
视频 | 参会人是否使用过摄像头<br>**示例值**："是"
共享 | 参会人是否使用过共享屏幕/magic-share<br>**示例值**："否"
入会时间 | 参会人首次入会时间<br>**示例值**："2022.07.21 11:04:52 (GMT+08:00)"
离会时间 | 参会人最后一次离会时间<br>**示例值**："2022.07.21 12:04:52 (GMT+08:00)"
参会时长 | 参会人在会议中的累计时长<br>**示例值**："00:01:58"
离会原因 | 离会原因说明<br>**示例值**："主持人结束会议"

##  资源：参会人会议质量数据

###  字段说明

名称 | 描述
---|---
时间 | 时间点，按分钟统计<br>**示例值**："2022.07.21 11:30:00 (GMT+08:00)"
音频-码率（接收） | 接收端的音频码率<br>**示例值**："50kbps"
音频-延迟（接收） | 接收端的音频延迟<br>**示例值**："5ms"
音频-抖动（接收） | 接收端的音频抖动<br>**示例值**："1ms"
音频-丢包平均（接收） | 接收端的音频丢包平均值<br>**示例值**："2%"
音频-丢包最大（接收） | 接收端的音频丢包最大值<br>**示例值**："5%"
音频-码率（发送） | 发送端的音频码率<br>**示例值**："50kbps"
音频-延迟（发送） | 发送端的音频延迟<br>**示例值**："5ms"
音频-抖动（发送） | 发送端的音频抖动<br>**示例值**："1ms"
音频-丢包平均（发送） | 发送端的音频丢包平均值<br>**示例值**："2%"
音频-丢包最大（发送） | 发送端的音频丢包最大值<br>**示例值**："5%"
视频-码率（接收） | 接收端的视频码率<br>**示例值**："50kbps"
视频-延迟（接收） | 接收端的视频延迟<br>**示例值**："5ms"
视频-抖动（接收） | 接收端的视频抖动<br>**示例值**："1ms"
视频-丢包平均（接收） | 接收端的视频丢包平均值<br>**示例值**："2%"
视频-丢包最大（接收） | 接收端的视频丢包最大值<br>**示例值**："5%"
视频-码率（发送） | 发送端的视频码率<br>**示例值**："50kbps"
视频-延迟（发送） | 发送端的视频延迟<br>**示例值**："5ms"
视频-抖动（发送） | 发送端的视频抖动<br>**示例值**："1ms"
视频-丢包平均（发送） | 发送端的视频丢包平均值<br>**示例值**："2%"
视频-丢包最大（发送） | 发送端的视频丢包最大值<br>**示例值**："5%"
共享屏幕-码率（接收） | 接收端的共享屏幕码率<br>**示例值**："50kbps"
共享屏幕-延迟（接收） | 接收端的共享屏幕延迟<br>**示例值**："5ms"
共享屏幕-抖动（接收） | 接收端的共享屏幕抖动<br>**示例值**："1ms"
共享屏幕-丢包平均（接收） | 接收端的共享屏幕丢包平均值<br>**示例值**："2%"
共享屏幕-丢包最大（接收） | 接收端的共享屏幕丢包最大值<br>**示例值**："5%"
共享屏幕-码率（发送） | 发送端的共享屏幕码率<br>**示例值**："50kbps"
共享屏幕-延迟（发送） | 发送端的共享屏幕延迟<br>**示例值**："5ms"
共享屏幕-抖动（发送） | 发送端的共享屏幕抖动<br>**示例值**："1ms"
共享屏幕-丢包平均（发送） | 发送端的共享屏幕丢包平均值<br>**示例值**："2%"
共享屏幕-丢包最大（发送） | 发送端的共享屏幕丢包最大值<br>**示例值**："5%"
客户端最小 CPU 占用 | 客户端最小 CPU 占用<br>**示例值**："2%"
客户端平均 CPU 占用 | 客户端平均 CPU 占用<br>**示例值**："5%"
客户端最大 CPU 占用 | 客户端最大 CPU 占用<br>**示例值**："10%"
系统最大 CPU 占用 | 系统最大 CPU 占用<br>**示例值**："20%"

##  资源：会议室预定数据

###  字段说明

名称 | 描述
---|---
会议室名称 | 会议室名称<br>**示例值**："测试专用rooms"
会议主题 | 会议主题<br>**示例值**："xx的视频会议"
预定人 | 会议室预定人<br>**示例值**："xx"
预定人所属部门 | 部门名称<br>**示例值**："人事部"
邀请人数 | 邀请参加该会议的人数<br>**示例值**："10"
接受人数 | 接受该会议邀请的人数<br>**示例值**："8"
会议开始时间 | 会议开始时间<br>**示例值**："2022.07.21 11:01:40 (GMT+08:00)"

会议结束时间 | 会议结束时间<br>**示例值**："2022.07.21 12:01:40 (GMT+08:00)"
会议时长 | 会议时长<br>**示例值**："01:00:00"
会议室预定状态 | 会议室预定状态<br>可选值：<br>- 审批中<br>- 预定成功<br>- 已释放（手动释放） <br>- 已释放（会议结束后自动释放）<br>- 已释放（未签到被释放）<br>- 已释放（传感器自动释放）<br>**示例值**："预定成功"
签到设备 | 签到设备<br>可选值：<br>- 签到板<br>- 签到二维码<br>- 控制器<br>- 触屏板<br>- 设备离线，自动签到          <br>**示例值**："签到板"
会议室签到状态 | 会议室签到状态<br>可选值：<br>- 无需签到（即时预定）<br>- 无需签到（未开启签到设置）<br>- 无需签到<br>- 超时未签到<br>- 签到时间未结束<br>- 无需签到（未安装签到设备）<br>- 已签到<br>- 待签到<br>- 不可签到（会议室被禁用）<br>**示例值**："无需签到"
会议室签到时间 | 会议室签到时间<br>**示例值**："2022.07.04 21:00:00 (GMT+08:00)"

释放人 | 释放人<br>**示例值**："xx"
释放时间 | 释放时间<br>**示例值**："2022.07.04 21:00:00 (GMT+08:00)"