创建群组
POST
/im/v2/teams请求参数
群主(创建者)云信账号 ID。
群组类型。1:高级群;2:超大群。
群组名称,长度上限 64 位字符。
群组头像的 URL 地址,例如 "https://netease/xxx.png" ,长度上限 1024 位字符。
群组公告,长度上限 1024 位字符。
群组简介,长度上限 512 位字符。
群组成员数上限(包含群主),默认为 200。可设置范围的为:[2 ~ 200]。 若需要扩展群容量,请前往云信控制台配置。配置好后,该参数颗设置的范围为:[2 ~ 控制台设置的群人数上限]。
自定义群组扩展字段,第三方可以跟据此属性自定义扩展自己的群属性,建议封装成 JSONObject 格式,{key:value}。长度上限 1024 位字符
创建群组时邀请入群的成员列表。 单个元素为成员的云信账号 ID。 无需添加群主(owner_account_id),群主(创建者)默认入群。 群成员(包括群主)总数不超过 members_limit。
邀请入群的附言,长度上限 150 位字符。
自定义扩展字段,即自定义的通知字段,JSON 格式,不会持久化。长度上限 512 位字符。 该字段仅针对高级群,对超大群无效。
通过 SDK 侧操作申请入群的验证方式。 0(默认):无需验证,直接入群。 1:需要群主或管理员验证通过才能入群。 2:不允许任何人申请入群。
邀请入群时是否需要被邀请人的同意。 0(默认):需要被邀请人同意才能入群。 1:不需要被邀请人同意,直接入群。
邀请权限,即谁可以邀请他人入群。 0(默认):群主和管理员。 1:所有人。
客户端修改群组信息的权限,即谁可以修改群组信息。 0(默认):群主和管理员。 1:所有人。
客户端修改群自定义扩展信息(server_extension&extension)权限,即谁可以修改群自定义扩展信息。 0(默认):群主和管理员。 1:所有人。
安全通业务 ID,可以指定当前群组信息过安全通某个检测策略。JSON 字符串,例如 {"textbid":"","picbid":""}。 默认情况下云信控制后台会生成默认业务,开通安全通后,客户端不需要配置业务 ID 就能默认走该策略,若需要自定义检测策略,请联系技术支持进行配置,配置好后传入对应的安全通业务 ID,表示当前群组信息过安全通的指定检测策略。
{
"owner_account_id": "accid1",
"team_type": 1,
"name": "车快他队果争",
"icon": "http://dummyimage.com/100x100",
"announcement": "occaecat Ut",
"intro": "cupidatat sed enim velit",
"members_limit": 1,
"server_extension": "in consequat sunt irure",
"extension": "amet dolore magna",
"invite_account_ids": [
"81"
],
"invite_msg": "magna dolore dolor Excepteur do",
"configuration": {
"join_mode": 1,
"agree_mode": 0,
"invite_mode": 0,
"update_team_info_mode": 1,
"update_extension_mode": 1,
"antispam_business_id": " "
}
}
示例代码
返回响应
拉入群组失败的云信账号信息列表。
创建成功的群组信息。