クエリ演算子

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

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

完全一致に使用する""

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

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

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

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

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

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

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

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

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

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

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

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