媒资搜索协议 - 视频点播

查询语法：Syntax

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

注意

调用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	禁用	禁用离线下载

取值	描述	备注
general	点播上传	普通上传
short_video	短视频SDK	通过短视频SDK上传文件至点播，更多信息，请参见短视频SDK
editing	剪辑合成	通过云剪辑合成上传文件至点播，更多信息，请参见视频合成
live	直播录制	通过直播录制上传文件至点播

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