頻道所屬使用者列表介面

此文件對應 live-background-aggregate 的 ChannelViewerListController。
這是直播後台登入態介面，userId 由系統根據目前登入帳號自動注入。
使用者端介面前綴：/live-bg/v3/user/channel-viewer/list
教師端介面前綴：/live-bg/v3/teacher/channel-viewer/list

1. 分頁查詢頻道所屬使用者列表

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

• 查詢說明

  • 支援按分組ID、使用者暱稱、使用者ID、手機號碼組合查詢
  • 查詢結果會關聯使用者體系，回傳使用者暱稱、手機號碼和分組名稱

• 回應 data 欄位

contents 陣列元素說明：

• 請求範例

GET /live-bg/v3/user/channel-viewer/list/list?channelId=123456&groupId=1&nickname=张三&pageNumber=1&pageSize=20

2. 匯出頻道所屬使用者列表

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

• 處理說明

  • 匯出介面不分頁
  • 回傳值 data 為匯出任務ID，可結合匯出任務查詢介面查看進度和下載結果

• 請求範例

GET /live-bg/v3/user/channel-viewer/list/export?channelId=123456&groupId=1

3. 新增頻道所屬使用者

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

• 處理說明

  • 已存在的觀眾不會重複新增
  • 如果有傳 groupId，已存在的觀眾會被更新到該分組

• 請求範例

{
  "channelId": 123456,
  "groupId": 1,
  "viewerIds": [
    "viewer-a",
    "viewer-b"
  ]
}

4. 刪除頻道所屬使用者

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

5. 批次轉移頻道所屬使用者到指定分組

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

6. 匯入頻道所屬使用者

• 介面位址

  • POST /live-bg/v3/user/channel-viewer/list/import
  • POST /live-bg/v3/teacher/channel-viewer/list/import

• 請求方式

  • multipart/form-data

• 表單參數

• 匯入模板說明

  • Excel 第 1 列表頭為：用户手机号

• 回應 data 欄位

• 請求範例

curl -X POST 'https://live.polyv.net/live-bg/v3/user/channel-viewer/list/import?channelId=123456&groupId=1' \
  -F 'file=@/tmp/viewer-import.xlsx'

通用回應說明