全部产品

更新媒资内容信息

本文为您介绍更新媒资内容信息API的请求参数与示例。

描述

根据ICE mediaId或媒资InputURL,更新一个媒资的媒资信息。MediaId不为空时,优先使用MediaId。如果MediaId为空,则InputURL必须非空。默认模式为overwrite (字段不为空时覆盖),如果需要在原有信息基础上append,需要将对应的append字段设为true。返回请求ID和媒资ID。不支持给定MediaId, 修改InputURL。

请求参数

字段名称

类型

必须填

示例值

描述

Action

String

UpdateMediaInfo

系统规定参数。取值:UpdateMediaInfo

MediaId

String

若为空,则必须有InputURL

****20b48fb04483915d4f2cd8ac****

ICE 媒资ID

- 32位UUID

InputURL

String

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

待注册的媒资在相应系统中的地址,一经注册不可更改,并与ICE的mediaId绑定

- OSS地址,支持两种格式

  1. http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4

  2. oss://example-bucket/example.mp4 此格式默认oss region与服务接入区域一致

BusinessType

String

video

媒资业务类型。取值范围:

- "subtitles" 字幕

- "watermark" 水印

- "opening" 片头/开场

- "ending" 片尾

- "general" 通用

Title

String

defaultTitle

标题

- 长度不超过128字节。

- UTF8编码。

Description

String

defaultDescription

内容描述

- 长度不超过1024字节

- UTF8编码。

Category

String

defaultCategory

分类

- 长度不超过64字节。

- UTF8编码。

MediaTags

String

updateTags1,updateTags2

标签。

- 最多不超过16个标签。

- 多个用逗号分隔。

- 单个标签不超过32字节。

- UTF8编码。

CoverURL

String

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png

封面地址。

- 长度不超过128字节。

- UTF8编码。

UserData

String

userData

用户数据,最大1024字节。

DynamicMetaDataList

String

[{"data":"{\"事件\":\"射门\",\"人物\":\"C罗\"}","in":10.0,"out":20.3,"type":"user-defined"},{"data":"{\"事件\":\"射门\",\"人物\":\"C罗\"}","in":20.0,"out":29.9,"type":"user-defined"}]

用户自定义元数据。

- 长度不超过2048字节。

- UTF8编码。

- DynamicMetaData[] -> Json String

AppendTags

Boolean

否,默认overwrite

true

是否以append的形式更新Tags字段

AppendDynamicMeta

Boolean

否,默认overwrite

true

是否以append的形式更新DynamicMetaDataList字段

返回参数

字段名称

类型

描述

RequestId

String

请求ID

MediaId

String

ICE 媒资ID

请求示例

https://ice.cn-shanghai.aliyuncs.com/?Action=UpdateMediaInfo
&MediaId=****20b48fb04483915d4f2cd8ac****
&MediaTags=updateTags
&AppendTags=true
&<公共参数>

返回示例

{
  "RequestId": "2FDE2411-DB8D-4A9A-875B-275798F14A5E",
  "MediaId": "****20b48fb04483915d4f2cd8ac****"
}