搜索媒资信息

上传到视频点播媒资库中的视频、音频、图片等媒资,支持对其进行模糊匹配、多值查询、指定返回字段等多方式多维度的搜索、筛选、过滤和排序,以获取到符合搜索条件的媒资信息。本文为您介绍如何通过控制台和API/SDK方式搜索媒资信息。

使用方式

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

  • 通过控制台搜索

    登录视频点播控制台,进入媒资库页面,可以通过媒体名称、媒体ID、标签名称等进行搜索媒资信息。具体操作,请参见媒资管理搜索媒资信息1.png

  • 通过API/SDK搜索

    使用SearchMedia - 搜索媒体信息接口,同时配合媒资搜索协议使用。SearchMedia - 搜索媒体信息接口支持指定返回字段、精确匹配、模糊匹配、多值查询、范围查询等多种方式的查询,支持作为过滤条件的媒资信息包括VideoId、CateId、StorageLocation、Title、Tags等多个字段,详细的搜索语法及规则请参见媒资搜索协议

使用限制

翻页限制

通过API/SDK方式搜索时,为避免深度翻页造成性能问题,媒资搜索限制只返回命中搜索条件的部分数据。如果要获取更多数据、甚至遍历所有数据,则需要使用翻页标记(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

相关文档