REST Resource: settings.searchapplications

Recurso: SearchApplication

SearchApplication

Representación JSON
{
  "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)
  }
}
Campos
name

string

Es el nombre de la aplicación de búsqueda.

Formato: searchapplications/{applicationId}.

displayName

string

Nombre visible de la aplicación de búsqueda. La longitud máxima es de 300 caracteres.

dataSourceRestrictions[]

object (DataSourceRestriction)

Restricciones aplicadas a los parámetros de configuración. La cantidad máxima de elementos es 10.

sourceConfig[]

object (SourceConfig)

Configuración para una fuente especificada en dataSourceRestrictions.

scoringConfig

object (ScoringConfig)

Configuración de los resultados de clasificación.

defaultSortOptions

object (SortOptions)

Las opciones predeterminadas para ordenar los resultados de la búsqueda

defaultFacetOptions[]

object (FacetOptions)

Los campos predeterminados para mostrar los resultados de faceta. Las fuentes que se especifican aquí también se incluyeron en el dataSourceRestrictions anterior.

returnResultThumbnailUrls

boolean

Con cada resultado, debemos mostrar el URI para su miniatura (si corresponde).

operationIds[]

string

Solo salida. Son los ID de las operaciones de larga duración (LRO) que se ejecutan actualmente para este esquema. Campo de solo salida.

enableAuditLog

boolean

Indica si el registro de auditoría está activado o desactivado para las solicitudes realizadas para la aplicación de búsqueda en las APIs de consulta.

queryInterpretationConfig

object (QueryInterpretationConfig)

Opciones predeterminadas para la interpretación de consultas

DataSourceRestriction

Restricción sobre la fuente de datos.

Representación JSON
{
  "source": {
    object (Source)
  },
  "filterOptions": [
    {
      object (FilterOptions)
    }
  ]
}
Campos
source

object (Source)

La fuente de la restricción.

filterOptions[]

object (FilterOptions)

Opciones de filtro que restringen los resultados. Si hay varios filtros presentes, se agrupan por tipo de objeto antes de la unión. Los filtros con el mismo tipo de objeto se unen de forma conjuntiva y, luego, las expresiones resultantes se unen de forma disyuntiva.

La cantidad máxima de elementos es 20.

NOTA: La API de Sugerir solo admite algunos filtros por el momento: “tipo de objeto”, “tipo”. y "mimetype". Por ahora, no se pueden usar filtros específicos de esquemas para filtrar sugerencias.

Fuente

Define las fuentes para las APIs de sugerencia/búsqueda.

Representación JSON
{

  // 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.
}
Campos

Campo de unión source.

source puede ser una de las siguientes opciones:

name

string

Es el nombre de la fuente del contenido indexado por Indexing API.

predefinedSource

enum (Source.PredefinedSource)

Fuente de contenido predefinida para Google Apps.

Source.PredefinedSource

Fuentes predefinidas:

Enumeraciones
NONE
QUERY_HISTORY Sugiere búsquedas que realizó el usuario en el pasado. Solo es válida cuando se usa con la API sugerida. Se ignora cuando se usa en la API de consulta.
PERSON Sugiere personas de la organización. Solo es válida cuando se usa con la API sugerida. Genera un error cuando se usa en la API de consulta.
GOOGLE_DRIVE
GOOGLE_GMAIL
GOOGLE_SITES
GOOGLE_GROUPS
GOOGLE_CALENDAR
GOOGLE_KEEP

FilterOptions

Filtra las opciones que se aplicarán en la consulta.

Representación JSON
{
  "objectType": string,
  "filter": {
    object (Filter)
  }
}
Campos
objectType

string

Si se configura objectType, solo se muestran objetos de ese tipo. Debe corresponder al nombre del objeto que se registró dentro de la definición de esquema. La longitud máxima es de 256 caracteres.

filter

object (Filter)

Es un filtro genérico para restringir la búsqueda, como lang:en, site:xyz.

Filtro

Una forma genérica de expresar filtros en una consulta que admite dos enfoques:

1. Configura un ValueFilter. El nombre debe coincidir con unOperatorName definido en el esquema de tu fuente de datos.

