获取直播助教账号信息列表--企业直播-火山引擎

文档中心

立即注册

导航

企业直播

获取直播助教账号信息列表

最近更新时间：2024.06.19 11:33:29首次发布时间：2024.02.01 14:52:51

您可通过此接口获取指定直播间的直播助教的账号信息列表，包括直播助教的功能权限、登录账号、登录密码等。

注意事项

请求频率：单用户请求频率限制为 6 次/秒。

请求说明

请求方式：GET
请求地址：https://livesaas.volcengineapi.com/?Action=ListTeachAssistantAccounts&Version=2023-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`ListTeachAssistantAccounts`	接口名称。当前 API 的名称为 `ListTeachAssistantAccounts`。
Version	String	是	`2023-08-01`	接口版本。当前 API 的版本为 `2023-08-01`。
ActivityId	Long	是	`1774981841`	直播间 ID。您可以通过 ListActivityAPI 接口查询 ID。

返回参数

参数	类型	示例值	描述
TeachAssistantAccounts	Array of TeachAssistantAccounts	`-`	直播助教账号信息列表。
MaxTeachAssistantAccountNumber	Long	`2`	最多支持新增的直播助教账号个数。说明开通的功能版本不同，该参数的取值也不同：旗舰版：2。定制版：5。

TeachAssistantAccounts

参数	类型	示例值	描述
Password	String	`123456`	直播助教平台的登录密码。
TeachAssistantFeatures	Array of Integer	`[1,2,3]`	直播助教的功能权限。 `1`：观众聊天：直播控制页面的聊天互动菜单。详见聊天互动。说明直播助教的聊天互动菜单中，不支持聊天审核、导出聊天、机器人评论和管理系统消息功能。 `2`：直播画面：控制台播放器。说明如果当前直播间配置了多个直播频道，则频道选择入口固定放置于播放器内。有关如何配置直播频道，详见直播频道管理。 `3`：观众列表。直播控制页面的观众列表。详见观众列表。说明直播助教的观众列表中，不支持查看详情和导出数据功能。 `4`：互动工具：直播控制页面的互动工具菜单。详见互动工具。 `5`：商品管控：直播控制页面的商品卡片菜单。详见商品卡片。 `6`：直播中断：锁定预告。详见锁定预告。 `7`：互动问答：直播控制页面的互动问答菜单。详见互动问答。说明直播助教的互动问答菜单中，不支持聊天审核和导出聊天功能。 `8`：私聊：直播控制页面的私聊互动菜单。详见私聊互动。
IdentityId	String	`9188382`	直播助教的登录账号。
Id	Long	`1`	直播助教账号 ID。
NickName	String	`助教昵称`	直播助教昵称。
Title	String	`助教头衔`	直播助教头衔。
LoginUrl	String	`https://live.example.com/ta/1779854981841/login?identity_id=9188382`	直播助教平台的登录地址。
OneStepLoginUrl	String	`https://live.example.com/ta/1779854981841/login?identity_id=9188382&p=***`	直播助教平台的一键免登录地址，即助教可通过该地址免登录进入直播助教平台。
AudienceGroupIds	Array of Long	`[0,149125456]`	助教可管理的直播分组列表。

请求示例

GET https://livesaas.volcengineapi.com/?Action=ListTeachAssistantAccounts&Version=2023-08-01&ActivityId=1774981841

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202306041104200100100232280022D31",
        "Action": "ListTeachAssistantAccounts",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "TeachAssistantAccounts": [
            {
                "Password": "123456",
                "TeachAssistantFeatures": [
                    1,
                    2,
                    3
                ],
                "IdentityId": "9188382",
                "Id": 1,
                "NickName": "助教昵称",
                "Title": "助教头衔",
                "LoginUrl": "https://live.example.com/ta/1779854981841/login?identity_id=9188382",
                "OneStepLoginUrl":"https://live.example.com/ta/1779854981841/login?identity_id=9188382&p=***",
                "AudienceGroupIds":[0,149125456]
            }
        ],
        "MaxTeachAssistantAccountNumber": 2
    }
}

错误码

访问公共错误码和错误码获取详细信息。