UpdateTeachAssistantAccount - 新增或更新助播账号信息--企业直播-火山引擎

文档中心

立即注册

导航

UpdateTeachAssistantAccount - 新增或更新助播账号信息

最近更新时间：2025.06.26 21:12:04首次发布时间：2024.02.01 14:52:51

调用 UpdateTeachAssistantAccount 接口，在指定直播间内新增助播账号，或更新已有助播账号的功能权限、登录密码、头衔等信息。

使用说明

接口行为

新增助播账号：不传 Id（助播账号 ID）和 IdentityId（助播平台的登录账号）或传入 Id 和 IdentityId 且参数取值为 0 ，即可新增助播账号。
更新助播账号信息：
- 当 LoginType 取值为 0 时，传入助播的账号 ID 和登录账号作为 Id 和 IdentityId 的参数值，即可更新该助播账号的助播头衔、助播昵称、登录密码、功能权限或可管理的直播分组。您可以调用 ListTeachAssistantAccounts 接口查询助播的账号 ID 和登录账号。
  说明
  - 确保 Id 与 IdentityId 的参数值对应同一个助播账号。
  - 如果在助播在线期间更新登录密码、功能权限或可管理的直播分组，助播会被强制退出并返回助播平台登录页面。
- 当 LoginType 取值为 1 时，传入助播的账号 ID 作为 Id 的参数值，即可更新该助播账号的助播头衔。您可以调用 ListTeachAssistantAccounts 接口查询助播的账号 ID。

注意事项

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

请求说明

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

请求参数

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

Query

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

Body

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

TeachAssistantAccount

参数	类型	是否必选	示例值	描述
LoginType	Integer	否	`0`	登录方式。默认值为 `0`。取值如下： `0`：密码登录。助播可通过登录地址和密码登录助播平台，并根据指定功能权限，在 PC 端管理直播间。 `1`：邀请登录。助播可通过邀请链接在 PC 端或手机端进入观看页，并在登录直播间（仅输入昵称除外）后，在聊天互动菜单下管理直播间。
Id	Long	否	`0`	助播账号 ID，用于新增助播账号或更新助播账号信息，详见接口行为。
IdentityId	String	否	`0`	助播平台的登录账号，用于新增助播账号或更新助播账号信息，详见接口行为。
Title	String	是	`助播`	助播头衔。长度为 1 到 10 个字符。
NickName	String	否	`老师`	助播昵称。长度为 1 到 20 个字符。说明当 `LoginType` 取值为 `0` 时，该参数必选且生效。
Password	String	否	`123456`	助播平台的登录密码。长度为 1 到 20 个字符。支持以下字符：数字大写字母 A - Z 小写字母 a - z 说明新增助播账号时，不传该参数，则由系统随机生成登录密码。
TeachAssistantFeatures	Array of Integer	是	`[1,2,3]`	助播的功能权限。当 `LoginType` 取值为 `1` 时，该参数取值必须为 `1`。 `1`：观众聊天：配置该权限后，助播可在聊天互动菜单下完成相关操作。为保证助播可正常使用聊天互动菜单，确保您已启用聊天互动菜单。助播平台的操作与控制台一致，具体操作方法，详见聊天互动。说明助播平台不支持聊天审核、导出聊天、机器人评论和管理系统消息功能。 `2`：直播画面：配置该权限后，助播可监控直播画面、查看直播间人气值和点赞数等。说明如果当前直播间配置了多个直播频道，则频道选择入口固定放置于播放器内。有关如何配置直播频道，详见直播频道管理。 `3`：观众列表：配置该权限后，助播可查看观众列表并进行相关操作。助播平台的操作与控制台一致，具体操作方法，详见观众列表。说明助播平台不支持查看详情和导出数据功能。 `4`：互动工具：配置该权限后，助播可在互动工具菜单下完成相关操作。为保证助播可正常使用互动工具菜单，确保您已启用互动工具菜单。助播平台的操作与控制台一致，具体操作方法，详见互动工具。 `5`：商品管控：配置该权限后，助播可在商品卡片菜单下完成相关操作。为保证助播可正常使用商品卡片菜单，确保您已启用商品卡片菜单。助播平台的操作与控制台一致，具体操作方法，详见商品卡片。 `6`：直播中断：配置该权限后，助播可通过单击锁定预告，将观看页锁定在预告画面，不播放直播或回放画面。详见锁定预告。 `7`：互动问答：配置该权限后，助播可在互动问答菜单下完成相关操作。为保证助播可正常使用互动问答菜单，确保您已启用互动问答菜单。助播平台的操作与控制台一致，具体操作方法，详见互动问答。说明助播平台不支持聊天审核和导出聊天功能。 `8`：私聊：配置该权限后，助播可在私聊互动菜单下完成相关操作。为保证助播可正常使用私聊互动菜单，确保您已启用私聊互动菜单。助播平台的操作与控制台一致，具体操作方法，详见私聊互动。
AudienceGroupIds	Array of Long	否	`[178952525,149145655]`	助播可管理的直播分组 ID。参数取值为 `-2` 时，表示全部直播分组。您可调用 GetAudienceGroupConfig 接口，通过返回参数 `GroupId` 获取分组 ID。说明仅当 `LoginType` 取值为 `0` 且开启直播分组功能后，该参数生效。您可调用 UpdateAudienceGroupConfig 接口开启直播分组功能。

