# 获取子频道列表
get_channels
获取子频道列表
# 使用示例
token := token.BotToken("appid", "token")
api := botgo.NewOpenAPI(token).WithTimeout(3 * time.Second)
ctx := context.Background()
channels, channelsError := api.Channels(ctx, guildId)
if channelsError != nil {
log.Fatalln("调用 Channels, err = ", channelsError)
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 参数说明
字段名 | 必填 | 类型 | 描述 |
---|---|---|---|
guildId | 是 | string | 频道 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 | 用户拥有的子频道权限 |
# ChannelType
值 | 描述 |
---|---|
0 | 文字子频道 |
1 | 保留,不可用 |
2 | 语音子频道 |
3 | 保留,不可用 |
4 | 子频道分组 |
10005 | 直播子频道 |
10006 | 应用子频道 |
10007 | 论坛子频道 |
注:由于 QQ 频道还在持续的迭代中,经常会有新的子频道类型增加,文档更新不一定及时,开发者识别 ChannelType
时,请注意相关的未知 ID 的处理。
# ChannelSubType
值 | 描述 |
---|---|
0 | 闲聊 |
1 | 公告 |
2 | 攻略 |
3 | 开黑 |
# SpeakPermissionType
值 | 描述 |
---|---|
0 | 公开发言权限 |
1 | 指定成员可发言 |
# ChannelPrivateType
值 | 描述 |
---|---|
0 | 公开频道 |
1 | 群主管理员可见 |
2 | 群主管理员 + 指定成员 |
# 返回示例
data
:
[
{
"id":"channel_id",
"guild_id":"guild_id",
"name":"子频道名",
"type":4,
"position":2,
"parent_id":"0",
"owner_id":"0",
"sub_type":0
},
{
"id":"channel_id",
"guild_id":"guild_id",
"name":"子频道名",
"type":4,
"position":3,
"parent_id":"0",
"owner_id":"0",
"sub_type":0
}
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22