2. Configura un CompositeFilter. Los filtros se evalúan usando el operador lógico. Los operadores de nivel superior solo pueden ser AND o NOT. Y solo puede aparecer en el nivel superior. El operador OR puede aparecer solo en el operador AND de nivel superior.

Representación JSON
{

  // 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.
}
Campos

Campo de unión filter.

filter puede ser una de las siguientes opciones:

valueFilter

object (Filter.ValueFilter)

compositeFilter

object (Filter.CompositeFilter)

Filter.ValueFilter

Representación JSON
{
  "operatorName": string,
  "value": {
    object (Value)
  }
}
Campos
operatorName

string

El operatorName aplicado a la consulta, como price_greater_than. El filtro puede funcionar con los dos tipos de filtros definidos en el esquema de tu fuente de datos:

  1. operatorName, en la que la consulta filtra los resultados por la propiedad que coincide con el valor

  2. greaterThanOperatorName o lessThanOperatorName en tu esquema. La consulta filtra los resultados para los valores de propiedad que son mayores o menores que el valor proporcionado en la consulta.

value

object (Value)

Valor con el que se va a comparar

Valor

Definición de un valor único con un tipo genérico.

Representación JSON
{

  // 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.
}
Campos
Campo de unión value. El valor de la propiedad nombrada. Las direcciones (value) solo pueden ser una de las siguientes opciones:
stringValue

string

integerValue

string (int64 format)

doubleValue

number

timestampValue

string (Timestamp format)

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

booleanValue

boolean

dateValue

object (Date)

Filter.CompositeFilter

Representación JSON
{
  "logicOperator": enum (Filter.CompositeFilter.LogicOperator),
  "subFilters": [
    {
      object (Filter)
    }
  ]
}
Campos
logicOperator

enum (Filter.CompositeFilter.LogicOperator)

El operador lógico del subfiltro.

subFilters[]

object (Filter)

Subfiltros.

Filter.CompositeFilter.LogicOperator

Enumeraciones
AND Operadores lógicos, que solo se pueden aplicar a subfiltros.
OR
NOT NO se puede aplicar únicamente en un único subfiltro.

SourceConfig

Configuraciones de una fuente mientras se procesa una solicitud query.search o query.suggest.

Representación JSON
{
  "source": {
    object (Source)
  },
  "scoringConfig": {
    object (SourceScoringConfig)
  },
  "crowdingConfig": {
    object (SourceCrowdingConfig)
  }
}
Campos
source

object (Source)

Es la fuente en la que se usará esta configuración.

scoringConfig

object (SourceScoringConfig)

La configuración de la puntuación para la fuente.

crowdingConfig

object (SourceCrowdingConfig)

La configuración de multiplicidad de la fuente.

SourceScoringConfig

Establece la configuración de la puntuación. Esto permite modificar la clasificación de los resultados de una fuente.

Representación JSON
{
  "sourceImportance": enum (SourceScoringConfig.SourceImportance)
}
Campos
sourceImportance

enum (SourceScoringConfig.SourceImportance)

Importancia de la fuente

SourceScoringConfig.SourceImportance

Es la importancia de una fuente que se puede usar para indicar si una fuente debe tener más prioridad en su clasificación en comparación con otra.

Enumeraciones
DEFAULT
LOW
HIGH

SourceCrowdingConfig

Establecer límites de multiplicidad de resultados de la búsqueda La acumulación es una situación en la que múltiples resultados de la misma fuente o host se “retiran” otros resultados, lo que disminuye la calidad de la búsqueda para los usuarios. Para fomentar una mejor calidad de búsqueda y diversidad de las fuentes en los resultados de la búsqueda, puedes establecer una condición que reduzca los resultados repetitivos por fuente.

Representación JSON
{
  "numResults": integer,
  "numSuggestions": integer
}
Campos
numResults

integer

Cantidad máxima de resultados permitidos de una fuente de datos en una página de resultados, siempre y cuando no se agoten los resultados de otras fuentes. El valor especificado no debe ser negativo. Se usa un valor predeterminado si este valor es igual a 0. Para inhabilitar la acumulación, establece un valor superior a 100.

numSuggestions

integer

Cantidad máxima de sugerencias permitidas de una fuente. No se establecerán límites en los resultados si este valor es menor o igual que 0.

ScoringConfig

