上传到视频点播媒资库中的视频、音频、图片等媒资,支持对其进行模糊匹配、多值查询、指定返回字段等多方式多维度的搜索、筛选、过滤和排序,以获取到符合搜索条件的媒资信息。本文为您介绍如何通过控制台和API/SDK方式搜索媒资信息。
使用方式
视频点播提供了如下两种方式来搜索媒资信息:
通过控制台搜索
通过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编码。
同时语句中使用的等号、双引号、单引号、括号必须为英文半角。
分类 | 描述 |
返回字段 | 媒资搜索接口默认返回媒资基本信息,当需要附加其他媒资信息时需要指定
请求示例:
|
精确匹配 | 查询
请求示例:
|
模糊匹配 |
或者写成
请求示例:
|
多值查询 | 查询
请求示例:
|
范围查询 | 使用开闭区间表示范围,
请求示例:
如果只有左边界或右边界,对应右边界或左边界值为空即可,如
请求示例:
|
排序字段 | 按创建时间倒排:
请求示例:
|