## 用户标签

### Tag.set(tag){#set}

为应用中的用户添加标签，如果某用户已经添加了标签，再次对用户添加标签时将覆盖之前设置的标签内容。此功能 Java SDK 3.0.4 版本开始支持，Node.js SDK 3.0.1 版本开始支持。

`tag` 参数的**属性说明**：

| 参数   	 |	类型		| 必填	| 说明 							|
| :----------|:--------	|:-----	|:------------------------------|
|	userId		 |	string	|	是 	| 用户 Id。	|
|	tags	 |	array	|	是 	| 用户标签列表，一个用户最多添加 20 个标签，每个 tag 最大不能超过 40 个字节，标签中不能包含特殊字符。	|

##### 请求成功

```json
{
    "code": 200
}
```

### Tag.batchset(tag){#batchset}

批量添加用户标签，此功能 Java SDK 3.0.4 版本开始支持，Node.js SDK 3.0.1 版本开始支持。

`tag` 参数的**属性说明**：

| 参数   	 |	类型		| 必填	| 说明 							|
| :----------|:--------	|:-----	|:------------------------------|
|	userIds		 |	array	|	是 	| 用户 Id 列表，一次最多支持 1000 个用户。	|
|	tags	 |	array	|	是 	| 用户标签列表，一个用户最多添加 20 个标签，每个 tag 最大不能超过 40 个字节，标签中不能包含特殊字符。	|

##### 请求成功

```json
{
    "code": 200
}
```

### Tag.get(user){#get}

获取用户标签信息，此功能 Java SDK 3.0.4 版本开始支持，Node.js SDK 3.0.1 版本开始支持。

`user` 参数的**属性说明**：

| 参数   	 |	类型		| 必填	| 说明 							|
| :----------|:--------	|:-----	|:------------------------------|
|	userIds		 |	array	|	是 	| 用户 Id 列表，一次最多支持 50 个用户。	|

##### 请求成功

`JSON 格式：`

```
{
   "code": 200,
   "result": {
       "111": [],
       "222": [
           "帅哥","北京"
       ]
   }
}
```

名称   | 类型 | 说明
:-------|:-----|:-------------------
`code` | int  | 返回码，200 为正常。
`result` | array  | 用户所有的标签数组。