Method: query.sources.list

ユーザーが query.search API と Suggestion API に使用できるソースのリストを返します。

注: この API を実行するには、標準のエンドユーザー アカウントが必要です。サービス アカウントでは Query API リクエストを直接実行できません。サービス アカウントを使用してクエリを実行するには、Google Workspace ドメイン全体の権限の委任を設定します。

HTTP リクエスト

GET https://cloudsearch.googleapis.com/v1/query/sources

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
requestOptions

object (RequestOptions)

検索アプリケーションやユーザーのタイムゾーンなどのリクエスト オプション。
pageToken

string

レスポンスで返すソースの数。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

ソースのレスポンスを一覧表示します。

JSON 表現 
{
  "sources": [
    {
      object (QuerySource)
    }
  ],
  "nextPageToken": string
}
フィールド
sources[]

object (QuerySource)
nextPageToken

string

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud_search.query
  • https://www.googleapis.com/auth/cloud_search

詳細については、承認ガイドをご覧ください。

QuerySource

ユーザーがクエリ API を使用して検索できるソースのリスト。

JSON 表現 
{
  "source": {
    object (Source)
  },
  "shortName": string,
  "displayName": string,
  "operators": [
    {
      object (QueryOperator)
    }
  ]
}
フィールド
source

object (Source)

ソースの名前
shortName

string

ソースの略称またはエイリアス。この値は 'source'演算子を使用します。
displayName

string

データソースの表示名。
operators[]

object (QueryOperator)

このソースに適用されるすべての演算子のリスト。

QueryOperator

query.search/query.suggest リクエストで使用できる演算子の定義。

JSON 表現 
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string,
  "type": enum (QueryOperator.Type),
  "displayName": string,
  "isSortable": boolean,
  "isFacetable": boolean,
  "isReturnable": boolean,
  "isRepeatable": boolean,
  "isSuggestable": boolean,
  "enumValues": [
    string
  ],
  "objectType": string
}
フィールド
operatorName

string

事業者の名前。
lessThanOperatorName

string

小なり演算子を使用してプロパティの分離に使用できる演算子名を示します。
greaterThanOperatorName

string

大なり演算子を使用してプロパティの分離に使用できる演算子名を示します。
type

enum (QueryOperator.Type)

演算子のタイプ。
displayName

string

事業者の表示名
isSortable

boolean

この演算子は結果の並べ替えに使用できますか？
isFacetable

boolean

この演算子を使用してファセットを取得できますか？
isReturnable

boolean

このファセットに関連付けられたプロパティは、検索結果の一部として返されます。
isRepeatable

boolean

このプロパティに複数の値を設定できるかどうかを示します。
isSuggestable

boolean

このフィールドの候補を取得できます。
enumValues[]

string

opeatror フィールドの潜在的な値のリスト。このフィールドは、この演算子の有効な値すべてを安全に列挙できる場合にのみ入力されます。
objectType

string

演算子に対応するオブジェクトの名前。このフィールドは、スキーマ固有の演算子に対してのみ入力され、一般的な演算子では設定されません。

QueryOperator.Type

演算子によって参照されるプロパティの型。

列挙型
UNKNOWN 無効な値です。
INTEGER
DOUBLE
TIMESTAMP
BOOLEAN
ENUM
DATE
TEXT
HTML