入門
アカウントのプレイリストは、q
上記の呼び出しのパラメータは、提供されているビデオ検索機能と同様です。ただし、注意してくださいはるかに少ない数のフィールドを検索できます、およびプレイリストに含まれるビデオのプロパティではなく、プレイリストのプロパティのみが検索されること。
修飾されていない/デフォルトの用語は、プレイリストの名前、reference_id、またはidフィールドで一致するテキストを検索します。たとえば、?q=news+2016
それらが存在する場合、次のいずれかに一致します。
- 名前の付いたプレイリスト
Exciting 2016 News
- IDが2016のプレイリスト
- プレイリスト
reference_id
のnews 2016
上記のように、提供される複数の用語は次のとおりです。OR
一緒に編集すると、指定された用語の1つ以上を含む文字列が返されます。提供される値は茎、単語のバリエーションが一致します。プレフィックスマッチングはない現在サポートされています。たとえば、p*
「p」で始まる結果は返されません。また、play*
「プレイリスト」を含む結果を返します。
無視された単語
特定の単語は、実際に検索しているものとは無関係に多くの結果を返す可能性があるため、検索文字列では無視されます。以下は、検索によって無視される単語のリストです。
「a」,「an」,「と」,「ある」,「として」,「ある」,「ある」,「bt」,「by」,「のために」,「もし」,「で」,「に」,「ある」,「それは」,「ない」,「の」,「の」,「on」,「or」,「そのような」,「その」,「その」,「彼ら」,「それから」,「そこに」,「これらの」,「彼ら」,「これ」,「へ」,「た」,「意志を」,「と」
フィールド
特定のフィールドは、を使用してクエリできます{field:}{value}
などの構文?q=news+2016+type:EXPLICIT
。この方法で提供されるフィールドは、完全に一致する必要があります。他の用語のように、これらはOR
'ed。
現在、次のフィールドがサポートされています。
- タイプ
- name
- 説明
- reference_id
必要な条件
用語の前にURIエンコードされたものを付けることで用語を要求できます+
符号(%2B)-例:q=name:%2Bnews+%2B2016
(「ニュース」と「2016」の両方を含む名前のプレイリストのみが返されます)。
除外される用語
URIエンコードされた接頭辞用語-
その用語のプレイリストを除外するために署名します。例えば:q=name:%2Bnews+%2D2016
「ニュース」を含む名前の動画が返されますがない「2016」を含む。
ステミング
ステミング 単語の語根を保存して検索することを指します。つまり、「再生」、「再生」、「再生」、「再生」などの用語はすべて「再生」として保存され、これらの用語のいずれかを検索すると、それに応じて検索が翻訳されます。 「遊び」を検索します。語幹は単語のルートにのみ適用され、単語の先頭または一部である文字列には適用されません。したがって、name:play
「play」、「played」、「playing」、「playable」を含む名前の動画を返しますが、「display」または「playlist」を含む名前の動画は返しません。
および/または
検索条件をAND
そしてOR
論理演算子。あいまいさを避けるために(AND
演算子または検索文字列の一部?)、論理演算子の前にある用語を次のように括弧で囲む必要があります。
q=(Really Short Videos) AND type:EXPLICIT
エンコードすると、この検索リクエストは次のようになります。
q=name:%28Really%20Short%20Videos%29%20type:EXPLICIT
完全な例
タイプで検索
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=type:ACTIVATED_NEWEST_TO_OLDEST
除外した名前で検索
https://cms.api.brightcove.com/v1/accounts/account_id/playlists?q=%2Bname=morningnews+%2Ddecription=weekend