# 修改子频道

# 接口

PATCH /channels/{channel_id}
1

# 功能描述

用于修改 channel_id 指定的子频道的信息。

  • 要求操作人具有管理子频道的权限,如果是机器人,则需要将机器人设置为管理员。
  • 修改成功后,会触发子频道更新事件

注意

  • 公域机器人暂不支持申请,仅私域机器人可用,选择私域机器人后默认开通。
  • 注意: 开通后需要先将机器人从频道移除,然后重新添加,方可生效。

# Content-Type

application/json
1

# 参数

字段名 类型 描述
name string 子频道名
position int 排序
parent_id string 分组 id
private_type int 子频道私密类型 PrivateType
speak_permission int 子频道发言权限 SpeakPermission

需要修改哪个字段,就传递哪个字段即可。

# 返回

返回Channel 对象。

# 错误码

详见错误码

# 示例

请求数据包

{
  "name": "新的私密子频道",
  "position": 1,
  "owner_id": "0",
  "sub_type": 0,
  "private_type": 1
}
1
2
3
4
5
6
7

响应数据包

{
  "id": "xxxxxx",
  "guild_id": "xxxxxx",
  "name": "私密子频道a",
  "type": 10006,
  "position": 2,
  "parent_id": "xxxxxx",
  "owner_id": "xxxxxx",
  "sub_type": 0,
  "private_type": 1
}
1
2
3
4
5
6
7
8
9
10
11
手机QQ扫码
开发者社区
加入官方频道开发者社区