全部产品
Search

搜索本产品

    视频点播：搜索媒资信息

    文档中心

    视频点播：搜索媒资信息

    更新时间：Feb 01, 2024

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

    使用方式

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

    • 通过控制台搜索

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

    • 通过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编码。

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

    分类

    描述

    返回字段

    媒资搜索接口默认返回媒资基本信息，当需要附加其他媒资信息时需要指定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

    相关文档