上传到视频点播媒资库中的视频、音频、图片等媒资,支持对其进行模糊匹配、多值查询、指定返回字段等多方式多维度的搜索、筛选、过滤和排序,以获取到符合搜索条件的媒资信息。本文为您介绍如何通过控制台和API/SDK方式搜索媒资信息。
使用方式
视频点播提供了如下两种方式来搜索媒资信息:
- 通过控制台搜索 - 登录视频点播控制台,进入媒资库页面,您可以根据媒体类型、分类、状态和来源来筛选音/视频,也可以通过媒体名称、媒体ID、标签名称等进行搜索媒资信息。 说明- 如果您的视频状态显示转码失败,请先尝试删除该视频文件并重新上传。如果多次均出现转码失败,可参考转码常见问题。  
- 通过API/SDK搜索 - 使用SearchMedia - 搜索媒体信息接口,同时配合媒资搜索协议使用。SearchMedia - 搜索媒体信息接口支持指定返回字段、精确匹配、模糊匹配、多值查询、范围查询等多种方式的查询,支持作为过滤条件的媒资信息包括VideoId、CateId、StorageLocation、Title、Tags等多个字段,详细的搜索语法及规则请参见媒资搜索协议。 
使用限制
翻页限制
通过API/SDK方式搜索时,为避免深度翻页造成性能问题,媒资搜索限制只返回命中搜索条件的部分数据。如果要获取更多数据、甚至遍历所有数据,则需要使用翻页标记(ScrollToken)、会话ID(SessionId)。
- 获取部分数据使用翻页参数( - PageNo、- PageSize),且不传翻页标识(- ScrollToken、- SessionId),可逐次获取前5000条数据。
- 获取更多数据,或遍历所有数据使用翻页参数( - PageNo、- PageSize),且传入翻页标识(- ScrollToken、- SessionId),则翻页位置与当前位置之间不能超过1200条数据;但可以在翻到最后一页时获取到接下来的1200条,以此类推,直到取完所有数据。也就是,可以根据翻页标识,分多段拿数据,但每段限制最多1200条。
API使用示例
下文将以搜索视频信息为例介绍搜索语句。
- 发送请求前需要对请求参数做URL编码。 
- 同时语句中使用的等号、双引号、单引号、括号必须为英文半角。 
| 分类 | 描述 | 
| 返回字段 | 媒资搜索接口默认返回媒资基本信息,当需要附加其他媒资信息时需要指定 请求示例:  | 
| 精确匹配 | 查询 请求示例:  | 
| 模糊匹配 | 
 或者写成 请求示例:  | 
| 多值查询 | 注意:如果用于查询的字段仅支持模糊匹配,那么查询结果也将基于模糊匹配返回。 查询 请求示例:  | 
| 范围查询 | 使用开闭区间表示范围, 请求示例: 如果只有左边界或右边界,对应右边界或左边界值为空即可,如 请求示例:  | 
| 排序字段 | 按创建时间倒排: 请求示例:  |