SearchResponse

SearchService.Search メソッドに対するレスポンス メッセージ。

JSON 表現 
{
  "results": [
    {
      object (SearchResult)
    }
  ],
  "facets": [
    {
      object (Facet)
    }
  ],
  "totalSize": integer,
  "attributionToken": string,
  "redirectUri": string,
  "nextPageToken": string,
  "correctedQuery": string,
  "summary": {
    object (Summary)
  },
  "appliedControls": [
    string
  ],
  "queryExpansionInfo": {
    object (QueryExpansionInfo)
  },
  "naturalLanguageQueryUnderstandingInfo": {
    object (NaturalLanguageQueryUnderstandingInfo)
  },
  "sessionInfo": {
    object (SessionInfo)
  },
  "searchLinkPromotions": [
    {
      object (SearchLinkPromotion)
    }
  ],
  "semanticState": enum (SemanticState)
}
フィールド
results[]

object (SearchResult)

一致するドキュメントのリスト。順序はランキングを表します。
facets[]

object (Facet)

ユーザーがリクエストしたファセットの結果。
totalSize

integer

ページネーションに関係なく、一致したアイテムの想定合計数。ページネーションで返される results の数は、一致する totalSize よりも少ない場合があります。
attributionToken

string

一意の検索トークン。これは、この検索の結果として得られる UserEvent ログに含まれる必要があります。これにより、検索モデルのパフォーマンスを正確に特定できます。また、カスタマー サポートのシナリオでリクエストを特定する場合にも役立ちます。
redirectUri

string

顧客が定義したリダイレクト ページの URI。リダイレクト アクションがトリガーされると、検索は実行されず、レスポンスには redirectUri と attributionToken のみが設定されます。
nextPageToken

string

次のページを取得するために SearchRequest.page_token として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。
correctedQuery

string

スペルチェックで修正されたクエリが含まれます（見つかった場合）。スペル修正のタイプが AUTOMATIC の場合、検索結果は correctedQuery に基づきます。それ以外の場合は、元のクエリが検索に使用されます。
summary

object (Summary)

検索結果の一部としての要約。このフィールドは、SearchRequest.ContentSearchSpec.summary_spec が設定されている場合にのみ返されます。
appliedControls[]

string

省略可。Control サービスの一部として適用されるコントロール。
queryExpansionInfo

object (QueryExpansionInfo)

返された結果のクエリ拡張情報。
naturalLanguageQueryUnderstandingInfo

object (NaturalLanguageQueryUnderstandingInfo)

出力専用。返された結果の自然言語クエリ理解情報。
sessionInfo

object (SessionInfo)

セッション情報。

SearchRequest.session が指定されている場合にのみ設定されます。詳しくは、説明をご覧ください。
semanticState

enum (SemanticState)

出力専用。検索レスポンスのセマンティック状態を示します。

Facet

ファセットの結果。

JSON 表現 
{
  "key": string,
  "values": [
    {
      object (FacetValue)
    }
  ],
  "dynamicFacet": boolean
}
フィールド
key

string

このファセットのキー。たとえば、"colors" や "price" です。SearchRequest.FacetSpec.FacetKey.key と一致します。
values[]

object (FacetValue)

このフィールドのファセット値。
dynamicFacet

boolean

ファセットが動的に生成されるかどうか。

FacetValue

値の名前とその数を含むファセット値。

JSON 表現 
{
  "count": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "value": string,
  "interval": {
    object (Interval)
  }
  // End of mutually exclusive fields.
}
フィールド
count

string (int64 format)

このファセット値を持つアイテムの数。
値を含むファセット値。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
value

string

ファセットのテキスト値（ファセット colors の Black など）。
interval

object (Interval)

ファセットのインターバル値（ファセット price の [10, 20] など）。SearchRequest.FacetSpec.FacetKey.intervals と一致します。
相互に排他的なフィールドの終了。

QueryExpansionInfo

クエリ拡張に関する情報（拡張が行われたかどうかなど）。

JSON 表現 
{
  "expandedQuery": boolean,
  "pinnedResultCount": string
}
フィールド
expandedQuery

boolean

クエリ拡張が行われたかどうかを示すブール値。
pinnedResultCount

string (int64 format)

固定された結果の数。このフィールドは、拡張が行われ、SearchRequest.QueryExpansionSpec.pin_unexpanded_results が true に設定されている場合にのみ設定されます。

NaturalLanguageQueryUnderstandingInfo

入力クエリに対して行われた自然言語理解について説明する情報。

JSON 表現 
{
  "extractedFilters": string,
  "rewrittenQuery": string,
  "classifiedIntents": [
    string
  ],
  "structuredExtractedFilter": {
    object (StructuredExtractedFilter)
  }
}
フィールド
extractedFilters

string

入力クエリから抽出されたフィルタ。
rewrittenQuery

string

抽出されたフィルタを除いた、書き換えられた入力クエリ。
classifiedIntents[]

string

