全部产品

搜索媒资信息

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

使用方式

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

使用限制

翻页限制

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

  • 获取部分数据使用翻页参数(PageNoPageSize),且不传翻页标识(ScrollTokenSessionId),可逐次获取前5000条数据。

  • 获取更多数据,或遍历所有数据使用翻页参数(PageNoPageSize),且传入翻页标识(ScrollTokenSessionId),则翻页位置与当前位置之间不能超过1200条数据;但可以在翻到最后一页时获取到接下来的1200条,以此类推,直到取完所有数据。也就是,可以根据翻页标识,分多段拿数据,但每段限制最多1200条。

API使用示例

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

注意
  • 发送请求前需要对请求参数做URL编码。

  • 同时语句中使用的等号、双引号、单引号、括号必须为英文半角。

分类

描述

返回字段

媒资搜索接口默认返回媒资基本信息,当需要附加其他媒资信息时需要指定Fields字段。查询结果中包含TitleCoverURL

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值为NormalChecking

Status in ('Normal','Checking')

请求示例:

http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
&Match=Status in ('Normal','Checking')

范围查询

使用开闭区间表示范围,CreationTime位于2018-01-01T00:00:00Z2018-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