REST Resource: settings.searchapplications

Resource: SearchApplication

SearchApplication

JSON representation
{
  "name": string,
  "displayName": string,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ],
  "sourceConfig": [
    {
      object (SourceConfig)
    }
  ],
  "scoringConfig": {
    object (ScoringConfig)
  },
  "defaultSortOptions": {
    object (SortOptions)
  },
  "defaultFacetOptions": [
    {
      object (FacetOptions)
    }
  ],
  "returnResultThumbnailUrls": boolean,
  "operationIds": [
    string
  ],
  "enableAuditLog": boolean,
  "queryInterpretationConfig": {
    object (QueryInterpretationConfig)
  }
}
Fields
name

string

The name of the Search Application.

Format: searchapplications/{applicationId}.

displayName

string

Display name of the Search Application. The maximum length is 300 characters.

dataSourceRestrictions[]

object (DataSourceRestriction)

Retrictions applied to the configurations. The maximum number of elements is 10.

sourceConfig[]

object (SourceConfig)

Configuration for a sources specified in dataSourceRestrictions.

scoringConfig

object (ScoringConfig)

Configuration for ranking results.

defaultSortOptions

object (SortOptions)

The default options for sorting the search results

defaultFacetOptions[]

object (FacetOptions)

The default fields for returning facet results. The sources specified here also have been included in dataSourceRestrictions above.

returnResultThumbnailUrls

boolean

With each result we should return the URI for its thumbnail (when applicable)

operationIds[]

string

Output only. IDs of the Long Running Operations (LROs) currently running for this schema. Output only field.

enableAuditLog

boolean

Indicates whether audit logging is on/off for requests made for the search application in query APIs.

queryInterpretationConfig

object (QueryInterpretationConfig)

The default options for query interpretation

DataSourceRestriction

Restriction on Datasource.

JSON representation
{
  "source": {
    object (Source)
  },
  "filterOptions": [
    {
      object (FilterOptions)
    }
  ]
}
Fields
source

object (Source)

The source of restriction.

filterOptions[]

object (FilterOptions)

Filter options restricting the results. If multiple filters are present, they are grouped by object type before joining. Filters with the same object type are joined conjunctively, then the resulting expressions are joined disjunctively.

The maximum number of elements is 20.

NOTE: Suggest API supports only few filters at the moment: "objecttype", "type" and "mimetype". For now, schema specific filters cannot be used to filter suggestions.

Source

Defines sources for the suggest/search APIs.

JSON representation
{

  // Union field source can be only one of the following:
  "name": string,
  "predefinedSource": enum (Source.PredefinedSource)
  // End of list of possible types for union field source.
}
Fields

Union field source.

source can be only one of the following:

name

string

Source name for content indexed by the Indexing API.

predefinedSource

enum (Source.PredefinedSource)

Predefined content source for Google Apps.

Source.PredefinedSource

Predefined sources:

Enums
NONE
QUERY_HISTORY Suggests queries issued by the user in the past. Only valid when used with the suggest API. Ignored when used in the query API.
PERSON Suggests people in the organization. Only valid when used with the suggest API. Results in an error when used in the query API.
GOOGLE_DRIVE
GOOGLE_GMAIL
GOOGLE_SITES
GOOGLE_GROUPS
GOOGLE_CALENDAR
GOOGLE_KEEP

FilterOptions

Filter options to be applied on query.

JSON representation
{
  "objectType": string,
  "filter": {
    object (Filter)
  }
}
Fields
objectType

string

If objectType is set, only objects of that type are returned. This should correspond to the name of the object that was registered within the definition of schema. The maximum length is 256 characters.

filter

object (Filter)

Generic filter to restrict the search, such as lang:en, site:xyz.

Filter

A generic way of expressing filters in a query, which supports two approaches:

1. Setting a ValueFilter. The name must match an operatorName defined in the schema for your data source.

2. Setting a CompositeFilter. The filters are evaluated using the logical operator. The top-level operators can only be either an AND or a NOT. AND can appear only at the top-most level. OR can appear only under a top-level AND.

JSON representation
{

  // Union field filter can be only one of the following:
  "valueFilter": {
    object (Filter.ValueFilter)
  },
  "compositeFilter": {
    object (Filter.CompositeFilter)
  }
  // End of list of possible types for union field filter.
}
Fields

Union field filter.

filter can be only one of the following:

valueFilter

object (Filter.ValueFilter)

compositeFilter

object (Filter.CompositeFilter)

Filter.ValueFilter

JSON representation
{
  "operatorName": string,
  "value": {
    object (Value)
  }
}
Fields
operatorName

string

The operatorName applied to the query, such as price_greater_than. The filter can work against both types of filters defined in the schema for your data source:

  1. operatorName, where the query filters results by the property that matches the value.

  2. greaterThanOperatorName or lessThanOperatorName in your schema. The query filters the results for the property values that are greater than or less than the supplied value in the query.

value

object (Value)

The value to be compared with.

Value

Definition of a single value with generic type.

