APIを使用した値検索の実装
この項では、対話Webサービスのリクエストとレスポンスの例を示し、値検索で使用できるパラメータについて説明します。
「値検索問合せの形式」
値検索問合せを作成するには、
ValueSearchConfig
タイプを使用して、
SearchTerm
要素と、オプションで検索する属性を指定します。
「値検索問合せの構築」
ValueSearchConfig
タイプを使用するリクエストを発行して、値検索問合せを作成します。
「特定の属性への値検索の制限」
値検索問合せには、多くの結果が含まれる可能性があります。
RestrictToProperties
属性を使用して、返される結果の数を1つ以上の指定属性のリストに制限できます。
「属性当たりの結果数の制限」
値検索の結果を制限するには、
ValueSearchConfig
の
MaxPerProperty
属性を使用して、各レコード属性に返す値の数を指定する方法もあります。
「一致する結果数の取得」
値検索リクエストへの標準的なレスポンスには、常に、一致した値の合計数に関する情報、およびそのすべてがこのリクエストで返されたかどうかが含まれます。この情報は、
PropertyMatches
要素の
TotalValuesCount
属性と
HasMore
属性で返されます。
「結果の順序付け」
値検索の結果は、レコード属性によってグループ化された値で構成されます。結果リストの属性は、アルファベットの昇順で返されます。
「結果の関連性ランキングの方針の指定」
値検索リクエストのためにレスポンスで取得された結果の順序をランク付けするために、
RelevanceRankingStrategy
属性を使用できます。