頻道使用者分組介面

該文件對應 ChannelViewerGroupController。
這是直播後台登入態介面，userId 由系統根據當前登入帳號自動注入，無需前端傳入。
使用者端介面前綴：/live-bg/v3/user/channel-viewer/group
教師端介面前綴：/live-bg/v3/teacher/channel-viewer/group

1. 查詢頻道下的分組列表

• 介面位址
  • GET /live-bg/v3/user/channel-viewer/group/list
  • GET /live-bg/v3/teacher/channel-viewer/group/list
• 請求參數

• 處理說明

  • 如果頻道下還沒有分組，系統會自動建立 3 個預設分組：第一小组、第二小组、第三小组

• 回應 data 欄位

• 請求範例

GET /live-bg/v3/user/channel-viewer/group/list?channelId=123456

• 回應範例

{
  "code": 200,
  "status": "success",
  "success": true,
  "data": [
    {
      "id": 1,
      "channelId": 123456,
      "name": "第一小组",
      "viewerCount": 12
    },
    {
      "id": 2,
      "channelId": 123456,
      "name": "第二小组",
      "viewerCount": 8
    }
  ]
}

2. 新增頻道分組

• 介面位址
  • POST /live-bg/v3/user/channel-viewer/group/save
  • POST /live-bg/v3/teacher/channel-viewer/group/save
• 請求主體參數

• 回應 data 欄位

• 請求範例

{
  "channelId": 123456,
  "name": "重点用户组"
}

3. 更新頻道分組

• 介面位址
  • POST /live-bg/v3/user/channel-viewer/group/update
  • POST /live-bg/v3/teacher/channel-viewer/group/update
• 請求主體參數

• 請求範例

{
  "channelId": 123456,
  "id": 1,
  "name": "高意向用户组"
}

4. 刪除頻道分組

• 介面位址
  • POST /live-bg/v3/user/channel-viewer/group/delete
  • POST /live-bg/v3/teacher/channel-viewer/group/delete
• 請求主體參數

• 處理說明

  • 刪除分組前，系統會先將該分組下的使用者解除分組關係，不會刪除使用者本身

• 請求範例

{
  "channelId": 123456,
  "id": 1
}