入力クエリから分類されたインテント。
structuredExtractedFilter

object (StructuredExtractedFilter)

入力クエリから抽出されたフィルタが構造化形式で表されます。

StructuredExtractedFilter

入力クエリから抽出されたフィルタが構造化形式で表されます。

JSON 表現 
{
  "expression": {
    object (Expression)
  }
}
フィールド
expression

object (Expression)

構造化された形式で入力クエリから抽出されたフィルタを示す式。単一の文字列、数値、位置情報の制約を示す単純な式にすることも、論理演算子（OR、AND）を使用して複数の式を組み合わせた複合式にすることもできます。

式

入力クエリから抽出されたフィルタを示す式。

JSON 表現 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringConstraint": {
    object (StringConstraint)
  },
  "numberConstraint": {
    object (NumberConstraint)
  },
  "geolocationConstraint": {
    object (GeolocationConstraint)
  },
  "andExpr": {
    object (AndExpression)
  },
  "orExpr": {
    object (OrExpression)
  }
  // End of mutually exclusive fields.
}
フィールド
式のタイプ。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
stringConstraint

object (StringConstraint)

文字列制約式。
numberConstraint

object (NumberConstraint)

数値制約式。
geolocationConstraint

object (GeolocationConstraint)

位置情報制約式。
andExpr

object (AndExpression)

複数の式を接続する論理 AND 複合演算子。
orExpr

object (OrExpression)

複数の式を接続する論理演算子 OR 複合演算子。
相互に排他的なフィールドの終了。

StringConstraint

文字列フィールドの制約式。

JSON 表現 
{
  "fieldName": string,
  "values": [
    string
  ],
  "querySegment": string
}
フィールド
fieldName

string

スキーマで定義されている文字列フィールドの名前。
values[]

string

文字列フィールドの値。フィールド値がここで指定された値のいずれかに一致する場合にのみ、レコードが返されます。
querySegment

string

検索クエリ内のキーワードのうち、フィルタに一致するものを特定します。

NumberConstraint

数値フィールドの制約式。例: price < 100

JSON 表現 
{
  "fieldName": string,
  "comparison": enum (Comparison),
  "value": number,
  "querySegment": string
}
フィールド
fieldName

string

スキーマで定義されている数値フィールドの名前。
comparison

enum (Comparison)

フィールド値と制約で指定された値の間で実行される比較演算。
value

number

数値制約で指定された値。
querySegment

string

検索クエリ内のキーワードのうち、フィルタに一致するものを特定します。

比較

実行された比較オペレーション。

列挙型
COMPARISON_UNSPECIFIED 比較演算子が未定義です。
EQUALS =（等価）演算子を示します。
LESS_THAN_EQUALS <=（以下）演算子を表します。
LESS_THAN <（より小さい）演算子ことを示します。
GREATER_THAN_EQUALS >=（以上）演算子を表します。
GREATER_THAN >（より大きい）演算子を示します。

GeolocationConstraint

位置情報フィールドの制約。スキーマで定義されている位置情報フィールドの名前。

JSON 表現 
{
  "fieldName": string,
  "address": string,
  "latitude": number,
  "longitude": number,
  "radiusInMeters": number
}
フィールド
fieldName

string

スキーマで定義されている位置情報フィールドの名前。
address

string

入力クエリから推測された基準住所。基準住所と位置情報フィールドの距離に基づいて結果がフィルタされます。
latitude

number

入力クエリから推測された位置情報の緯度。
longitude

number

入力クエリから推測された位置情報の経度。
radiusInMeters

number

住所を中心とした半径（メートル単位）。位置情報フィールドの位置が半径内にある場合、レコードが返されます。

AndExpression

論理 And 演算子

JSON 表現 
{
  "expressions": [
    {
      object (Expression)
    }
  ]
}
フィールド
expressions[]

object (Expression)

AND 結合された式。

OrExpression

論理 Or 演算子

JSON 表現 
{
  "expressions": [
    {
      object (Expression)
    }
  ]
}
フィールド
expressions[]

object (Expression)

OR 演算子で結合された式。

SessionInfo

セッションに関する情報。

JSON 表現 
{
  "name": string,
  "queryId": string
}
フィールド
name

string

セッションの名前。自動セッション モードが使用されている場合（SearchRequest.session が - で終わる場合）、このフィールドには新しく生成されたセッション名が格納されます。
queryId

string

この検索 API 呼び出しに対応するクエリ ID。1 つのセッションに複数のターンを含めることができ、各ターンに一意のクエリ ID が割り当てられます。

Answer API 呼び出しでセッション名とこのクエリ ID を指定すると、この検索呼び出しの検索結果のコンテキストで回答が生成されます。

SemanticState

検索レスポンスのセマンティック状態。

列挙型
SEMANTIC_STATE_UNSPECIFIED デフォルト値。これは使用しないでください。
DISABLED この検索レスポンスではセマンティック検索が無効です。
ENABLED この検索レスポンスではセマンティック検索が有効です。