媒资搜索过滤说明_智能媒体服务(IMS)-阿里云帮助中心

媒资搜索服务支持按指定的字段和搜索类型进行搜索。通过阅读本文，你可以了解各搜索字段及对应搜索类型的详情。

使用说明

调用SearchMedia，按照本文说明设置对应的入参Match，例如Match设置为title = '中国' and mediaId == 'id' and utcCreate = ('1693367158561','1693367158562')，则对应各字段说明如下：

重要

调用OpenAPI时，需要对入参Match进行URL编码，同时确保等号、双引号、单引号、括号等为半角符号。

媒资搜索服务支持对视频、音频、图片和辅助媒资进行搜索，各搜索字段及支持的搜索类型如下。表格中✔️表示支持，❌表示不支持。

搜索字段	数据类型	说明	精确匹配	模糊匹配	多值查询	范围查询
title	String	视频标题。	❌	✔️	❌	❌
description	String	视频描述。	❌	✔️	❌	❌
tags	String	视频标签。	❌	✔️	✔️	❌
mediaId	String	媒资ID。	✔️	❌	❌	❌
cateId	Long	分类ID。	✔️	❌	❌	❌
status	Integer	状态，取值请参见下表status取值。	✔️	❌	✔️	❌
utcCreate	Long	视频信息创建时间，单位：毫秒。	❌	❌	❌	✔️
utcModified	Long	视频信息更新时间，单位：毫秒。	❌	❌	❌	✔️
fileInfo.storageLocation	String	存储区域。	✔️	❌	✔️	❌
ocrInfo.tracks.content	String	字幕。	❌	✔️	❌	❌
aiLabelInfo.category	String	AI分类。	✔️	❌	❌	❌
aiLabelInfo.label_id	String	内容标签。	✔️	❌	❌	❌
mediaType	String	媒资类型，取值： video：视频。 image：图片。 audio：音频。	✔️	❌	✔️	❌

媒资搜索支持精确匹配、模糊匹配、多值查询、范围查询和排序字段共四种搜索方式。

搜索类型	说明	语法	示例
精确匹配	用于搜索与指定字段值完全相等的文档。	field == 'value'	mediaId == '39167e4066a071ee8013e7e7c56b****'
模糊匹配	搜索包含指定字符串的文档，长度不超过60个字符。	field = 'value'	title = '我爱你中国'
多值查询	可以指定多个字段进行过滤，只要命中其中一个字段即返回。最多支持传入3个字段。	field in ('value1','value2','value3')	status in ('3','12','18')
范围查询	开闭区间规则，匹配字段值在指定范围内的文档。	field = (value1,value2)	utcCreate = ('1693367158561','1693367158562')

关系字符	描述	语法
and	位于两个过滤条件之间，表示两个过滤条件同时命中的文档才会返回。	field1 = 'value' and field2 = 'value'
or	位于两个过滤条件之间，表示命中两个过滤条件之一的文档即可返回。	field1 = 'value1' or field2 = 'value2'
( )	括号，范围查询。	field = ('value1','value2')
' '	单引号，指定的查询字段需要以单引号开始，单引号结束。	field = 'value'
,	逗号，多值查询使用。用于分隔多个查询值。	field in ('value1','value2')
( ) [ ]	开闭区间，范围查询时使用。()表示不包含边界值，[]表示包含边界值。	field = ['value1','value2']
in	多值查询使用，只要命中其中一个字段即返回。最多支持传入3个字段。	field in ('value1','value2')