DeleteTeachAssistantAccount - 删除助播账号--企业直播-火山引擎

文档中心

立即注册

导航

DeleteTeachAssistantAccount - 删除助播账号

最近更新时间：2025.06.05 11:21:00首次发布时间：2024.02.01 14:52:51

调用 DeleteTeachAssistantAccount 接口，删除直播间中的指定助播账号，并查看该直播间剩余助播账号的信息。

说明

如果助播在线期间账号被删除，则

当 LoginType 取值为 0 时，助播会被强制退出并返回助播平台登录页面。
当 LoginType 取值为 1 时，助播会收到助播管理员权限收回的通知并继续以观众身份留在观看页。

注意事项

请求频率：单用户请求频率限制为 6 次/秒。
前提条件：确保您拥有火山引擎主账号或具备直播间的观看页管理 > 可编辑权限的子账号。有关如何添加子账号，详见子账号管理。

请求说明

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

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`DeleteTeachAssistantAccount`	接口名称。当前 API 的名称为 `DeleteTeachAssistantAccount`。
Version	String	是	`2023-08-01`	接口版本。当前 API 的版本为 `2023-08-01`。

Body

参数	类型	是否必选	示例值	描述
Id	Long	是	`2`	助播账号 ID。您可以通过 ListTeachAssistantAccounts 接口查询 ID。
ActivityId	Long	是	`177****8945`	直播间 ID。您可以通过 ListActivityAPI 接口查询 ID。说明使用子账号调用接口时，确保该直播间对子账号可见。有关如何配置子账号的可见范围，详见子账号管理。

返回参数

参数	类型	示例值	描述
TeachAssistantAccounts	Array of TeachAssistantAccounts	`-`	直播间剩余助播账号的信息列表。
MaxTeachAssistantAccountNumber	Long	`5`	直播间内助播账号的数量上限。说明开通的功能版本不同，该参数的取值也不同：旗舰版参数取值为 `2`。尊享版参数取值为 `5`。

TeachAssistantAccounts

参数	类型	示例值	描述
LoginType	Integer	`0`	登录方式。取值如下： `0`：密码登录。助播可通过登录地址和密码登录助播平台，并根据指定功能权限，在 PC 端管理直播间。 `1`：邀请登录。助播可通过邀请链接在 PC 端或手机端进入观看页，并在登录直播间（仅输入昵称除外）后，在聊天互动菜单下管理直播间。
Title	String	`助播`	助播头衔。
NickName	String	`老师`	助播昵称。
TeachAssistantFeatures	Array of Integer	`[1,2,3]`	助播的功能权限。当 `LoginType` 取值为 `1` 时，该参数取值固定为 `1`。 `1`：观众聊天：配置该权限后，助播可在聊天互动菜单下完成相关操作。为保证助播可正常使用聊天互动菜单，确保您已启用聊天互动菜单。助播平台的操作与控制台一致，具体操作方法，详见聊天互动。说明助播平台不支持聊天审核、导出聊天、机器人评论和管理系统消息功能。 `2`：直播画面：配置该权限后，助播可监控直播画面、查看直播间人气值和点赞数等。说明如果当前直播间配置了多个直播频道，则频道选择入口固定放置于播放器内。有关如何配置直播频道，详见直播频道管理。 `3`：观众列表：配置该权限后，助播可查看观众列表并进行相关操作。助播平台的操作与控制台一致，具体操作方法，详见观众列表。说明助播平台不支持查看详情和导出数据功能。 `4`：互动工具：配置该权限后，助播可在互动工具菜单下完成相关操作。为保证助播可正常使用互动工具菜单，确保您已启用互动工具菜单。助播平台的操作与控制台一致，具体操作方法，详见互动工具。 `5`：商品管控：配置该权限后，助播可在商品卡片菜单下完成相关操作。为保证助播可正常使用商品卡片菜单，确保您已启用商品卡片菜单。助播平台的操作与控制台一致，具体操作方法，详见商品卡片。 `6`：直播中断：配置该权限后，助播可通过单击锁定预告，将观看页锁定在预告画面，不播放直播或回放画面。详见锁定预告。 `7`：互动问答：配置该权限后，助播可在互动问答菜单下完成相关操作。为保证助播可正常使用互动问答菜单，确保您已启用互动问答菜单。助播平台的操作与控制台一致，具体操作方法，详见互动问答。说明助播平台不支持聊天审核和导出聊天功能。 `8`：私聊：配置该权限后，助播可在私聊互动菜单下完成相关操作。为保证助播可正常使用私聊互动菜单，确保您已启用私聊互动菜单。助播平台的操作与控制台一致，具体操作方法，详见私聊互动。
LoginUrl	String	`https://live.example.com/ta/1779854981841/login?identity_id=918**82`	`LoginType` 的取值不同，该参数的含义也不同。当 `LoginType` 取值为 `0` 时，参数取值为助播平台的登录地址。当 `LoginType` 取值为 `1` 时，参数取值为助播专属的观看页地址。
OneStepLoginUrl	String	`https://live.example.com/ta/1779854981841/login?identity_id=91882&p=*`	助播平台的一键免登录地址，即助播可通过该地址免登录进入助播平台。说明当 `LoginType` 取值为 `1` 时，该参数的取值与 `LoginUrl` 的取值一致。
Password	String	`123456`	助播平台的登录密码。说明仅当 `LoginType` 取值为 `0` 时，该参数有值。
IdentityId	String	`9188382`	助播平台的登录账号。说明仅当 `LoginType` 取值为 `0` 时，该参数有值。
Id	Long	`1`	助播账号 ID。
AudienceGroupIds	Array of Long	`[0,149112456]`	助播可管理的直播分组 ID。说明仅当 `LoginType` 取值为 `0` 且开启直播分组功能后，该参数生效。您可调用 UpdateAudienceGroupConfig 接口开启直播分组功能。
UserId	String	`123`	助播的用户 ID。说明仅当 `LoginType` 取值为 `1` 且助播已登录直播间时，该参数有值。

请求示例

POST https://livesaas.volcengineapi.com/?Action=DeleteTeachAssistantAccount&Version=2023-08-01
{
    "Id": 2,
    "ActivityId": 177****8945
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "DeleteTeachAssistantAccount",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "TeachAssistantAccounts": [
            {
                "Id": 1,
                "Password": "123456",
                "IdentityId": "9188382",
                "NickName": "老师",
                "Title": "助播",
                "TeachAssistantFeatures": [
                    1,
                    2,
                    3
                ],
                "LoginUrl": "https://live.example.com/ta/1779854981841/login?identity_id=918**82",
                "OneStepLoginUrl": "https://live.example.com/ta/1779854981841/login?identity_id=918**82&p=***",
                "AudienceGroupIds": [
                    0,
                    149112456
                ],
                "LoginType": 0,
                "UserId": "123"
            }
        ],
        "MaxTeachAssistantAccountNumber": 5
    }
}

错误码

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