Name
QQ::weixin::work::tag
DESCRIPTION
通讯录管理->标签管理
FUNCTION
create(access_token, hash);
创建标签 最后更新：2020/06/08
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/90210
请求说明：
请求包结构体为：
{
"tagname": "UI",
"tagid": 12
}参数说明：
参数 必须 说明
access_token 是 调用接口凭证
tagname 是 标签名称，长度限制为32个字以内（汉字或英文字母），标签名不可与其他标签重名。
tagid 否 标签id，非负整型，指定此参数时新增的标签会生成对应的标签id，不指定时则以目前最大的id自增。权限说明
创建的标签属于该应用，只有该应用才可以增删成员。
注意，标签总数不能超过3000个。
RETURN 返回结果
{
"errcode": 0,
"errmsg": "created",
"tagid": 12
}RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
tagid 标签idupdate(access_token, hash);
更新标签名字 最后更新：2020/04/02
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/90211
请求说明：
请求包结构体为：
{
"tagid": 12,
"tagname": "UI design"
}参数说明：
参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID
tagname 是 标签名称，长度限制为32个字（汉字或英文字母），标签不可与其他标签重名。权限说明
调用者必须是指定标签的创建者。
RETURN 返回结果
{
"errcode": 0,
"errmsg": "updated"
}RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容delete(access_token, tagid);
删除标签 最后更新：2020/04/02
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/90212
请求说明：
参数说明：
参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID权限说明
调用者必须是指定标签的创建者。
RETURN 返回结果
{
"errcode": 0,
"errmsg": "deleted"
}RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容get(access_token, tagid);
获取标签成员 最后更新：2021/08/11
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/90213
请求说明：
参数说明：
参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID权限说明：
无限制，但返回列表仅包含应用可见范围的成员；第三方可获取自己创建的标签及应用可见范围内的标签详情
RETURN 返回结果
{
"errcode": 0,
"errmsg": "ok",
"tagname": "乒乓球协会",
"userlist": [
{
"userid": "zhangsan",
"name": "李四"
}
],
"partylist": [2]
}RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
tagname 标签名
userlist 标签中包含的成员列表
userid 成员帐号
name 成员名称，代开发自建应用需要管理员授权才返回该字段；此字段从2019年12月30日起，对新创建第三方应用不再返回，2020年6月30日起，对所有历史第三方应用不再返回，后续第三方仅通讯录应用可获取，第三方页面需要通过通讯录展示组件来展示名字
partylist 标签中包含的部门id列表addtagusers(access_token, hash);
增加标签成员 最后更新：2020/12/07
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/90214
请求说明：
请求包结构体为：
{
"tagid": 12,
"userlist":[ "user1","user2"],
"partylist": [4]
}参数说明：
参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID
userlist 否 企业成员ID列表，注意：userlist、partylist不能同时为空，单次请求长度不超过1000
partylist 否 企业部门ID列表，注意：userlist、partylist不能同时为空，单次请求长度不超过100权限说明：
调用者必须是指定标签的创建者；成员属于应用的可见范围。
注意，每个标签下部门、人员总数不能超过3万个。
RETURN 返回结果
a)正确时返回
{
"errcode": 0,
"errmsg": "ok"
}
b)若部分userid、partylist非法，则返回
{
"errcode": 0,
"errmsg": "ok",
"invalidlist"："usr1|usr2|usr",
"invalidparty"：[2,4]
}
c)当包含userid、partylist全部非法时返回
{
"errcode": 40070,
"errmsg": "all list invalid"
}RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
invalidlist 非法的成员帐号列表
invalidparty 非法的部门id列表deltagusers(access_token, hash);
删除标签成员 最后更新：2020/04/02
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/90215
请求说明：
请求包结构体为：
{
"tagid": 12,
"userlist":[ "user1","user2"],
"partylist": [2,4]
}参数说明：
参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID
userlist 否 企业成员ID列表，注意：userlist、partylist不能同时为空，单次请求长度不超过1000
partylist 否 企业部门ID列表，注意：userlist、partylist不能同时为空，单次请求长度不超过100权限说明：
调用者必须是指定标签的创建者；成员属于应用的可见范围。RETURN 返回结果
a)正确时返回
{
"errcode": 0,
"errmsg": "deleted"
}
b)若部分userid、partylist非法，则返回
{
"errcode": 0,
"errmsg": "deleted",
"invalidlist"："usr1|usr2|usr",
"invalidparty"：[2,4]
}
c)当包含userid、partylist全部非法时返回
{
"errcode": 40031,
"errmsg": "all list invalid"
}RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
invalidlist 非法的成员帐号列表
invalidparty 非法的部门id列表list(access_token);
获取标签列表 最后更新：2018/03/13
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/90216
请求说明：
参数说明：
参数 必须 说明
access_token 是 调用接口凭证权限说明：
自建应用或通讯同步助手可以获取所有标签列表；第三方应用仅可获取自己创建的标签。
RETURN 返回结果
{
"errcode": 0,
"errmsg": "ok",
"taglist":[
{"tagid":1,"tagname":"a"},
{"tagid":2,"tagname":"b"}
]
}