图片上传到视频点播后,可以调用本接口通过图片ID批量修改图片的标题、描述、标签和分类信息。
接口说明
本接口仅支持修改上传的图片,暂不支持修改视频截图产生的图片。
一次最多支持修改 20 个图片的信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vod:UpdateImageInfos |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| UpdateContent |
string |
是 |
更新内容。一次最多支持修改 20 个图片的信息。参数结构参考下表更新内容 UpdateContent。 说明
|
[{"ImageId":"ff8fe57e3461416c6a267a4e09****","Title":" title","Description":" description","Tags":" tag1, tag2"}] |
更新内容 UpdateContent
说明
UpdateContent 的取值需要转为 String 后作为传入参数。
| 名称 | 类型 | 是否必需 | 描述 |
| ImageId | String | 是 | 图片 ID。可通过以下方式获取: 可登录点播控制台,选择媒资库 > 图片查看 ID。 调用 CreateUploadImage 接口获取上传地址和凭证时会返回。 调用 SearchMedia 接口查询图片时会返回。 |
| Title | String | 否 | 图片标题。 长度不超过 128 个字节。UTF8 编码。 |
| Description | String | 否 | 图片描述。长度不超过 1024 个字节。UTF8 编码。 |
| Tags | String | 否 | 图片标签。单个标签不超过 32 字节。最多不超过 16 个标签。多个标签之间用半角逗号(,)分隔。UTF8 编码。 |
| CateId | Long | 否 | 分类 ID。可通过以下方式获取: 登录点播控制台,选择配置管理 > 媒资管理配置 > 分类管理查看分类 ID。 调用 AddCategory 接口创建分类时会返回。 调用 GetCategories 接口查询分类时会返回。 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| RequestId |
string |
请求 ID。 |
25818875-5F78-4AF6-D7393642CA58**** |
| NonExistImageIds |
object |
||
| ImageId |
array |
不存在的图片 ID 列表。 |
|
|
string |
不存在的图片 ID 列表。 |
f45cf4eba5c80233389558c39**** |
示例
正常返回示例
JSON格式
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"NonExistImageIds": {
"ImageId": [
"f45cf4eba5c80233389558c39****"
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。
该文章对您有帮助吗?