JSON representation
{

  // Union field value can be only one of the following:
  "stringValue": string,
  "integerValue": string,
  "doubleValue": number,
  "timestampValue": string,
  "booleanValue": boolean,
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Fields
Union field value. The value of the named property. value can be only one of the following:
stringValue

string

integerValue

string (int64 format)

doubleValue

number

timestampValue

string (Timestamp format)

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

booleanValue

boolean

dateValue

object (Date)

Filter.CompositeFilter

JSON representation
{
  "logicOperator": enum (Filter.CompositeFilter.LogicOperator),
  "subFilters": [
    {
      object (Filter)
    }
  ]
}
Fields
logicOperator

enum (Filter.CompositeFilter.LogicOperator)

The logic operator of the sub filter.

subFilters[]

object (Filter)

Sub filters.

Filter.CompositeFilter.LogicOperator

Enums
AND Logical operators, which can only be applied to sub filters.
OR
NOT NOT can only be applied on a single sub filter.

SourceConfig

Configurations for a source while processing a query.search or query.suggest request.

JSON representation
{
  "source": {
    object (Source)
  },
  "scoringConfig": {
    object (SourceScoringConfig)
  },
  "crowdingConfig": {
    object (SourceCrowdingConfig)
  }
}
Fields
source

object (Source)

The source for which this configuration is to be used.

scoringConfig

object (SourceScoringConfig)

The scoring configuration for the source.

crowdingConfig

object (SourceCrowdingConfig)

The crowding configuration for the source.

SourceScoringConfig

Set the scoring configuration. This allows modifying the ranking of results for a source.

JSON representation
{
  "sourceImportance": enum (SourceScoringConfig.SourceImportance)
}
Fields
sourceImportance

enum (SourceScoringConfig.SourceImportance)

Importance of the source.

SourceScoringConfig.SourceImportance

The importance of a source which can be used to indicate if a source should be given more priority in ranking compared to another source.

Enums
DEFAULT
LOW
HIGH

SourceCrowdingConfig

Set search results crowding limits. Crowding is a situation in which multiple results from the same source or host "crowd out" other results, diminishing the quality of search for users. To foster better search quality and source diversity in search results, you can set a condition to reduce repetitive results by source.

JSON representation
{
  "numResults": integer,
  "numSuggestions": integer
}
Fields
numResults

integer

Maximum number of results allowed from a datasource in a result page as long as results from other sources are not exhausted. value specified must not be negative. A default value is used if this value is equal to 0. To disable crowding, set the value greater than 100.

numSuggestions

integer

Maximum number of suggestions allowed from a source. No limits will be set on results if this value is less than or equal to 0.

ScoringConfig

Scoring configurations for a source while processing a query.search or query.suggest request.

JSON representation
{
  "disableFreshness": boolean,
  "disablePersonalization": boolean
}
Fields
disableFreshness

boolean

Whether to use freshness as a ranking signal. By default, freshness is used as a ranking signal. Note that this setting is not available in the Admin UI.

disablePersonalization

boolean

Whether to personalize the results. By default, personal signals will be used to boost results.

SortOptions

JSON representation
{
  "operatorName": string,
  "sortOrder": enum (SortOptions.SortOrder)
}
Fields
operatorName

string

The name of the operator corresponding to the field to sort on. The corresponding property must be marked as sortable.

sortOrder

enum (SortOptions.SortOrder)

Ascending is the default sort order

SortOptions.SortOrder

Enums
ASCENDING
DESCENDING

FacetOptions

Specifies operators to return facet results for. There will be one FacetResult for every sourceName/objectType/operatorName combination.

JSON representation
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "numFacetBuckets": integer,
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}
Fields
sourceName

string

Source name to facet on. Format: datasources/{sourceId} If empty, all data sources will be used.

objectType

string

If objectType is set, only those objects of that type will be used to compute facets. If empty, then all objects will be used to compute facets.

operatorName

string

The name of the operator chosen for faceting. @see cloudsearch.SchemaPropertyOptions

numFacetBuckets

integer

Maximum number of facet buckets that should be returned for this facet. Defaults to 10. Maximum value is 100.

integerFacetingOptions

object (IntegerFacetingOptions)

If set, describes integer faceting options for the given integer property. The corresponding integer property in the schema should be marked isFacetable. The number of buckets returned would be minimum of this and numFacetBuckets.

IntegerFacetingOptions

Used to specify integer faceting options.

JSON representation
{
  "integerBuckets": [
    string
  ]
}
Fields
integerBuckets[]

string (Int64Value format)

Buckets for given integer values should be in strictly ascending order. For example, if values supplied are (1,5,10,100), the following facet buckets will be formed {<1, [1,5), [5-10), [10-100), >=100}.

QueryInterpretationConfig

Default options to interpret user query.

JSON representation
{
  "forceVerbatimMode": boolean,
  "forceDisableSupplementalResults": boolean
}
Fields
forceVerbatimMode

boolean

Enable this flag to turn off all internal optimizations like natural language (NL) interpretation of queries, supplemental results retrieval, and usage of synonyms including custom ones. If this flag is set to True, it will take precedence over the option set at Query level. For the default value of False, query level flag will set the correct interpretation for verbatim mode.

forceDisableSupplementalResults

boolean

Set this flag to disable supplemental results retrieval, setting a flag here will not retrieve supplemental results for queries associated with a given search application. If this flag is set to True, it will take precedence over the option set at Query level. For the default value of False, query level flag will set the correct interpretation for supplemental results.

Methods

create

Creates a search application.

delete

Deletes a search application.

get

Gets the specified search application.

list

Lists all search applications.

patch

Updates a search application.

reset

Resets a search application to default settings.

update

Updates a search application.