返回参数

参数	类型	示例值	描述
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` 时，该参数有值。
Id	Long	`1`	助播账号 ID。
IdentityId	String	`9188382`	助播平台的登录账号。说明仅当 `LoginType` 取值为 `0` 时，该参数有值。
AudienceGroupIds	Array of Long	`[178952525,149145655]`	助播可管理的直播分组 ID。说明仅当 `LoginType` 取值为 `0` 且开启直播分组功能后，该参数生效。您可调用 UpdateAudienceGroupConfig 接口开启直播分组功能。
UserId	String	`123`	助播的用户 ID。说明仅当 `LoginType` 取值为 `1` 且助播已登录直播间时，该参数有值。

请求示例

POST https://livesaas.volcengineapi.com/?Action=UpdateTeachAssistantAccount&Version=2023-08-01
{
    "TeachAssistantAccount": {
        "Id": 0,
        "Title": "助播",
        "NickName": "老师",
        "Password": "123456",
        "TeachAssistantFeatures": [
            1,
            2,
            3
        ],
        "IdentityId": "0",
        "AudienceGroupIds": [
            1789**52525,
            1491**45655
        ],
        "LoginType": 0
    },
    "ActivityId": 1779****87296
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "UpdateTeachAssistantAccount",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "TeachAssistantAccounts": [
            {
                "Password": "123456",
                "Id": 1,
                "NickName": "老师",
                "TeachAssistantFeatures": [
                    1,
                    2,
                    3
                ],
                "IdentityId": "9188382",
                "Title": "助播",
                "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": [
                    1789**52525,
                    1491**45655
                ],
                "LoginType": 0,
                "UserId": ""
            }
        ],
        "MaxTeachAssistantAccountNumber": 5
    }
}

错误码

下表提供了该接口特有的错误码，公共错误码请参见公共错误码和错误码文档。

状态码	错误码	错误信息	说明
409	OperationDenied.TitleHitSensitiveWords	Operation is denied because the title hits sensitive words.	`Title` 参数取值包含敏感词。请修改后重试。
400	OperationDenied.NickNameHitSensitiveWords	Operation is denied because the nickName hits sensitive words	`NickName` 参数取值包含敏感词。请修改后重试。
400	OperationDenied.TeachAssistantAccountOverLimit	Operation is denied because the number of teaching assistant accounts exceeds the limit.	助播账号的数量超出直播间上限（即返回参数 `MaxTeachAssistantAccountNumber` 的取值）。请调用 DeleteTeachAssistantAccount 接口删除部分助播账号后重试。