媒资搜索协议_附录_服务端API

描述

本文主要介绍了视频点播媒资搜索协议的语法，需要与搜索媒资信息接口配合使用。该协议是集检索、过滤、排序和翻页于一体的实时搜索协议，用于搜索视频点播生产的视频、音频和图片等媒资信息。

根据媒资搜索协议中定义的语法规则将媒资字段分为返回字段，精确匹配，模糊匹配，多值查询，范围查询 和 排序字段，视频点播支持的所有媒资字段及适用的语法规则请参考媒资信息。

注意：调用OpenAPI接口时，需要对查询语句进行URL编码，同时查询语句中使用的等号、双引号、单引号、括号必须为英文半角，搜索协议中包含的特殊字符说明详见特殊字符说明。

以下为媒资搜索协议定义的语法及示例：

名称	含义	语法	示例
返回字段	指定搜索返回结果中包含哪些字段，默认只返回媒体ID，创建时间和媒体类型	field1,field2	返回字段
精确匹配	用于搜索与指定字段值完全相等的文档	field = value	精确匹配
模糊匹配	搜索包含指定字符或字符串的文档	field in ('value1','value2') 或 field = 'value'	模糊匹配
多值查询	可以指定多个字段进行过滤，只要命中其中一个字段值的文档即返回	field in ('value1','value2')	多值查询
范围查询	开闭区间规则，匹配字段值在指定范围内的文档	field = (value1,value2)	范围查询
排序字段	用于排序搜索结果的字段值，同时需要为每个字段指定排序方向 (Desc或Asc)。多个排序字段时，从左至右排序优先级从高至低	SortBy=field:Desc	排序字段

名称	描述	语法
and	位于两个过滤条件之间，表示两个过滤条件同时命中的文档才会返回	field1 = 'value' and field2 = 'value'
or	位于两个过滤条件之间，表示命中两个过滤条件之一的文档即可返回，此时过滤条件需要以左括号"("开始，右括号")"结束	(field1 = 'value1' or field2 = 'value2')
( )	括号。范围查询	field = ('value1','value2')
( )	括号。表示多个查询条件之间的或关系	(field1 = 'value1' or field2 = 'value2')
' '	单引号。当指定的查询字段为字符串类型时，字段值需要以单引号开始，单引号结束	field = 'value'
,	逗号。多值查询使用。用于分隔多个查询值	field in ('value1','value2')
( ) [ ]	开闭区间规则。表示大于、小于、大于等于、小于等于。范围查询使用，表示边界值的大小关系	field = ['value1','value2']
in	多值查询使用。当文档中的字段值在所列举的值中时，该文档返回	field in ('value1','value2')

视频点播目前支持对视频、音频和图片信息的搜索，各字段支持的查询语法规则如下：

注意：VideoId为多值查询时，最多支持传入100个视频ID

预处理完成后的视频才可用于直播导播。

视频离线下载开关状态，只有状态开启时才允许离线下载。

取值	描述	备注
on	开启	初始状态，允许离线下载
off	禁用	禁用离线下载

媒体信息来源。

文件上传至点播后，经过不同视频处理后才可用于播放。不同转码模式处理的方式不同。