调用 UpdateHostAccount 接口，在当前账号下新增主播账号或更新已有主播账号的信息。

使用说明

接口行为

• 新增主播账号：在请求参数中不传 Id（主播账号 ID）或传入 Id 且参数取值为 0 ，即可新增主播账号。
• 更新主播账号信息：在请求参数中传入待更新信息的主播账号的 ID 作为 Id 参数值，即可更新该账号信息。您可以通过 ListHostAccounts 接口查询 ID。

注意事项

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

请求说明

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

请求参数

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

Query

Body

HostAccount

返回参数

请求示例

POST https://livesaas.volcengineapi.com/?Action=UpdateHostAccount&Version=2023-08-01
{
    "HostAccount": {
        "Id": 114333,
        "Name": "主播名称",
        "AvatarUrl": "https://p.example.org/6ed59yyum2-z75.png",
        "IsFollowEnable": 1,
        "HomeUrl": "https://example.com"
    },
    "GetFollowDataUrl": "https://example.com",
    "UpdateFollowDataUrl": "https://example.com"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "UpdateHostAccount",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1715326286
    },
    "Result": {
        "HostAccountId": 114333
    }
}

错误码

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