Configuraciones de puntuación para una fuente mientras se procesa una solicitud query.search o query.suggest.

Representación JSON
{
  "disableFreshness": boolean,
  "disablePersonalization": boolean
}
Campos
disableFreshness

boolean

Indica si se debe usar actualidad como indicador de clasificación. De forma predeterminada, la actualidad se usa como indicador de clasificación. Ten en cuenta que este parámetro de configuración no está disponible en la IU para administrar.

disablePersonalization

boolean

Establece si se deben personalizar los resultados. De forma predeterminada, se usarán indicadores personales para mejorar los resultados.

SortOptions

Representación JSON
{
  "operatorName": string,
  "sortOrder": enum (SortOptions.SortOrder)
}
Campos
operatorName

string

El nombre del operador correspondiente al campo que se va a ordenar. La propiedad correspondiente se debe marcar como sortable.

sortOrder

enum (SortOptions.SortOrder)

El orden de clasificación predeterminado es ascendente

SortOptions.SortOrder

Enumeraciones
ASCENDING
DESCENDING

FacetOptions

Especifica los operadores para los que se mostrarán los resultados de faceta. Habrá un FacetResult para cada combinación de sourceName/objectType/operatorName.

Representación JSON
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "numFacetBuckets": integer,
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}
Campos
sourceName

string

Nombre de la fuente en la que se debe agregar la faceta. Formato: fuentes de datos/{sourceId} Si está vacío, se usarán todas las fuentes de datos.

objectType

string

Si se establece objectType, solo se usarán esos objetos de ese tipo para calcular facetas. Si está vacío, todos los objetos se usarán para calcular las facetas.

operatorName

string

El nombre del operador elegido para la creación de facetas. @ver cloudsearch.SchemaPropertyOptions

numFacetBuckets

integer

Cantidad máxima de buckets de facetas que se deben mostrar para esta faceta. La configuración predeterminada es 10. El valor máximo es 100.

integerFacetingOptions

object (IntegerFacetingOptions)

Si se establece, describe las opciones de faceta de números enteros para la propiedad de número entero determinada. La propiedad de número entero correspondiente en el esquema debe marcarse como isFacetable. La cantidad de buckets mostrados será el mínimo de esta y numFacetBuckets.

IntegerFacetingOptions

Se usa para especificar opciones de faceta de números enteros.

Representación JSON
{
  "integerBuckets": [
    string
  ]
}
Campos
integerBuckets[]

string (Int64Value format)

Los buckets para los valores de números enteros especificados deben estar en orden ascendente estrictamente. Por ejemplo, si los valores proporcionados son (1,5,10,100), los siguientes buckets de facetas se formarán {<1, [1,5), [5-10), [10-100), >=100}.

QueryInterpretationConfig

Opciones predeterminadas para interpretar la consulta del usuario.

Representación JSON
{
  "forceVerbatimMode": boolean,
  "forceDisableSupplementalResults": boolean
}
Campos
forceVerbatimMode

boolean

Habilita esta marca para desactivar todas las optimizaciones internas, como la interpretación de consultas en lenguaje natural (NL), la recuperación de resultados complementarios y el uso de sinónimos, incluidos los personalizados. Si esta marca se establece en True, tendrá prioridad sobre la opción establecida en el nivel de la consulta. En el caso del valor predeterminado de falso, la marca de nivel de consulta establecerá la interpretación correcta para el modo literal.

forceDisableSupplementalResults

boolean

Configura esta marca para inhabilitar la recuperación de resultados complementarios. Si estableces una marca aquí, no se recuperarán los resultados complementarios de las consultas asociadas con una aplicación de búsqueda determinada. Si esta marca se establece en True, tendrá prioridad sobre la opción establecida en el nivel de la consulta. En el valor predeterminado de falso, la marca de nivel de consulta establecerá la interpretación correcta de los resultados complementarios.

Métodos

create

Crea una aplicación de búsqueda.

delete

Borra una aplicación de búsqueda.

get

Obtiene la aplicación de búsqueda especificada.

list

Muestra una lista de todas las aplicaciones de búsqueda.

patch

Actualiza una aplicación de búsqueda.

reset

Restablece una aplicación de búsqueda a la configuración predeterminada.

update

Actualiza una aplicación de búsqueda.