qq.getGuildRoles(String guildOpenID)

# qq.getGuildRoles(String guildOpenID)

本接口用于获取当前用户在频道内的身份组信息。身份组是 QQ 频道支持的特色功能，频道主可根据频道成员不同的属性分配不同的身份组，进而提升管理效率，实现分类展示子频道等功能。小程序开发商可以利用身份组信息区分用户，实现更多元地用户分组玩法。

QQ mac版本：暂不支持

QQ windows版本：暂不支持

# 参数

# String guildOpenId

属性	类型	默认值	必填	说明
guildOpenID	string	-	是	guildOpenID 获取，可查看【创建、删除回调】，在创建/删除回调请求体中，可以获得 open_guild_id
success	string	function	否	成功的回调
fail	string	function	否	失败的回调

# 使用示例

qq.getGuildRoles({
  guildOpenID: 'xxxxxx',
  success(res) {
    console.log('success:', res)
  },
  fail(err) {
    console.log('fail:', err)
  },
})

1
2
3
4
5
6
7
8
9

# 返回说明

返回一个对象，包含以下参数

属性	类型	说明
roleList	Array<RoleObj>	返回身份组对象数组

# RoleObj

属性	类型	说明
roleName	string	身份组名称
roleID	string	身份组 ID
color	number	ARGB 的 HEX 十六进制颜色值转换后的十进制数值

针对这部分参数不理解的请移步机器人文档。

# 返回示例

{
  "errMsg": "getGuildRoles:ok",
  "roleList": [
    {
      "roleName": "金牌管理员",
      "roleID": "10044271",
      "color": 4278245297
    }
  ]
}

1
2
3
4
5
6
7
8
9
10

← qq.getGroupAppStatus