基础 qianmi.qmcs.group.add(为已开通用户添加用户分组)

为已开通用户添加用户分组,每个应用最多可建50个自定义分组,每组用户数不限,某个授权用户只能存在某一个分组下,新的分组建立会导致旧的分组失效
 用户授权类型
不需要授权
 公共参数
请求地址:
环境 HTTP请求地址 HTTPS请求地址
正式环境 http://gw.api.qianmi.com/api https://api.qianmi.com/api
系统级请求参数:
名称 类型 是否必须 描述
methodString 必须 API接口名称
access_tokenString 可选 用户登录授权以后,QMOP颁发给应用的授权信息,详细介绍请点击这里,当前API的用户授权类型标明:"需要授权",则此参数必传,"不需要授权",则此参数不需要传。
formatString 必须 指定响应格式,目前支持格式为json
appKeyString 必须 分配给应用的AppKey
vString 必须 API协议版本,当前可选值:1.1
signString 必须 API输入参数签名结果
timestampString 必须 请求时间戳,时区为GMT+8(北京时间),格式:"yyyy-MM-dd HH:mm:ss",例如"2012-12-20 10:20:35",开放平台允许客户端请求的最大时间误差为10分钟
 业务参数
名称 类型 是否必须 示例值 默认值 描述
group_nameString 必须 vip 自定义分组名称,每个应用最多可建50个自定义分组,同一个应用下需要保证自定义分组名称的唯一性,最长32个字符。添加分组后,消息通道会为用户的消息分配独立分组,但之前的消息还是存储于默认分组中。
自定义分组名称不能是default或以default开头。
user_idsString 必须 A854800,A854801 用户编号列表,以半角逗号分隔
 请求示例
OpenClient client = new DefaultOpenClient(url, appKey, appSecret);
QmcsGroupAddRequest req = new QmcsGroupAddRequest();
req.setGroupName("group_name");
req.setUserIds("admin_ids");
QmcsGroupAddResponse response = client.execute(req, accessToken);
$client = new OpenClient;
$client->appKey = appKey;
$client->appSecret = appSecret;
$req = new QmcsGroupAddRequest;
$req->setGroupName("group_name");
$req->setUserIds("admin_ids");
$res = $client->execute($req, $accessToken);
IOpenClient client = new DefaultOpenClient(url, appKey, appSecret);
QmcsGroupAddRequest req = new QmcsGroupAddRequest();
req.GroupName = "group_name";
req.UserIds = "admin_ids";
QmcsGroupAddResponse response = client.Execute(req, accessToken);
 响应参数
名称 类型 示例值 描述
group_name String 分组名称
created String 创建时间
 响应示例

JSON数据格式:

 异常示例

JSON数据格式:

 {
    "errorToken": "@@$-ERROR_TOKEN$-@@",
    "code": "33",
    "message": "非法的参数",
    "solution": "请查看根据服务接口对参数格式的要求",
    "subErrors": {
      "subError": [{
          "code": "isv.invalid-paramete:XXXX",
          "message": "参数XXXX无效,格式不对、非法值、越界等"
        }]
  }
 错误码
错误码 错误描述 解决方案
isv.qianmi-qmcs-group-add-service-error:01074001分组名称不能以default开头请更换分组名称
isv.qianmi-qmcs-group-add-service-error:01074004分组数量超出上限请使用现有分组,或删除删除某个现有分组后添加新的分组
isv.qianmi-qmcs-group-add-service-error:01074005无效的用户编号请检查用户编号
 FAQ
Q:为什么E生活部分应用的用户获取不到消息?
A:目前普遍E生活应用 有很多用户存在共用一个appkey的情况,针对这种情况,在消费消息的时候存在一个用户的消息被其他用户获取的情况,建议添加用户分组,用户分组名称建议用自身直销商A编号作为分组名称。