メディアアセット検索のサポート対象フィールドと構文 - Intelligent Media Services (IMS)

メディアアセット検索サービスでは、指定されたフィールドと検索タイプに基づいてメディアアセットをクエリできます。このトピックでは、各検索フィールドとそれに対応する検索タイプについて説明します。

使用上の注意

SearchMedia 操作を呼び出し、このトピックで説明されているように Match リクエストパラメーターを設定します。たとえば、Match を title = 'China' and mediaId == 'id' and utcCreate = ('1693367158561','1693367158562') のように設定します。次の表に構文を示します。

Match フィールド	説明
title、mediaId、utcCreate	検索フィールド。
=、==	検索タイプ。
()、および	関係文字。

重要

OpenAPI を呼び出す際は、Match リクエストパラメーターを URL エンコードする必要があります。また、等号、二重引用符、一重引用符、丸括弧は半角文字を使用してください。

検索フィールド

メディアアセット検索サービスでは、動画、音声ファイル、画像、補助メディアアセットを検索できます。次の表に、検索フィールドとサポートされている検索タイプを示します。表では、✔️ はサポート、❌ は非サポートを示します。

検索フィールド	データ型	説明	完全一致	あいまい一致	複数値クエリ	範囲クエリ
title	String	メディアアセットのタイトル。	❌	✔️	❌	❌
description	String	メディアアセットの説明。	❌	✔️	❌	❌
tagList	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：音声説明画像と音声/動画ファイルを同時に検索することはできません。デフォルトでは、動画が検索されます。	✔️	❌	✔️	❌

status の値	説明
0	初期化中。
1	準備中。
2	準備に失敗しました。
3	正常。
10	アップロード中。
12	アップロード済み。
13	トランスコード中。
14	トランスコードに失敗しました。
15	レビュー中。
16	レビューに失敗しました。
17	削除済み。
18	アップロードに失敗しました。

検索タイプ

メディアアセット検索サービスは、完全一致、あいまい一致、複数値クエリ、範囲クエリの 4 つの検索タイプをサポートしています。

検索タイプ	説明	構文	例
完全一致	フィールド値が完全に一致するドキュメントを検索します。	field == 'value'	mediaId == '39167e4066a071ee8013e7e7c56b****'
あいまい一致	指定された文字列を含むドキュメントを検索します。文字列は 60 文字を超えることはできません。	field = 'value'	title = 'I love you China'
複数値クエリ	複数の値でフィルターします。指定された値のいずれかに一致する場合、ドキュメントが返されます。最大 3 つの値を指定できます。	field in ('value1','value2','value3')	status in ('3','12','18')
範囲クエリ	フィールド値が指定された範囲内にあるドキュメントを検索します。開区間または閉区間を定義できます。	field = ('value1','value2')	utcCreate = ('1693367158561','1693367158562')

関係文字

関係文字	説明	構文
and	2 つのフィルター条件を接続します。両方の条件に一致するドキュメントを返します。説明最大 5 つの論理的な組み合わせを使用できます。	field1 = 'value' and field2 = 'value'
or	2 つのフィルター条件を接続します。いずれかの条件に一致するドキュメントを返します。説明最大 5 つの論理的な組み合わせを使用できます。	field1 = 'value1' or field2 = 'value2'
( )	丸括弧。範囲クエリに使用されます。	field = ('value1','value2')
' '	一重引用符。クエリ値を一重引用符で囲みます。	field = 'value'
,	コンマ。複数値クエリで値を区切るために使用されます。	field in ('value1','value2')
( ) [ ]	開区間と閉区間。範囲クエリに使用されます。丸括弧 () は境界値を含まず、角括弧 [] は境界値を含みます。	field = ['value1','value2']
in	複数値クエリに使用されます。指定された値のいずれかに一致するドキュメントを返します。最大 3 つの値を指定できます。	field in ('value1','value2')