本文主要介绍企业版/商业版账号如何在会议预定/修改/释放 Rooms 设备，整体流程如下：

![room_all.jpg](https://developer.qcloudimg.com/http-save/yehe-12706950/933f7ff37a002e23478c47334e565417.jpg)

## 一、前提条件

1. **已开通腾讯会议企业版/商业版账号**，并在企业内完成会议室（Rooms）设备的激活与绑定。Rooms 设备状态可通过[查询设备列表](https://cloud.tencent.com/document/product/1095/55312)接口确认（`meeting_room_status` 为 2 表示空闲可用）。
2. **已创建企业自建应用**，获取 `appId`、 `sdkId`、`secretId` 和 `secretKey`。Rooms 相关接口目前暂不支持 OAuth 2.0 鉴权，必须使用 [AK/SK 签名验证方式](https://cloud.tencent.com/document/product/1095/42413)；操作者需具备超级管理员/管理员角色或为会议创建者本人。
3. **会议已预约成功**：本文流程从"会议已创建"开始。会议可通过[创建会议](https://cloud.tencent.com/document/product/1095/42417)接口创建，成功后获得两个关键标识：
   - `meeting_id`：会议唯一 ID（后续所有 Rooms 操作的路径参数）；
   - `meeting_code`：9 位会议号（用户侧可见）。
4. **会议本身满足 Rooms 预定约束**：
   - 会议时长不超过 24 小时
   - 会议类型为普通预约会议，不支持周期性会议
   - 会议未开始、未结束、未取消

## 二、预定会议室 Rooms

对成功预定的会议添加会议室，支持一次预定多个会议室。

| 项目 | 内容 |
| ------ | ------ |
| 官方文档 | [预定会议室](https://cloud.tencent.com/document/product/1095/55313) |
| 接口地址 | `https://api.meeting.qq.com/v1/meetings/{meeting_id}/book-rooms` |
| 请求方式 | POST |
| 操作者权限 | 会议创建者 |

### 2.1 请求参数

| 参数 | 必选 | 类型 | 说明 |
| ------ | ------ | ------ | ------ |
| meeting_id | 是 | String | 会议 ID |
| meeting_room_id_list | 是 | String 数组 | 会议室 ID 列表，可先通过「查询设备列表」接口获取 |
| operator_id | 是 | String | 操作者 ID，与 operator_id_type 配合使用 |
| operator_id_type | 是 | Integer | 操作者 ID 类型，1 表示 userid |
| subject_visible | 否 | Boolean | 会议开始前一小时是否在 Room 上显示会议主题，默认 true |

> **注意**：`meeting_room_id`（会议室 ID）与 `rooms_id`（Rooms 设备 ID）是两个不同维度的标识，请勿混淆。
>
> - `meeting_room_id`：会议室 ID，标识“会议室”这一业务资源，是本文预定/释放会议室所用的 ID（对应 `meeting_room_id_list` 参数）。
> - `rooms_id`：Rooms 设备 ID，标识会议室中部署/绑定的 Rooms 设备（终端），一个会议室下可绑定一个 Rooms 设备。
>
> 预定会议室时请使用 `meeting_room_id`，可通过「查询会议室（Rooms）列表」或「查询设备列表」接口获取。

### 2.2 请求与响应示例

请求示例：

```http
POST https://api.meeting.qq.com/v1/meetings/6524541286408448530/book-rooms
Content-Type: application/json

{
    "operator_id": "KM4Ss4T******1JiK",
    "operator_id_type": 1,
    "meeting_room_id_list": ["100001", "100002"]
}
```

响应示例：

```json
{
    "meeting_room_number": 2,
    "meeting_room_list": [
        {
            "meeting_room_id": "100001",
            "meeting_room_name": "会议室测试1",
            "meeting_room_location": "广州-大厦-10"
        },
        {
            "meeting_room_id": "100002",
            "meeting_room_name": "会议室测试2",
            "meeting_room_location": "西安-广场-19"
        }
    ]
}
```

> **注意**：预定会议室为**覆盖型接口**，每次调用都会以本次传入的 `meeting_room_id_list` 覆盖该会议此前已预定的会议室列表。若需在原有基础上追加会议室，请传入「原有 + 新增」的完整列表。

## 三、查询会议室预定情况

预定或变更 Rooms 前，建议先确认两件事：**会议室是否开放预定**、**目标时段是否已被占用**。这两项分别对应下面两个查询接口。

### 3.1 查询会议室（Rooms）列表

用于获取企业下的会议室 ID 及其可预定状态，是获取 `meeting_room_id` 的推荐入口。

| 项目 | 内容 |
| ------ | ------ |
| 官方文档 | [查询会议室（Rooms）列表](https://cloud.tencent.com/document/product/1095/55309) |
| 接口地址 | `https://api.meeting.qq.com/v1/meeting-rooms` |
| 请求方式 | GET |
| 操作者权限 | 会议创建者 |

#### 3.1.1 请求参数

| 参数 | 必选 | 类型 | 说明 |
| ------ | ------ | ------ | ------ |
| operator_id | 是 | String | 操作者 ID，与 operator_id_type 配合使用 |
| operator_id_type | 是 | Integer | 操作者 ID 类型，1 表示 userid |
| page | 否 | Integer | 页码，从 1 开始，默认 1 |
| page_size | 否 | Integer | 分页大小，最大 50，默认 20 |
| meeting_room_name | 否 | String | 会议室名称，支持模糊匹配 |

#### 3.1.2 请求与响应示例

请求示例：

```http
GET https://api.meeting.qq.com/v1/meeting-rooms?page=1&page_size=2&meeting_room_name=会议室&operator_id=KM4Ss4T******1JiK&operator_id_type=1
```

响应示例：

```json
{
    "total_count": 200,
    "total_page": 100,
    "current_page": 1,
    "current_size": 2,
    "meeting_room_list": [
        {
            "meeting_room_id": "100001",
            "meeting_room_name": "会议室测试1",
            "meeting_room_location": "广州-大厦-10",
            "account_type": 1,
            "active_code": "69MS********2PKC",
            "participant_number": 12,
            "meeting_room_status": 2,
            "scheduled_status": 1,
            "is_allow_call": true,
            "room_type": 0
        }
    ]
}
```

#### 3.1.3 关键字段说明

预定前需重点关注以下两个字段，二者共同决定该会议室能否被预定：

| 字段 | 取值 | 说明 |
| ------ | ------ | ------ |
| scheduled_status | 0：未开放预定；1：开放预定 | 为 0 时调用「预定会议室」会返回错误码 20003（会议室未开放预定） |
| meeting_room_status | 0：未激活；1：未绑定；2：空闲；3：使用中；4：离线 | 设备实时状态，2 表示空闲可用 |
| room_type | 0：Rooms；1、2：MRA | 用于区分 Rooms 设备与 MRA 设备 |

<a id="query-meetings"></a>

### 3.2 查询会议室（Rooms）下的会议列表

用于查询某个会议室在指定时间段内已被预定的会议，是判断目标时段是否被占用的依据；变更会议时间前应先调用该接口，避免因会议室被占用导致修改失败。

| 项目 | 内容 |
| ------ | ------ |
| 官方文档 | [查询会议室（Rooms）下的会议列表](https://cloud.tencent.com/document/product/1095/67435) |
| 接口地址 | `https://api.meeting.qq.com/v1/meeting-rooms/{operator_id}/meetings` |
| 请求方式 | GET |
| 操作者权限 | 会议创建者 |

#### 3.2.1 请求参数

| 参数 | 必选 | 类型 | 说明 |
| ------ | ------ | ------ | ------ |
| operator_id | 是 | String | 操作者 ID，与 operator_id_type 配合使用 |
| operator_id_type | 是 | Integer | 操作者 ID 类型，1 表示 userid |
| instanceid | 是 | Integer | 终端设备类型，服务端调用可填 1（PC）或 5（Web） |
| target_rooms_id | 否 | Integer | 目标查询的会议室 ID 或 Rooms 设备 ID，具体类型由 target_rooms_id_type 决定 |
| target_rooms_id_type | 否 | Integer | 3 表示 rooms 设备的 rooms_id；5 表示会议室 ID（meeting_room_id） |
| start_time | 否 | String | 查询起始时间，Unix 时间戳（秒） |
| end_time | 否 | String | 查询结束时间，Unix 时间戳（秒） |
| page | 否 | Integer | 页码，从 1 开始，默认 1 |
| page_size | 否 | Integer | 分页大小，最大 20，默认 20 |

> `start_time` 与 `end_time` 的查询区间不超过 90 天。

#### 3.2.2 请求与响应示例

请求示例：

```http
GET https://api.meeting.qq.com/v1/meeting-rooms/KM4Ss4T******1JiK/meetings?operator_id_type=1&instanceid=1&target_rooms_id=100001&target_rooms_id_type=5&start_time=1572172200&end_time=1572175800
```

响应示例：

```json
{
    "current_page": 1,
    "current_size": 1,
    "total_count": 1,
    "total_page": 1,
    "meeting_info_list": [
        {
            "meeting_id": "6524541286408448530",
            "meeting_code": "637228110",
            "subject": "周会",
            "status": "MEETING_STATE_INIT",
            "meeting_type": 0,
            "start_time": 1572172200,
            "end_time": 1572175800
        }
    ]
}
```

若返回的 `meeting_info_list` 中存在与目标时段重叠、且 `status` 为 `MEETING_STATE_INIT`（待开始）或 `MEETING_STATE_STARTED`（已开始）的会议，说明该时段会议室已被占用，需改用其他会议室或调整时间。

## 四、修改会议时间/更换会议室

会议已添加 Rooms 后，常见的变更诉求分为两类：修改会议时间、更换会议室 Rooms。两者的处理方式不同，需分别对待。

Rooms 的预定时间本身不可单独操作，它始终跟随所属会议的时间，因此时间变更需通过「修改会议」接口完成。

| 项目 | 内容 |
| ------ | ------ |
| 官方文档 | [修改会议](https://cloud.tencent.com/document/product/1095/42424) |
| 接口地址 | `https://api.meeting.qq.com/v1/meetings/{meetingId}` |
| 请求方式 | PUT |
| 操作者权限 | 会议创建者、企业管理员 |

### 4.1 修改会议时间

修改会议时间的整体流程如下：

![会议时间修改流程图.png](https://developer.qcloudimg.com/http-save/yehe-12706950/78b6b06fbe6221ea42e870af69db62cd.png)

#### 4.1.1 第一步：释放 Rooms

请求示例：

```http
POST https://api.meeting.qq.com/v1/meetings/6524541286408448530/release-rooms
Content-Type: application/json

{
    "operator_id": "KM4Ss4T******1JiK",
    "operator_id_type": 1,
    "meeting_room_id_list": ["100001", "100002"]
}
```

成功返回空对象 `{}`。接口详细参数见 5.1。

#### 4.1.2 第二步：修改会议时间

请求参数（时间修改相关）：

| 参数 | 必选 | 类型 | 说明 |
| ------ | ------ | ------ | ------ |
| meetingId | 是 | String | 会议 ID，路径参数 |
| userid | 是 | String | 会议创建者或企业管理员 ID（OAuth 2.0 场景为 openId） |
| instanceid | 是 | Integer | 终端设备类型，服务端调用可填 1 |
| start_time | 否 | String | 会议开始时间戳（秒），需大于当前时间 |
| end_time | 否 | String | 会议结束时间戳（秒），需大于开始时间 |
| subject | 否 | String | 会议主题，不修改时可不传 |

请求示例：

```http
PUT https://api.meeting.qq.com/v1/meetings/6524541286408448530
Content-Type: application/json

{
    "userid": "zhangsan",
    "instanceid": 1,
    "subject": "周会",
    "start_time": "1572172200",
    "end_time": "1572175800"
}
```

响应示例：

```json
{
    "meeting_number": 1,
    "meeting_info_list": [
        {
            "meeting_id": "6524541286408448530",
            "meeting_code": "637228110"
        }
    ]
}
```

> **注意**：修改会议时间后仍需满足 Rooms 的预定约束，即新的会议时长不得超过 24 小时，且会议未开始、未结束、未取消。

#### 4.1.3 第三、四步：确认空闲并重新预定

确认新时段会议室空闲后，调用「预定会议室」重新预定：

请求示例：

```http
POST https://api.meeting.qq.com/v1/meetings/6524541286408448530/book-rooms
Content-Type: application/json

{
    "operator_id": "KM4Ss4T******1JiK",
    "operator_id_type": 1,
    "meeting_room_id_list": ["100001", "100002"]
}
```

### 4.2 更换会议室 Rooms

「预定会议室」是**覆盖型接口**，因此在会议时间不变的前提下更换会议室，不需要先释放，直接传入更换后的完整会议室列表即可。

以「将会议室 100001、100002 更换为 100003」为例：

请求示例：

```http
POST https://api.meeting.qq.com/v1/meetings/6524541286408448530/book-rooms
Content-Type: application/json

{
    "operator_id": "KM4Ss4T******1JiK",
    "operator_id_type": 1,
    "meeting_room_id_list": ["100003"]
}
```

响应示例：

```json
{
    "meeting_room_number": 1,
    "meeting_room_list": [
        {
            "meeting_room_id": "100003",
            "meeting_room_name": "会议室测试3",
            "meeting_room_location": "深圳-大厦-8"
        }
    ]
}
```

调用成功后，该会议仅保留 100003，原 100001、100002 自动释放。

## 五、取消会议和 Rooms

当会议需要取消时，需严格按照先释放会议室、再取消会议的顺序执行。若先取消会议，「释放会议室」接口会因会议已取消而调用失败，导致会议室资源无法通过接口释放。

### 5.1 第一步：释放会议室

| 项目 | 内容 |
| ------ | ------ |
| 官方文档 | [释放会议室（Rooms）](https://cloud.tencent.com/document/product/1095/55314) |
| 接口地址 | `https://api.meeting.qq.com/v1/meetings/{meeting_id}/release-rooms` |
| 请求方式 | POST |
| 操作者权限 | 会议创建者 |

#### 5.1.1 请求参数

| 参数 | 必选 | 类型 | 说明 |
| ------ | ------ | ------ | ------ |
| meeting_id | 是 | String | 会议 ID，路径参数 |
| meeting_room_id_list | 是 | String 数组 | 待释放的会议室 ID 列表 |
| operator_id | 是 | String | 操作者 ID，与 operator_id_type 配合使用 |
| operator_id_type | 是 | Integer | 操作者 ID 类型，1 表示 userid |

#### 5.1.2 请求与响应示例

请求示例：

```http
POST https://api.meeting.qq.com/v1/meetings/6524541286408448530/release-rooms
Content-Type: application/json

{
    "operator_id": "KM4Ss4T******1JiK",
    "operator_id_type": 1,
    "meeting_room_id_list": ["100001", "100002"]
}
```

响应示例：

```json
{}
```

支持一次释放多个会议室。

> **注意**：「查询会议」接口的响应中不包含会议室（Rooms）字段，无法直接查到某会议已预定哪些会议室。建议在调用「预定会议室」时将响应中的 `meeting_room_list` 记录在业务侧，作为后续释放的依据。

### 5.2 第二步：取消会议

| 项目 | 内容 |
| ------ | ------ |
| 官方文档 | [取消会议](https://cloud.tencent.com/document/product/1095/42422) |
| 接口地址 | `https://api.meeting.qq.com/v1/meetings/{meetingId}/cancel` |
| 请求方式 | POST |
| 操作者权限 | 会议创建者 |

#### 5.2.1 请求参数

| 参数 | 必选 | 类型 | 说明 |
| ------ | ------ | ------ | ------ |
| meetingId | 是 | String | 会议 ID，路径参数 |
| userid | 是 | String | 调用方用户 ID（OAuth 2.0 场景为 openId） |
| instanceid | 是 | Integer | 终端设备类型 |
| reason_code | 是 | Integer | 取消原因代码，可自定义 |
| reason_detail | 否 | String | 详细取消原因描述 |
| meeting_type | 否 | Integer | 默认 0；周期性会议传 1 |
| sub_meeting_id | 否 | String | 仅取消周期会议的单个子会议时传入；不传则取消整个系列 |

#### 5.2.2 请求与响应示例

请求示例：

```http
POST https://api.meeting.qq.com/v1/meetings/6524541286408448530/cancel
Content-Type: application/json

{
    "userid": "zhangsan",
    "instanceid": 1,
    "reason_code": 1,
    "reason_detail": "会议取消"
}
```

取消成功返回空消息体。

本文主要介绍企业版/商业版账号如何在会议预定/修改/释放 Rooms 设备，整体流程如下：

使用腾讯会议 REST API 管理会议 Rooms

本文主要介绍企业版/商业版账号如何在会议预定/修改/释放 Rooms 设备。

CSIG技术支持

开发工具

网络与通信

后端

企业版/商业版腾讯会议账号可通过API预定、修改和释放Rooms会议室设备。操作需使用AK/SK签名验证，支持批量预定会议室、查询设备状态、修改会议时间或更换会议室。预定会议室为覆盖型接口，取消会议前必须先释放会议室资源，变更时间时需按"释放-修改-重新预定"流程操作。

腾讯会议

代码解释

OAuth

JSON

Unix

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

使用腾讯会议 REST API 管理会议 Rooms-腾讯云开发者社区-腾讯云

使用腾讯会议 REST API 管理会议 Rooms

使用腾讯会议 REST API 管理会议 Rooms

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