クエリ演算子

ガイド 検索 クエリ演算子

クエリ演算子

GET /search APIでは、APIによって返された結果を絞り込むのに役立つさまざまなクエリ演算子がサポートされています。

これらの演算はすべて、検索の作成時にqueryパラメータに渡されます。

完全一致に使用する""

クエリを二重引用符 ("") で囲むと、APIによって完全一致のみが返されます。完全一致検索では、特定の文字の並びに基づいた検索結果は返されません。代わりに、フレーズ (つまり、単語の並び) に基づいた一致が返されます。

たとえば、"Blue-Box"を検索すると、"blue.box""Blue Box""Blue-Box"などの並びを含む、検索結果が返されます。つまり、BlueおよびBoxという単語が指定した順序で連続して含まれている項目です。

複数用語の一致に使用するAND

AND演算子を使用すると、検索では、演算子の左側と右側にある検索用語を両方とも含む項目が返されます。

たとえば、marketing AND BoxWorksを検索すると、marketingBoxWorksの両方が任意の順番でテキストに含まれている項目が返されます。テキストにBoxWorksのみが含まれる結果は返されません。

いずれかの検索用語の一致に使用するOR

OR演算子を使用すると、検索では、演算子の左側と右側にある検索用語のいずれかを含む項目が返されます。

たとえば、marketing OR BoxWorksを検索すると、marketingBoxWorksのいずれかがテキストに含まれている結果が返されます。サポートされている別のブール条件が使用されている場合を除き、複数語のクエリは暗黙的にORとして解釈されるため、この演算子の使用は必須ではありません。

検索用語の除外に使用するNOT

NOT演算子を使用すると、検索では、演算子に続く用語を含まない項目が返されます。

たとえば、marketing AND NOT BoxWorksを検索すると、テキストにmarketingのみが含まれている結果が返されます。BoxWorksが含まれる結果は省略されます。

小文字の演算子 (andorおよびnot) および大文字と小文字を組み合わせた演算子 (AndOrおよびNot) はサポートされていないことに注意してください。

Boxコミュニティの記事で、Boxでの検索に関する最新情報を確認する