搜索媒资信息

搜索媒资信息，是指对视频点播媒资库（视频、音频、图片等）进行搜索、筛选、过滤和排序，以获取到符合搜索条件的媒资信息。本文为您介绍通过控制台和API/SDK搜索媒资信息的方法、使用限制和使用API的示例。

使用方式

视频点播提供了如下两种方式来搜索媒资信息：

通过控制台搜索
登录控制台，进入媒资库页面，可以通过单击媒体名称或媒体ID（图片名称或图片ID）搜索媒资信息。具体操作，请参见媒资管理。
通过API/SDK搜索
使用搜索媒体信息接口，同时配合媒资搜索协议使用。搜索媒体信息接口支持指定返回字段、精确匹配、模糊匹配、多值查询、范围查询等多种方式的查询，支持作为过滤条件的媒资信息包括VideoId、CateId、StorageLocation、Title、Tags等多个字段，详细的搜索语法及规则请参见媒资搜索协议。

使用限制

翻页限制

为避免深度翻页造成性能问题，媒资搜索限制只返回命中搜索条件的部分数据。如果要获取更多数据、甚至遍历所有数据，则需要使用翻页标记（ScrollToken）、会话ID（SessionId）。

获取部分数据使用翻页参数（PageNo、PageSize），且不传翻页标识（ScrollToken、SessionId），可逐次获取前5000条数据。
获取更多数据，或遍历所有数据使用翻页参数（PageNo、PageSize），且传入翻页标识（ScrollToken、SessionId），则翻页位置与当前位置之间不能超过1200条数据；但可以在翻到最后一页时获取到接下来的1200条，以此类推，直到取完所有数据。也就是，可以根据翻页标识，分多段拿数据，但每段限制最多1200条。

API使用示例

下文将以搜索视频信息为例介绍搜索语句。

注意

发送请求前需要对请求参数做URL编码。
同时语句中使用的等号、双引号、单引号、括号必须为英文半角。

分类	描述
返回字段	媒资搜索接口默认返回媒资基本信息，当需要附加其他媒资信息时需要指定`Fields`字段。查询结果中包含`Title`和`CoverURL`： `Fields=Title,CoverURL` 请求示例： `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Fields=Title,CoverURL`
精确匹配	查询`VideoId`值为`28ba2b26d540446c94cdd2c4c48090e5`的视频信息： `VideoId='28ba2b26d540446c94cdd2c4c48090e5'` 请求示例： `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=VideoId='28ba2b26d540446c94cdd2c4c48090e5'`
模糊匹配	`Title`中包含`音乐`，可以写成： `Title='音乐'` 或者写成 `Title in ('音乐')` 请求示例： `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=Title='音乐'`
多值查询	查询`Status`值为`Normal` 或`Checking` `Status in ('Normal','Checking')` 请求示例： `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=Status in ('Normal','Checking')`
范围查询	使用开闭区间表示范围，`CreationTime`位于`2018-01-01T00:00:00Z`和`2018-02-01T00:00:00Z`之间： `CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')` 请求示例： `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')` 如果只有左边界或右边界，对应右边界或左边界值为空即可，如`CreationTime`大于`2018-01-01T00:00:00Z`： `CreationTime=('2018-01-01T00:00:00Z',)` 请求示例： `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=CreationTime=('2018-01-01T00:00:00Z',)`
排序字段	按创建时间倒排： `CreationTime:Desc` 请求示例： `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &SortBy=CreationTime:Desc`