该接口用于批量修改指定的通讯录隐藏规则。每条规则必须携带 rule_id。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/contactrule/update?access_token=ACCESS_TOKEN
请求包体:
{
"rules": [
{
"rule_id": 10001,
"range": {
"userid": ["zhangsan", "lisi"],
"partyid": [1, 2],
"tagid": [3]
},
"whitelist": {
"userid": ["wangwu"],
"partyid": [4],
"tagid": []
}
}
]
}
参数说明:
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证。仅通讯录同步应用的 access_token 可调用该接口 |
| rules | 是 | 要修改的规则列表,最多支持 100 条 |
| rules.rule_id | 是 | 规则唯一标识 |
| rules.rule_type | 是 | 规则类型,不能更新规则类型。 1 - 隐藏部门/成员 2 - 限制查看外部门 3 - 限制查看所有人 |
| rules.range | 是 | 规则目标范围,被隐藏或受限的部门、成员、标签 |
| rules.range.userid | 否 | 成员 ID 列表,最多支持 1000 个成员 |
| rules.range.partyid | 否 | 部门 ID 列表,最多支持 100 个部门 |
| rules.range.tagid | 否 | 标签 ID 列表,最多支持 100 个标签 |
| rules.whitelist | 否 | 白名单范围,允许查看的部门、成员、标签 |
| rules.whitelist.userid | 否 | 白名单成员 ID 列表,最多支持 1000 个成员 |
| rules.whitelist.partyid | 否 | 白名单部门 ID 列表,最多支持 100 个部门 |
| rules.whitelist.tagid | 否 | 白名单标签 ID 列表,最多支持 100 个标签 |
| rules.exclude | 否 | 排除名单范围,不受该规则限制的部门、成员、标签。限制查看外部门/所有人时使用 |
| rules.exclude.userid | 否 | 排除名单成员 ID 列表,最多支持 1000 个成员 |
| rules.exclude.partyid | 否 | 排除名单部门 ID 列表,最多支持 100 个部门 |
| rules.exclude.tagid | 否 | 排除名单标签 ID 列表,最多支持 100 个标签 |
| rules.is_allowed_search | 否 | 是否允许搜索。限制查看外部门/所有人时使用 |
| rules.is_allowed_conversation | 否 | 是否允许会话。限制查看外部门/所有人时使用 |
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"rules": [
{
"rule_id": 10001,
"rule_type": 1,
"range": {
"userid": ["zhangsan", "lisi"],
"partyid": [1, 2],
"tagid": [3]
},
"whitelist": {
"userid": ["wangwu"],
"partyid": [4],
"tagid": []
}
}
]
}
返回参数说明:
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
