Mediaモジュールでビデオとプレイリストを検索する方法

Mediaモジュールには、Video Cloud アカウントの動画を検索するために使用できる検索フィールドがあります。

次のような検索を行うことができます。

動画検索
プレイリスト検索
高度な検索
保存した検索

動画検索

用語集

このセクションでの、完全とは、検索文字列がダブルクォーテーションで囲まれている状態を指します。例えば:

完全検索	非完全検索
”グレートブルー”	グレートブルー
`name` :"グレートブルー"	`name` :グレートブルー

完全一致はダブルクォーテーション内のすべての用語が一致する必要がありますが、完全に一致しない場合があります。たとえば、"running water" で検索すると、タイトルや説明に説明文に water runs downhill などを含む動画が返される可能性があります。

アカウント内の動画を検索するには、検索フィールドに検索語を入力します。デフォルトでは、検索はビデオに対して実行されます。

複数のビデオ ID を検索するには、次の構文を使用します。 id: xxx id: xxx id: xxx。例えば、id:5985323381001 id:5715142164001。

プレイリストを検索したり、高度な検索条件を入力することもできます。

次のビデオフィールドが検索されます:

ビデオ ID ( id )
名前 ( name )
簡単な説明 ( description )
長い説明 ( long_description) )
タグ ( tags )
参照 ID ( reference_id )
カスタムフィールド ( custom_fieldsまたは{field_name} )

動画フィールドのクエリサポートは異なります。部分単語検索とステミング検索に対応するフィールドもあれば、対応しないフィールドもあります。

検索フィールド	対応	非対応	例
名前と説明	1つまたは複数の単語全体の完全一致; ステミングに対応	部分単語は非対応	`name:"great blue"` は `"Great Blue Heron"`と一致します。 `name:"great blu"` は `"Great Blue Heron"`とは一致しません。 `name:great blu` は `"Great Blue Heron"`と一致します。
ビデオ ID	完全一致のみ	部分単語やステミングは非対応。	5591838791001 は、ID 5591838791001 と一致しますが、ID 5591838791 とは一致しません。
タグ	単語全体にのみマッチします。	部分単語やステミングは非対応です。	`tags:publ` は、タグ `"public"` 持つ動画にはマッチしません。
参照ID	参照 ID (最初の 3 文字) で始まる部分文字列の部分一致と、文字列全体の一致に対応。	参照 ID で始まらない部分文字列には非対応。	`reference_id:myv`は、参照ID"myvid1"を持つ動画と一致します。 `reference_id:"myv"`は、参照ID `"myvid1"`の動画と一致しません。
日付フィールド		テキストボックスでは検索不可、高度な検索を使用して検索可能
テキストタイプのカスタムフィールド	1つまたは複数の単語全体に一致し、ステミングに対応。完全な検索文字列の場合、全単語一致のみ。	部分単語は非対応。	`custom_fields:place` は、カスタムフィールドの値が`"places"`の動画に一致します。 `custom_fields:plac` は、カスタムフィールドの値が`"places"`の動画には一致しません。 `custom_fields:"place"` は、カスタムフィールドの値が`"places"`の動画に一致しません。
リストタイプのカスタムフィールド	1つまたは複数の単語全体に一致し、ステミングに対応。完全な検索文字列の場合、全単語一致のみ。	部分単語は非対応	`topic:place` は、リスト型カスタムフィールドの値が "places "の動画にマッチします。 `topic:plac` は、リスト型カスタムフィールドの値が `"places"`の動画に一致しません。 `topic:"place"` は、リスト型カスタムフィールドの値が `"places"`の動画に一致しません。

ステミングとは？

ステミングをサポートするビデオフィールドは検索単語の語幹が共通に持つ単語を返します。また、ステミングでは、部分的な単語ではなく、単語全体の入力のみがサポートされます。

例 1:running を検索すると、、running, run, runsを含む結果が返されます。
例 2:vid で検索しても、video を含む結果は返されません。

一般的なルール

完全一致の場合は、文字列をダブルクォーテーションで囲みます。
デフォルトでは、Video Cloud は単語間の OR 論理演算子を想定しています。
検索は大文字と小文字を区別しません。

例

検索用語	戻り値
`financial planning`	`financial` または `planning`を含むすべての動画。
`"financial planning"`	「`financial` と `planning` を含むすべての動画。ダブルクォーテーションは、一致する動画がすべての用語を持つことを保証しますが、正確な用語ではない可能性があることに注意してください。例えば、ここでの検索キーワードは、タイトルや説明文に `finance` や `plan` を含む動画も返すかもしれません。
walk	walk、walks、walking を含むすべての動画。

プレイリスト検索

アカウント内のプレイリストを検索するには、検索フィールドに検索用語を入力し、 プレイリスト オプションをクリックします。

ページの本文にプレイリストのリストが表示されます。

高度な検索

詳細検索では、検索修飾子を使用して特定のフィールドの値を検索できます。たとえば、ビデオ名やタグフィールドのみを検索対象とするように指定できます。また、特定の用語を含む動画を除外することもできます。例えば、スポーツを含むビデオを検索して、野球を含む動画を除外することができます。詳細検索のダイアログを開くには、その他の検索オプションリンクをクリックします。

以下の条件を使用して、検索をカスタマイズすることができます：

タグ
日付範囲
含めるテキスト
除外するテキスト
プレイ可能

日付範囲

詳細検索を使用すると、日付範囲に基づいて動画を返すことができます。検索できる日付は以下の通りです:

作成日 ( created_at )
更新日 ( updated_at )
スケジュールされた開始日 ( schedule.starts_at )
スケジュールされた終了日 ( schedule.ends_at )

この例では、2016 年 3 月 1 日から 2016 年 3 月 31 日の間に作成されたすべての動画を返します。

