- リソース: SearchApplication
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- DataSourceRestriction
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ソース
- Source.PredefinedSource
- FilterOptions
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- Filter
- Filter.ValueFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- Value
- Filter.CompositeFilter
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- Filter.CompositeFilter.LogicOperator
- SourceConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- SourceScoringConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- SourceScoringConfig.SourceImportance
- SourceCrowdingConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ScoringConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- SortOptions
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- SortOptions.SortOrder
- FacetOptions
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- IntegerFacetingOptions
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- QueryInterpretationConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- メソッド
リソース: SearchApplication
SearchApplication
JSON 表現 |
---|
{ "name": string, "displayName": string, "dataSourceRestrictions": [ { object ( |
フィールド | |
---|---|
name |
検索アプリケーションの名前。 形式: searchapplications/{applicationId}。 |
displayName |
検索アプリケーションの表示名。最大長は 300 文字です。 |
dataSourceRestrictions[] |
構成に適用される制限。要素の最大数は 10 です。 |
sourceConfig[] |
dataSourceRestrictions で指定されたソースの構成。 |
scoringConfig |
結果をランク付けするための構成。 |
defaultSortOptions |
検索結果の並べ替えに関するデフォルトのオプション |
defaultFacetOptions[] |
ファセット結果を返すためのデフォルト フィールド。ここで指定したソースは、上記の |
returnResultThumbnailUrls |
結果ごとにサムネイルの URI を返す必要があります(該当する場合)。 |
operationIds[] |
出力専用。このスキーマで現在実行されている長時間実行オペレーション(LRO)の ID。出力専用フィールド。 |
enableAuditLog |
クエリ API で検索アプリケーションに対して行われたリクエストに対して監査ロギングが有効か無効かを示します。 |
queryInterpretationConfig |
クエリ解釈のデフォルト オプション |
DataSourceRestriction
データソースに関する制限。
JSON 表現 |
---|
{ "source": { object ( |
フィールド | |
---|---|
source |
制限のソース。 |
filterOptions[] |
結果を制限するフィルタ オプション。複数のフィルタが存在する場合は、結合する前にオブジェクト タイプ別にグループ化されます。同じオブジェクト タイプを持つフィルタは連結して結合され、その後、結果の式は分離して結合されます。 要素の最大数は 20 です。 注: Suggestion API で現在サポートされているフィルタは、「objecttype」、「type」のごく一部のみです。「mimetype」を指定します。現時点では、スキーマ固有のフィルタを使用して候補をフィルタすることはできません。 |
ソース
候補/検索 API のソースを定義します。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド
|
|
name |
|
predefinedSource |
Google Apps の事前定義されたコンテンツ ソース。 |
Source.PredefinedSource
事前定義されたソース:
列挙型 | |
---|---|
NONE |
|
QUERY_HISTORY |
ユーザーが過去に発行したクエリを提案します。Suggestion API で使用する場合にのみ有効です。クエリ API で使用する場合は無視されます。 |
PERSON |
組織内のユーザーを示唆する。Suggestion API で使用する場合にのみ有効です。クエリ API で使用すると、エラーが発生します。 |
GOOGLE_DRIVE |
|
GOOGLE_GMAIL |
|
GOOGLE_SITES |
|
GOOGLE_GROUPS |
|
GOOGLE_CALENDAR |
|
GOOGLE_KEEP |
FilterOptions
クエリに適用するフィルタ オプション。
JSON 表現 |
---|
{
"objectType": string,
"filter": {
object ( |
フィールド | |
---|---|
objectType |
objectType が設定されている場合、そのタイプのオブジェクトのみが返されます。これは、スキーマの定義内で登録されたオブジェクトの名前に対応している必要があります。最大長は 256 文字です。 |
filter |
検索を制限する汎用フィルタ( |
フィルタ
クエリでフィルタを表現する一般的な方法で、次の 2 つのアプローチがサポートされています。
1. ValueFilter の設定。名前は、データソースのスキーマで定義されたオペレーター名と一致する必要があります。
2. CompositeFilter の設定。フィルタは論理演算子を使用して評価されます。トップレベル演算子に使用できるのは AND または NOT のいずれかです。かつ、最上位レベルにのみ使用できます。OR は、最上位の AND の下にのみ指定できます。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド
|
|
valueFilter |
|
compositeFilter |
|
Filter.ValueFilter
JSON 表現 |
---|
{
"operatorName": string,
"value": {
object ( |
フィールド | |
---|---|
operatorName |
クエリに適用される
|
value |
比較対象の値。 |
値
汎用型での単一の値の定義。
JSON 表現 |
---|
{ // Union field |
フィールド | |
---|---|
共用体フィールド value 。指定されたプロパティの値。value は次のいずれかになります。 |
|
stringValue |
|
integerValue |
|
doubleValue |
|
timestampValue |
RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
booleanValue |
|
dateValue |
|
Filter.CompositeFilter
JSON 表現 |
---|
{ "logicOperator": enum ( |
フィールド | |
---|---|
logicOperator |
サブフィルタの論理演算子。 |
subFilters[] |
サブフィルタ。 |
Filter.CompositeFilter.LogicOperator
列挙型 | |
---|---|
AND |
論理演算子。サブフィルタにのみ適用できます。 |
OR |
|
NOT |
NOT は、1 つのサブフィルタにのみ適用できます。 |
SourceConfig
query.search
リクエストまたは query.suggest
リクエストの処理中のソースの構成。
JSON 表現 |
---|
{ "source": { object ( |
フィールド | |
---|---|
source |
この構成を使用するソース。 |
scoringConfig |
ソースのスコア設定。 |
crowdingConfig |
ソースのクラウディング構成。 |
SourceScoringConfig
スコアリング構成を設定します。これにより、ソースに対する結果のランキングを変更できます。
JSON 表現 |
---|
{
"sourceImportance": enum ( |
フィールド | |
---|---|
sourceImportance |
ソースの重要性。 |
SourceScoringConfig.SourceImportance
あるソースが他のソースよりもランキングで優先されるべきかどうかを示すために使用できるソースの重要度。
列挙型 | |
---|---|
DEFAULT |
|
LOW |
|
HIGH |
SourceCrowdingConfig
検索結果のクラウディングの上限を設定する。クラウディングとは、同じソースまたはホストから複数の結果が「クラウドアウト」する状況です。ユーザーの検索の質が低下します。検索結果における検索の質とソースの多様性を高めるために、ソースごとに繰り返し検索結果を減らす条件を設定できます。
JSON 表現 |
---|
{ "numResults": integer, "numSuggestions": integer } |
フィールド | |
---|---|
numResults |
他のソースからの結果が枯渇しない限り、検索結果ページ内のデータソースから許可される結果の最大数。負の値は指定できません。この値が 0 の場合はデフォルト値が使用されます。クラウディングを無効にするには、100 より大きい値を設定します。 |
numSuggestions |
ソースから許可される候補の最大数。この値が 0 以下の場合、結果に制限は設定されません。 |
ScoringConfig
query.search
または query.suggest
リクエストの処理中のソースの構成のスコアリング。
JSON 表現 |
---|
{ "disableFreshness": boolean, "disablePersonalization": boolean } |
フィールド | |
---|---|
disableFreshness |
鮮度をランキング シグナルとして使用するかどうか。デフォルトでは、鮮度はランキング シグナルとして使用されます。なお、この設定は管理 UI では使用できません。 |
disablePersonalization |
検索結果をカスタマイズするかどうかを指定します。デフォルトでは、成果を高めるためにパーソナル シグナルが使用されます。 |
SortOptions
JSON 表現 |
---|
{
"operatorName": string,
"sortOrder": enum ( |
フィールド | |
---|---|
operatorName |
並べ替えるフィールドに対応する演算子の名前。対応するプロパティを |
sortOrder |
デフォルトの並べ替え順は昇順です。 |
SortOptions.SortOrder
列挙型 | |
---|---|
ASCENDING |
|
DESCENDING |
FacetOptions
ファセット結果を返す演算子を指定します。sourceName、objectType、operatorName の組み合わせごとに 1 つの FacetResult があります。
JSON 表現 |
---|
{
"sourceName": string,
"objectType": string,
"operatorName": string,
"numFacetBuckets": integer,
"integerFacetingOptions": {
object ( |
フィールド | |
---|---|
sourceName |
ファセットのソース名。形式: datasources/{sourceId}。空の場合、すべてのデータソースが使用されます。 |
objectType |
ObjectType が設定されている場合、そのタイプのオブジェクトのみがファセットの計算に使用されます。空の場合、すべてのオブジェクトがファセットの計算に使用されます。 |
operatorName |
ファセットに選択された演算子の名前。@cloudsearch.SchemaPropertyOptions をご覧ください |
numFacetBuckets |
このファセットに対して返されるファセット バケットの最大数。デフォルトは 10 です。最大値は 100 です。 |
integerFacetingOptions |
設定されている場合、指定された整数プロパティの整数ファセット オプションを記述します。スキーマ内の対応する整数プロパティは、isFacetable とマークする必要があります。返されるバケットの数は、こ と numFacetBuckets の最小数になります。 |
IntegerFacetingOptions
整数ファセット オプションの指定に使用されます。
JSON 表現 |
---|
{ "integerBuckets": [ string ] } |
フィールド | |
---|---|
integerBuckets[] |
特定の整数値のバケットは厳密に昇順である必要があります。たとえば、指定された値が (1,5,10,100) の場合、次のファセット バケットは {<1, [1,5), [5-10), [10-100), >=100} という形式になります。 |
QueryInterpretationConfig
ユーザークエリを解釈するためのデフォルト オプション。
JSON 表現 |
---|
{ "forceVerbatimMode": boolean, "forceDisableSupplementalResults": boolean } |
フィールド | |
---|---|
forceVerbatimMode |
このフラグを有効にすると、クエリの自然言語(NL)解釈、補足結果の取得、類義語(カスタム キーワードを含む)の使用など、すべての内部最適化が無効になります。このフラグを True に設定した場合、クエリレベルで設定されたオプションよりも優先されます。デフォルト値が False の場合、クエリレベル フラグにより、逐語モードの正しい解釈が設定されます。 |
forceDisableSupplementalResults |
このフラグを設定すると、補助的な結果の取得が無効になります。ここでフラグを設定しても、特定の検索アプリケーションに関連付けられたクエリの補助結果は取得されません。このフラグを True に設定した場合、クエリレベルで設定されたオプションよりも優先されます。デフォルト値が False の場合、クエリレベル フラグにより、補足結果の正しい解釈が設定されます。 |
メソッド |
|
---|---|
|
検索アプリケーションを作成します。 |
|
検索アプリケーションを削除します。 |
|
指定された検索アプリケーションを取得します。 |
|
すべての検索アプリケーションを一覧表示します。 |
|
検索アプリケーションを更新します。 |
|
検索アプリケーションをデフォルト設定にリセットします。 |
|
検索アプリケーションを更新します。 |