原公众号文档（包含订阅号与服务号）已升级为公众号（原订阅号）与服务号文档。公众号文档请直接参考本目录内容，服务号文档请点击此处前往。

# 用户管理

# UnionID 机制说明

在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。公众号可通过获取用户基本信息来根据OpenID获取用户基本信息，包括语言和关注时间。

请注意，如果开发者有在多个公众号，或在公众号、移动应用、小程序、小店、带货助手、网站应用之间统一用户账号的需求，需要前往微信开放平台（open.weixin.qq.com）绑定公众号后，才可利用 UnionID 机制来满足上述需求。

用户身份标记有两种，openid 和 unionid

openid 是微信用户对于一个应用（公众号）的身份标记，同一个微信用户对不同应用（公众号）有不同的 openid

unionid 是微信用户对于一个开放平台的身份标记。如果开发者拥有多个移动应用、网站应用和小程序、小店、带货助手等，可通过获取用户基本信息中的unionid来区分用户的唯一性，因为只要是同一个微信开放平台账号下的移动应用、网站应用和小程序、小店、带货助手，用户的 unionid 是唯一的。

速记公式：

微信用户 + 公众号 AppID = openid
微信用户 + 开放平台账号 = unionid

即，只要公众号 AppID 不变化，openid 不会变。只要公众号绑定的开放平台账号不变，unionid 也不会变。

请注意：

20年6月8日起，用户关注来源“微信广告（ADD_SCENE_WECHAT_ADVERTISEMENT）”从“其他（ADD_SCENE_OTHERS）”中拆分给出，2021年12月27日之后，不再输出头像、昵称信息。

接口列表：

1.获取用户基本信息：点此查看接口文档

2.批量获取用户基本信息:点此查看接口文档

接口名称	请求路径	描述
获取标签下粉丝列表	/cgi-bin/user/tag/get	本接口用于获取标签下粉丝列表
获取标签	/cgi-bin/tags/get	本接口用于获取公众号已创建的标签列表
创建标签	/cgi-bin/tags/create	本接口用于创建公众号标签
编辑标签	/cgi-bin/tags/update	本接口用于修改已存在的标签信息
删除标签	/cgi-bin/tags/delete	本接口用于删除已存在的标签信息
批量为用户取消标签	/cgi-bin/tags/members/batchuntagging	本接口用于批量为多个用户取消标签
批量为用户打标签	/cgi-bin/tags/members/batchtagging	本接口用于批量为多个用户打标签
获取用户的标签列表	/cgi-bin/tags/getidlist	本接口用于获取粉丝用户的标签列表

接口名称	请求路径	描述
取消拉黑用户	/cgi-bin/tags/members/batchunblacklist	本接口用来取消拉黑一批用户，黑名单列表由一串OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成
获取公众号的黑名单列表	/cgi-bin/tags/members/getblacklist	本接口用来获取账号的黑名单列表，黑名单列表由一串 OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成
获取用户基本信息	/cgi-bin/user/info	在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的
批量获取用户基本信息	/cgi-bin/user/info/batchget	本接口用于批量获取用户基本信息
获取关注用户列表	/cgi-bin/user/get	本接口用来获取账号的关注者列表，关注者列表由一串OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成
拉黑用户	/cgi-bin/tags/members/batchblacklist	本接口用于拉黑一批用户，黑名单列表由一串 OpenID （加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成
设置用户备注名	/cgi-bin/user/info/updateremark	本接口用于对指定用户设置备注名，该接口暂时开放给微信认证的服务号

接口名称	请求路径	描述
转换openid	/cgi-bin/changeopenid	该接口用于公众号、服务号之后进行 openid 转换