# 资源介绍

用户可以进行查询会议室层级、创建会议室层级、更新会议室层级等操作

## 方法
**注意事项**：对应原固定层级会议室API如下：<br>
  * [获取会议室列表](https://open.feishu.cn/document/ukTMukTMukTM/uADOyUjLwgjM14CM4ITN)<br>
  * [查询会议室详情](https://open.feishu.cn/document/ukTMukTMukTM/uEDOyUjLxgjM14SM4ITN)
  * [创建会议室](https://open.feishu.cn/document/ukTMukTMukTM/uITNwYjLyUDM24iM1AjN)
  * [更新会议室](https://open.feishu.cn/document/ukTMukTMukTM/uMTNwYjLzUDM24yM1AjN)
  * [删除会议室](https://open.feishu.cn/document/ukTMukTMukTM/uUzMxYjL1MTM24SNzEjN)
  若租户已切换至会议室灵活层级，调用固定层级接口时将会采用兼容逻辑，可能导致体验降级。建议使用灵活层级接口

**[查询会议室列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/list)**

&emsp;&emsp;该接口可以用来查询某个会议室层级下会议室列表

**[查询会议室详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/get)**

&emsp;&emsp;该接口可以使用会议室ID查询会议室详情

**[批量查询会议室详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/mget)**

&emsp;&emsp;该接口可以使用会议室ID批量查询会议室详情

**[创建会议室](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/create)**

&emsp;&emsp;该接口用于创建会议室

**[更新会议室](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/patch)**

&emsp;&emsp;该接口可以用来更新某个会议室的信息

**[删除会议室](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/delete)**

&emsp;&emsp;该接口可以用来删除某个会议室

**[搜索会议室](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/search)**

&emsp;&emsp;该接口可以用来搜索会议室，支持使用关键词进行搜索，也支持使用自定义会议室ID进行查询

## 事件
**注意事项**：对应原非多层级会议室事件如下：<br>
  * [会议室创建](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/meeting_room-v1/meeting_room/events/created)
  * [会议室属性变更](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/meeting_room-v1/meeting_room/events/updated)
  * [会议室删除](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/meeting_room-v1/meeting_room/events/deleted)

**[创建会议室](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/events/created)**

&emsp;&emsp;当创建会议室时，会触发该事件

**[更新会议室](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/events/updated)**

&emsp;&emsp;当更新会议室时，会触发该事件

**[删除会议室](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/events/deleted)**

&emsp;&emsp;当删除会议室时，会触发该事件

## 字段说明

名称 | 类型 | 必填 | 描述
---|---|---|---
room_id | string | 是 | 会议室ID<br>**示例值**："omm_4de32cf10a4358788ff4e09e37ebbf9b"
name | string | 是 | 会议室名称<br>**示例值**："测试会议室"
capacity | int | 是 | 会议室能容纳的人数<br>**示例值**：10
description | string | 否 | 会议室的相关描述<br>**示例值**："测试会议室描述"
custom_room_id | string | 否 | 自定义的会议室ID<br>**示例值**："1234"
room_level_id | string | 是 | 层级ID<br>**示例值**："omb_4ad1a2c7a2fbc5fc9570f38456931293"<br>层级信息可以参考：[会议室层级概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/room-level-overview)
path | string\[\] | 是 | 层级路径<br>**示例值**：["omb_4ad1a2c7a2fbc5fc9570f38456931293"]
room_status | room_status | 否 | 会议室状态
status | boolean | 是 | 是否启用会议室<br>**示例值**：true
schedule_status | boolean | 否 | 会议室未来状态为启用或禁用<br>**示例值**：true
disable_start_time | string | 否 | 禁用开始时间（unix时间，单位sec）<br>**示例值**："1652356050"
disable_end_time | string | 否 | 禁用结束时间（unix时间，单位sec，数值0表示永久禁用）<br>**示例值**："1652442450"
disable_reason | string | 否 | 禁用原因<br>**示例值**："测试占用"
contact_ids | string\[\] | 否 | 联系人列表，id类型由user_id_type参数决定<br>**示例值**：["ou_3ec3f6a28a0d08c45d895276e8e5e19b"]
disable_notice | boolean | 否 | 是否在禁用时发送通知给预定了该会议室的员工<br>**示例值**：true
resume_notice | boolean | 否 | 是否在恢复启用时发送通知给预定了该会议室的员工<br>**示例值**：true
device | device\[\] | 否 | 设施信息列表
name | string | 是 | 设施名称<br>**示例值**：电话

## 数据示例
```json
{
  	"room_id": "omm_4de32cf10a4358788ff4e09e37ebbf9b",
    "name": "测试会议室",
    "capacity": 10,
    "description": "测试会议室描述",
    "custom_room_id": "1234",
    "room_level_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293",
  	"path": [
  		"omb_4ad1a2c7a2fbc5fc9570f38456931293"
  	],
    "room_status": {
        "status": true,
        "schedule_status": true,
        "disable_start_time": "1652356050",
        "disable_end_time": "1652442450",
        "disable_reason": "测试占用",
        "contact_ids": [
            "ou_3ec3f6a28a0d08c45d895276e8e5e19b"
        ],
        "disable_notice": true,
        "resume_notice": true
    },
  	"device": [
  		{
  			"name": "电话"
  		}
  	]
}
```
