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/灰 |
