修改子频道
修改某个子频道的信息。
使用示例
token := token.BotToken("appid", "token")
api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
ctx := context.Background()
channel, err := api.PatchChannel(ctx, channelId, &dto.ChannelValueObject{
Name: "新子频道名",
Type: dto.ChannelTypeText,
SubType: dto.ChannelSubTypeChat,
})
if err != nil {
log.Fatalln("调用 PatchChannel 接口失败, err = ", err)
}
::: warning 注意
- 要求操作人具有管理子频道的权限,如果是机器人,则需要将机器人设置为管理员。
- 修改成功后,会触发子频道更新事件
:::
参数说明
ChannelValueObject
字段名 |
类型 |
必填 |
描述 |
Name |
string |
是 |
子频道名 |
Type |
int |
是 |
子频道类型 ChannelType |
SubType |
int |
是 |
子频道子类型 ChannelSubType |
Position |
int64 |
否 |
排序,必填,而且不能够和其他子频道的值重复 |
ParentID |
string |
否 |
分组 ID |
ChannelType
值 |
描述 |
0 |
文字子频道 |
1 |
保留,不可用 |
2 |
语音子频道 |
3 |
保留,不可用 |
4 |
子频道分组 |
10005 |
直播子频道 |
10006 |
应用子频道 |
10007 |
论坛子频道 |
注:由于 QQ 频道还在持续的迭代中,经常会有新的子频道类型增加,文档更新不一定及时,开发者识别 ChannelType
时,请注意相关的未知 ID 的处理。
返回说明
字段参见 Channel。
Channel
字段名 |
类型 |
描述 |
ID |
string |
子频道id |
GuildID |
string |
频道id |
Name |
string |
子频道名 |
Type |
int |
子频道类型 ChannelType |
SubType |
int |
子频道子类型 ChannelSubType |
Position |
int64 |
排序,必填,而且不能够和其他子频道的值重复 |
ParentID |
string |
分组 id |
OwnerID |
string |
创建人 id |
PrivateType |
int |
子频道的可见类型 ChannelPrivateType |
SpeakPermission |
int |
子频道发言权限 SpeakPermissionType |
ApplicationID |
string |
应用子频道的应用ID,仅应用子频道有效 |
Permissions |
string |
用户拥有的子频道权限 |
ChannelSubType
SpeakPermissionType
ChannelPrivateType
值 |
描述 |
0 |
公开频道 |
1 |
群主管理员可见 |
2 |
群主管理员 + 指定成员 |
返回示例
data
:
{
"id": "2186875",
"guild_id": "2020131797974366736",
"name": "update_channel",
"type": 0,
"position": 22,
"parent_id": "1128421",
"owner_id": null,
"sub_type": 0
}