SET CLASS
---
### ```setDiscussLeave```「置讨论组退出」
#### 说明
* 需要权限```140```
#### 请求数据
~~~
{
"fun":"setDiscussLeave",
"group":12345
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 讨论组号 |
### ```setFriendAddRequest```「置好友添加请求」
#### 说明
* 需要权限```150```
#### 请求数据
~~~
{
"fun":"setFriendAddRequest",
"responseFlag":"1223434",
"subType":1,
"name":"233"
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```responseFlag``` | string | - | 反馈标识，请求事件收到的```responseFlag```参数 |
| ```subType``` | int | - | 反馈类型，```1```/通过 ```2```/拒绝 |
| ```name``` | string | ```null``` | 备注，仅 反馈类型 为 通过 时有效 |
### ```setGroupAddRequest```「置群添加请求」
#### 说明
* 需要权限```151```
#### 请求数据
~~~
{
"fun":"setGroupAddRequest",
"responseFlag":"1223434",
"subType":1,
"type":2,
"msg":"233"
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```responseFlag``` | string | - | 反馈标识，请求事件收到的```responseFlag```参数 |
| ```subType``` | int | - | 请求类型，```1```/群添加，```2```/群邀请 |
| ```type``` | int | - | 反馈类型，```1```/通过，```2```/拒绝 |
| ```msg``` | string | ```null``` | 操作理由，可空，仅 群添加 & 拒绝 情况下有效 |
### ```setGroupAdmin```「置群管理员」
#### 说明
* 需要权限```122```
#### 请求数据
~~~
{
"fun":"setGroupAdmin",
"group":12345,
"qq":67890,
"become":false
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```qq``` | number | - | QQ号 |
| ```become``` | bool | ```false``` | 设置为管理员，```True```/设置，```False```/取消 |
### ```setGroupAnonymous```「置群匿名设置」
#### 说明
* 需要权限```125```
#### 请求数据
~~~
{
"fun":"setGroupAnonymous",
"group":12345,
"open":false
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```open``` | bool | ```False``` | 操作类型，```True```/允许匿名聊天，```False```/禁止匿名聊天 |
### ```setGroupAnonymousBan```「置匿名群员禁言」
#### 说明
* 需要权限```124```
#### 请求数据
~~~
{
"fun":"setGroupAnonymousBan",
"group":12345,
"anonymous":"1111",
"time":60
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 群号 |
| ```anonymous``` | string | 匿名标识，即提交的参数```fromAnonymous``` |
| ```time``` | int | 禁言时间，单位：秒，不支持解禁 |
### ```setGroupBan```「置群成员禁言」
#### 说明
* 需要权限```121```
#### 请求数据
~~~
{
"fun":"setGroupBan",
"group":12345,
"qq":1111,
"time":0
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```qq``` | number | `0` | QQ号，可空，空时为禁言全群 |
| ```time``` | int | ```0``` | 禁言时间，单位：秒。```0```为解禁；不得超过 ```2592000``` (一个月) |
### ```setGroupCard```「置群成员名片」
#### 说明
* 需要权限```126```
#### 请求数据
~~~
{
"fun":"setGroupCard",
"group":12345,
"qq":1111,
"card":""
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```qq``` | number | - | QQ号 |
| ```card``` | string | ```null``` | 新名片 |
### ```setGroupFileDelete```「删除群文件」
### 说明
* 需要权限`20`
#### 请求数据
```
{
"module":"api",
"fun":"setGroupFileDelete",
"group":12345,
"busid":123,
"id":"/8a179ccf-bc0f-4abd-8656-beb6666b0452"
}
```
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```group``` | number | 群号 |
| ```busid``` | int | 未知作用，值为群文件信息中的```busid``` |
| ```id``` | string | 文件ID，值为群文件信息中的```id``` |
### ```setGroupLeave```「置群退出」
#### 说明
* 需要权限```127```
#### 请求数据
~~~
{
"fun":"setGroupLeave",
"group":12345,
"disband":false
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```disband``` | bool | ```false``` | 操作类型，```true```/解散本群(群主) ```false```/退出本群(管理、群成员) |
### ```setGroupKick```「置群成员移除」
#### 说明
* 需要权限```120```
#### 请求数据
~~~
{
"fun":"setGroupKick",
"group":12345,
"qq":12345,
"refuseJoin":false
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```qq``` | number | - | QQ号 |
| ```refuseJoin``` | bool | ```false``` | 拒绝再加群，```true```/不再接收此人加群申请，```false```/接收此人加群申请 |
### ```setGroupSign```「置群签到」
#### 说明
* 需要权限```20```
#### 请求数据
~~~
{
"fun":"setGroupSign",
"group":12345
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | ```0``` | 群号，值为```0```时表示签到所有群 |
### ```setGroupSpecialTitle```「置群成员专属头衔」
#### 说明
* 需要权限```128```
* 需要群主权限
#### 请求数据
~~~
{
"fun":"setGroupSpecialTitle",
"group":12345,
"qq":12345,
"tip":"",
"time":-1
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```qq``` | number | - | QQ号 |
| ```tip``` | string | `null` | 头衔，可空。如果要删除，这里填```null``` |
| ```time``` | int | `-1` | 专属头衔有效期，单位为秒。如果永久有效，这里填写```-1``` |
### ```setGroupWholeBan```「置全群禁言」
#### 说明
* 需要权限```123```
#### 请求数据
~~~
{
"fun":"setGroupWholeBan",
"group":12345,
"open":false
}
~~~
##### 参数说明
| 参数名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| ```group``` | number | - | 群号 |
| ```open``` | bool | ```false``` | 操作类型，```true```/开启禁言，```false```/关闭禁言 |
### ```setMsgDelete```「撤回消息」
### 说明
* 需要权限`180`
* 需要使用 酷Q Pro
* 可以撤回群成员消息，但是需要群管理权限
* 可以撤回自己发送消息，但只能撤回**两分钟**内发送的内容
#### 请求数据
```
{
"fun":"setMsgDelete",
"msgID":12345
}
```
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```msgID``` | int | 消息ID，值为提交事件中提交的参数```msgID``` |
### ```setSign```「QQ打卡」
#### 说明
* 需要权限```20```
* 调用此API时，需要机器人QQ完成财付通实名认证
#### 请求数据
~~~
{
"fun":"setSign"
}
~~~
### ```setStatus```「置悬浮窗数据」
#### 请求数据
~~~
{
"fun":"setStatus",
"data":"233",
"unit":"s",
"color":1
}
~~~
##### 参数说明
| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| ```data``` | string | 数据内容 |
| ```unit``` | string | 数据单位 |
| ```color``` | int | 颜色，1/绿 2/橙 3/红 4/深红 5/黑 6/灰 |
