全部产品
云市场

搜索媒资

更新时间:2018-12-11 22:17:36

简介

搜索媒资,是指对视频点播媒资库(视频、音频、图片等)进行搜索、筛选、过滤和排序,以获取到符合搜索条件的媒资信息。

使用方式

点播服务提供了多种方式来搜索媒资信息。

使用限制

翻页限制

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

  • 获取部分数据使用翻页参数(PageNo、PageSize),且不传翻页标识(ScrollToken、SessionId),可逐次获取前 5000 条数据。

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

使用示例

以下将以搜索视频信息为例介绍搜索语句,发送请求前需要对请求参数做URL编码,同时语句中使用的等号、双引号、单引号、括号必须为英文半角。

返回字段

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

  1. Fields=Title,CoverURL

请求示例:

  1. http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
  2. &Fields=Title,CoverURL

精确匹配

查询 VideoId 值为 28ba2b26d540446c94cdd2c4c48090e5 的视频信息:

  1. VideoId='28ba2b26d540446c94cdd2c4c48090e5'

请求示例:

  1. http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
  2. &Match=VideoId='28ba2b26d540446c94cdd2c4c48090e5'

模糊匹配

Title 中包含 音乐,可以写成:

  1. Title='音乐'

或者写成

  1. Title in ('音乐')

请求示例:

  1. http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
  2. &Match=Title='音乐'

多值查询

查询 Status 值为 NormalChecking

  1. Status in ('Normal','Checking')

请求示例:

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

范围查询

使用开闭区间表示范围,CreationTime 位于 2018-01-01T00:00:00Z2018-02-01T00:00:00Z之间:

  1. CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')

请求示例:

  1. http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
  2. &Match=CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')

如果只有左边界或右边界,对应右边界或左边界值为空即可,如 CreationTime 大于 2018-01-01T00:00:00Z

  1. CreationTime=('2018-01-01T00:00:00Z',)

请求示例:

  1. http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
  2. &Match=CreationTime=('2018-01-01T00:00:00Z',)

排序字段

按创建时间倒排:

  1. CreationTime:Desc

请求示例:

  1. http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia
  2. &SortBy=CreationTime:Desc