# 用户管理

## UnionID 机制说明

在关注者与服务号产生消息交互后，服务号可获得关注者的OpenID（加密后的微信号，每个用户对每个服务号的OpenID是唯一的。对于不同服务号，同一用户的openid不同）。服务号可通过[获取用户基本信息](/doc/service/api/usermanage/userinfo/api_userinfo.md)来根据OpenID获取用户基本信息，包括语言和关注时间。

请注意，如果开发者有在多个服务号，或在服务号、移动应用、小程序、小店、带货助手、网站应用之间统一用户账号的需求，需要前往微信开放平台（[open.weixin.qq.com](https://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.获取用户基本信息：[点此查看接口文档](/doc/service/api/usermanage/userinfo/api_userinfo.md)

2.批量获取用户基本信息:[点此查看接口文档](/doc/service/api/usermanage/userinfo/api_batchuserinfo.md)

## 接口列表

### 标签管理

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [获取标签下粉丝列表](/doc/service/api/usermanage/tag/api_gettagfans.md) | /cgi-bin/user/tag/get | 本接口用于获取标签下粉丝列表 |
| [获取标签](/doc/service/api/usermanage/tag/api_gettags.md) | /cgi-bin/tags/get | 本接口用于获取公众号已创建的标签列表 |
| [创建标签](/doc/service/api/usermanage/tag/api_createtag.md) | /cgi-bin/tags/create | 本接口用于创建公众号标签 |
| [编辑标签](/doc/service/api/usermanage/tag/api_updatetag.md) | /cgi-bin/tags/update | 本接口用于修改已存在的标签信息 |
| [删除标签](/doc/service/api/usermanage/tag/api_deletetag.md) | /cgi-bin/tags/delete | 本接口用于删除已存在的标签信息 |
| [批量为用户取消标签](/doc/service/api/usermanage/tag/api_batchuntagging.md) | /cgi-bin/tags/members/batchuntagging | 本接口用于批量为多个用户取消标签 |
| [批量为用户打标签](/doc/service/api/usermanage/tag/api_batchtagging.md) | /cgi-bin/tags/members/batchtagging | 本接口用于批量为多个用户打标签 |
| [获取用户的标签列表](/doc/service/api/usermanage/tag/api_gettagidlist.md) | /cgi-bin/tags/getidlist | 本接口用于获取粉丝用户的标签列表 |

### 用户信息

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