You need to enable JavaScript to run this app.
文档中心
企业直播

企业直播

复制全文
下载 pdf
点播间管理
UpdateVideoRoomBasicInfo - 更新点播间基础信息
复制全文
下载 pdf
UpdateVideoRoomBasicInfo - 更新点播间基础信息

调用 UpdateVideoRoomBasicInfo 接口,更新单个点播间的基础信息。

注意事项

  • 请求频率:单用户请求频率限制为 120 次/分钟
  • 前提条件:确保您拥有火山引擎主账号或具备点播间的基础信息 > 可编辑权限的子账号。有关如何添加子账号,详见子账号管理

请求说明

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

调试

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringUpdateVideoRoomBasicInfo接口名称。当前 API 的名称为 UpdateVideoRoomBasicInfo
VersionString2023-08-01接口版本。当前 API 的版本为 2023-08-01

Body

参数类型是否必选示例值描述
VideoRoomIdInteger20001要更新的点播间的 ID。您可通过调用 ListVideoRooms 接口获取 ID。
NameStringPython数据分析入门到应用点播间名称。长度为 1 到 20 个字符。
CoverImageStringhttps://example.com/cover.jpg点播间的横屏封面图的 URL。需包含协议头。建议图片比例为 16:9,支持上传格式为 JPG、PNG 和 JPEG 的图片。图片大小不超过 2 MB。
VideoRoomClassificationInteger1点播间类型。目前固定为 1,表示知识课程类型的点播间。
KnowledgeClassMetaObject of KnowledgeClassMeta-点播间基础信息。

KnowledgeClassMeta

参数类型是否必选示例值描述
KnowledgeClassDescString基础课程介绍点播间的描述。

IsBulletScreenEnable

Boolean

true

点播间是否开启互动弹幕。取值如下:

  • true:开启。开启后,观众可在观看课程时发送弹幕。
  • false:关闭。
KnowledgeClassNameString课程列表菜单名称。显示在观看端的菜单展示名称。

返回参数

参数类型示例值描述
StatusBooleantrue是否更新成功。成功返回 true

请求示例

POST https://livesaas.volcengineapi.com/?Action=UpdateVideoRoomBasicInfo&Version=2023-08-01
{
    "VideoRoomId": 20001,
    "Name": "Python数据分析入门到应用",
    "CoverImage": "https://example.com/cover.jpg",
    "VideoRoomClassification": 1,
    "KnowledgeClassMeta": {
        "KnowledgeClassDesc": "基础课程介绍",
        "IsBulletScreenEnable": true,
        "KnowledgeClassName": "课程列表"
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "UpdateVideoRoomBasicInfo",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "Status": true
    }
}

错误码

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

最近更新时间:2026.06.24 11:45:18
这个页面对您有帮助吗?
有用
有用
无用
无用