基础库 2.70.0 开始支持本方法，这是一个异步方法。

查询用户通过小游戏平台创建的群的信息如游戏开发者在平台创建了群聊 ABC，那么游戏侧可以基于游戏开发者在这个游戏中的 openid，查询其在小游戏平台创建了哪些群，群的状态如何，做游戏内的加群逻辑优化

前提条件	无
业务背景	无
使用限制	目前仅支持抖音，可以使用 getSystemInfoSync 判断宿主
注意事项	查询到的群列表只局限在通过游戏创建的群聊或开发者在平台创建的群聊，其他渠道创建的群聊不会返回
相关教程	无

语法

tt.checkGroupInfo(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
extraInfo	string	否	预留字段	2.70.0
openid	string	是	建群用户的 openid。通过 tt.login 接口获取到登录凭证后，开发者可以通过服务器发送请求的方式获取 openid。详情参考 code2Session	2.70.0
sessionFrom	string	否	预留字段	2.70.0
success	function	否	接口调用成功的回调函数	2.70.0
fail	function	否	接口调用失败的回调函数	2.70.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	2.70.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
data	object	查询返回的数据	2.70.0
errMsg	string	"checkGroupInfo:ok"	2.70.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
groupInfoList	Array<object>	群聊列表信息	2.70.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
group_id	string	群 ID	2.70.0
group_name	string	群名	2.70.0
exist_num	number	群现有人数	2.70.0
max_num	number	群最大支持进入人数	2.70.0
description	number	群描述	2.70.0
entry_limit	Array<string>	群门槛，如“无要求”、“万粉”等	2.70.0
status	string	群状态，正常: Normal, 封禁: Ban, 已满: Full	2.70.0
tags	Array<string>	群标签，如活跃群，群主近期发言	2.70.0
avatar_uri	string	群头像	2.70.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"checkGroupInfo:fail" + 详细错误信息	2.70.0

errorCode	errMsg	errorType	说明	最低支持版本
110501	user not authorized to app	U		2.70.0
110502	service unavailable	F	小游戏框架内部错误，有需要请创建工单咨询	2.70.0
999991	internal error	F	小游戏框架内部错误，有需要请创建工单咨询	2.70.0
999993	internal error	F	小游戏框架内部错误，有需要请创建工单咨询	2.70.0
999999	invalid param	D	参数错误	2.70.0
999987	feature is not supported in app	D		2.70.0
999999	openid is nil.	D		2.70.0
999997	user login failed	U		2.70.0
110503	The user has not completed real-name authentication in app	U		2.70.0
999986	auth alert view is showing..	D		2.70.0

tt.checkGroupInfo({
  openid: "openid",
  success(res) {
    console.log(res);
  },
  fail(res) {
    console.log(res);
  },
});