削除/追加ボタンを使用して、追加の日付範囲を入力することができます。（）

含めるテキスト

高度な検索を使用すると、ビデオのメタデータ内のテキストに基づいてビデオを返すことができます。以下のフィールドを検索できます：

すべて
名前
名前と説明
参照ID
カスタムフィールド
特定のカスタムフィールド

アカウントに Year と「Subject」という 2 つのカスタムフィールドがあるとします。これは、Year カスタムフィールドが 2016 で、 Subject カスタムフィールドに birds が含まれる動画すべてが返されます。

削除/追加ボタンを使用して、追加の条件を入力することができます。（）

除外するテキスト

詳細検索を使用すると、動画メタデータ内のテキストに基づいて動画を除外できます。次のフィールドを検索できます：

名前
名前と説明
参照ID
カスタムフィールド
特定のカスタムフィールド

この例では、名前または説明フィールドに private が含まれる動画はすべて返されません。

削除/追加ボタンを使用して、追加の条件を入力することができます。（）

再生可能

詳細検索を使用すると、ステータスに基づいて動画を返すことができます。

すべて
再生可能
再生不可

検索条件を入力すると、検索ボックスに高度な検索の構文が表示されます。

詳細については、「高度な検索構文」のセクションを参照してください。

高度な検索構文

[詳細検索] ダイアログを使用してビデオを検索すると、検索条件を入力した後に、詳細検索の構文が検索ボックスに表示されます。このセクションでは、検索構文の概要を説明します。詳細検索ダイアログを使用せずに、検索ボックスに検索構文を入力することもできます。詳細検索ダイアログを開くには、[ その他の検索オプション]リンクをクリックします。

検索語を必須（返される動画が一致する必要がある）または除外（返された動画が一致しない必要がある）とマークするには、用語の前後に + または - 記号を追加します。

次の検索修飾子と値がサポートされています。

修飾子	有効な値
`name`	文字列またはダブルクォーテーションで囲まれた文字列
テキスト	文字列またはダブルクォーテーションで囲まれた文字列 ( `name` )
`tags`	文字列またはダブルクォーテーションで囲まれた文字列
`reference_id`	文字列またはダブルクォーテーションで囲まれた文字列
`custom_fields` -すべてのカスタムフィールドを検索します	文字列またはダブルクォーテーションで囲まれた文字列
< `custom_field_name` >-指定したカスタムフィールド名を検索します。	文字列またはダブルクォーテーション付き文字列
`state`^[1]	`ACTIVE` , `INACTIVE` , `PENDING`
`updated_at`	日付範囲
`created_at`	日付範囲
`schedule.starts_at`	日付範囲
`schedule.ends_at`	日付範囲
`published_at`^[2]	日付範囲
`complete`^[3]	`true` または `false`

注

^[1] 動画がアカウントに共有されたが、受け入れられていない場合、動画は保留状態になります。

^[2] ビデオが最後にアクティブ化された日付。

^[3] ビデオに少なくとも1つの再生可能なレンディションがある場合、ビデオは完全な真の状態になります。これは、トランスコードがすべて完了したことを必ずしも意味しません。

日付フィールドの操作

日付フィールドを操作する場合、日付は UTC (2012-08-01T 00:00:00 Z) 形式または相対形式を使用できます：

-1day
-2days
+4hours
-60minutes
-1d
-2d
+4h
-60m

例

複数の検索語句を組み合わせる場合は、スペースで区切り、追加語句が最初の検索語句の一部として解釈されないようにします。

検索用語	戻り値
`+name:florida`	ビデオ名に`Florida` が含まれる、すべての動画
`+text:meeting`	動画名または短い説明文、長い説明文に `meeting` という単語が含まれるすべての動画
`+tags:birds`	`birds` のタグ付けされているすべての動画
`+tags:birds +state:inactive`	`birds` のタグが付けられ、ステータスが `inactive` のすべてのビデオ
`+tags:live,"now playing" +state:ACTIVE`	`live` と `now playing` のタグが付けられ、ステータスが `active` になっているすべての動画
`+custom_fields:"2015"`	カスタムフィールドの値が `2015` であるすべての動画
`+subject:birds`	`subject`カスタムフィールドの値が `birds`であるすべての動画
`+producer:"Bob Bailey"`	`producer` カスタムフィールドの値が `Bob Bailey` であるすべての動画
`+created_at:-3d`	過去 3 日間に作成されたすべての動画
`+updated_at:-1d`	過去に更新されたすべての動画
`+updated_at:-2d +state:INACTIVE`	過去 2 日以内に更新され、`inactive`の動画
`+schedule.starts_at:2015-06-01..2015-06-07`	2015年6月1日から2015年6月6日の間に開始予定のすべての動画
`+updated_at:2015-06-01T13:00:00Z..2015-06-01T15:00:00Z`	2015年6月1日午後1時から午後3時までの間に更新されたすべての動画

検索の保存

頻繁に実行する検索を保存しておけば、検索構文を再入力することなく、すばやく再実行できます。検索したいビデオを返す検索構文を入力したら、[検索の保存] をクリックします。保存した検索の名前を入力し、[保存] をクリックします。

保存した検索を再実行するには、検索ボックスの下にある 保存済み検索リンクをクリックし、実行したい保存した検索をクリックします。

保存した検索を削除するには、検索の横にある削除アイコン（）をクリックします。

無視される単語

特定の単語は、実際に検索しているものとは無関係に多くの結果を返す可能性があるため、検索文字列では無視されます。以下は、検索によって無視される単語のリストです。

a	an	and
are	as	at
be	but	by
for	if	in
into	is	it
no	not	of
on	or	such
that	the	their
then	there	these
they	this	to
was	will	with