Schema

Es la definición del esquema de una fuente de datos.

Representación JSON
{
  "objectDefinitions": [
    {
      object (ObjectDefinition)
    }
  ],
  "operationIds": [
    string
  ]
}
Campos
objectDefinitions[]

object (ObjectDefinition)

Es la lista de objetos de nivel superior de la fuente de datos. La cantidad máxima de elementos es 10.

operationIds[]

string

Son los IDs de las operaciones de larga duración (LRO) que se están ejecutando actualmente para este esquema. Después de modificar el esquema, espera a que se completen las operaciones antes de indexar contenido adicional.

ObjectDefinition

Es la definición de un objeto dentro de una fuente de datos.

Representación JSON
{
  "name": string,
  "options": {
    object (ObjectOptions)
  },
  "propertyDefinitions": [
    {
      object (PropertyDefinition)
    }
  ]
}
Campos
name

string

Es el nombre del objeto, que luego define su tipo. Las solicitudes de indexación de artículos deben establecer el campo objectType igual a este valor. Por ejemplo, si name es Document, las solicitudes de indexación de elementos de tipo Document deben establecer objectType igual a Document. Cada definición de objeto debe tener un nombre único dentro de un esquema. El nombre debe comenzar con una letra y solo puede contener letras (A-Z, a-z) o números (0-9). La longitud máxima es de 256 caracteres.

options

object (ObjectOptions)

Las opciones opcionales específicas del objeto.

propertyDefinitions[]

object (PropertyDefinition)

Las definiciones de propiedades del objeto. La cantidad máxima de elementos es 1,000.

ObjectOptions

Las opciones de un objeto.

Representación JSON
{
  "freshnessOptions": {
    object (ObjectOptions.FreshnessOptions)
  },
  "displayOptions": {
    object (ObjectDisplayOptions)
  },
  "suggestionFilteringOperators": [
    string
  ]
}
Campos
freshnessOptions

object (ObjectOptions.FreshnessOptions)

Son las opciones de actualización de un objeto.

displayOptions

object (ObjectDisplayOptions)

Son las opciones que determinan cómo se muestra el objeto en la página de resultados de Cloud Search.

suggestionFilteringOperators[]

string

Operadores que se pueden usar para filtrar sugerencias. En el caso de la API de query.suggest, solo se respetarán los operadores mencionados aquí en FilterOptions. Solo se admiten los operadores TEXT y ENUM.

NOTA: Ya se admiten "objecttype", "type" y "mimetype". Esta propiedad se usa para configurar operadores específicos del esquema.

Aunque se trata de un array, solo se puede especificar un operador. Este es un array para la extensibilidad futura.

No se admiten operadores que se asignan a varias propiedades dentro del mismo objeto. Si el operador abarca diferentes tipos de objetos, esta opción se debe establecer una vez para cada definición de objeto.

ObjectOptions.FreshnessOptions

Indica qué propiedad de actualización se debe usar cuando se ajusta la clasificación de búsqueda de un elemento. Las fechas más recientes indican una mayor calidad. Usa la propiedad de opción de actualización que mejor funcione con tus datos. En el caso de los documentos de uso compartido de archivos, la hora de la última modificación es la más relevante. En el caso de los datos de eventos de calendario, la hora en la que se produce el evento es un indicador de actualización más relevante. De esta manera, los eventos de calendario que ocurren más cerca de la hora de la búsqueda se consideran de mayor calidad y se clasifican según corresponda.

Representación JSON
{
  "freshnessProperty": string,
  "freshnessDuration": string
}
Campos
freshnessProperty

string

Esta propiedad indica el nivel de actualización del objeto en el índice. Si se establece, esta propiedad debe ser de nivel superior dentro de property definitions y debe ser timestamp type o date type. De lo contrario, la API de Indexing usa updateTime como indicador de actualización. La longitud máxima es de 256 caracteres.

Cuando se usa una propiedad para calcular la actualización, el valor predeterminado es de 2 años a partir de la hora actual.

freshnessDuration

string (Duration format)

Es la duración después de la cual se debe considerar inactivo un objeto. El valor predeterminado es de 180 días (en segundos).

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

ObjectDisplayOptions

Son las opciones de visualización de un objeto.

Representación JSON
{
  "objectDisplayLabel": string,
  "metalines": [
    {
      object (ObjectDisplayOptions.Metaline)
    }
  ]
}
Campos
objectDisplayLabel

string

Es la etiqueta fácil de usar que se muestra en el resultado de la búsqueda para indicar el tipo de elemento. Este campo es OPCIONAL. Si no se proporciona, no se mostrará una etiqueta de objeto en la línea de contexto de los resultados de la búsqueda. La longitud máxima es de 64 caracteres.

metalines[]

object (ObjectDisplayOptions.Metaline)

Define las propiedades que se muestran en las líneas de metadatos de los resultados de la búsqueda. Los valores de la propiedad se muestran en el orden que se indica aquí. Si una propiedad contiene varios valores, todos se muestran antes de las siguientes propiedades. Por este motivo, se recomienda especificar las propiedades singulares antes que las repetidas en esta lista. Todas las propiedades deben establecer isReturnable como verdadero. La cantidad máxima de metalíneas es 3.

ObjectDisplayOptions.Metaline

Una metalínea es una lista de propiedades que se muestran junto con el resultado de la búsqueda para proporcionar contexto.

Representación JSON
{
  "properties": [
    {
      object (ObjectDisplayOptions.DisplayedProperty)
    }
  ]
}
Campos
properties[]

object (ObjectDisplayOptions.DisplayedProperty)

Es la lista de propiedades que se muestran para la metalínea. La cantidad máxima de propiedades es 5.

ObjectDisplayOptions.DisplayedProperty

Es una referencia a una propiedad de nivel superior dentro del objeto que se debe mostrar en los resultados de la búsqueda. Los valores de las propiedades elegidas se muestran en los resultados de la búsqueda junto con el display label de esa propiedad, si se especifica uno. Si no se especifica una etiqueta de visualización, solo se muestran los valores.

Representación JSON
{
  "propertyName": string
}
Campos
propertyName

string

Es el nombre de la propiedad de nivel superior, tal como se define en una definición de propiedad para el objeto. Si el nombre no es una propiedad definida en el esquema, se muestra un error cuando se intenta actualizar el esquema.

PropertyDefinition

Es la definición de una propiedad dentro de un objeto.

Representación JSON
{
  "name": string,
  "isReturnable": boolean,
  "isRepeatable": boolean,
  "isSortable": boolean,
  "isFacetable": boolean,
  "isSuggestable": boolean,
  "isWildcardSearchable": boolean,
  "displayOptions": {
    object (PropertyDisplayOptions)
  },

  // Union field property_options can be only one of the following:
  "integerPropertyOptions": {
    object (IntegerPropertyOptions)
  },
  "doublePropertyOptions": {
    object (DoublePropertyOptions)
  },
  "timestampPropertyOptions": {
    object (TimestampPropertyOptions)
  },
  "booleanPropertyOptions": {
    object (BooleanPropertyOptions)
  },
  "objectPropertyOptions": {
    object (ObjectPropertyOptions)
  },
  "enumPropertyOptions": {
    object (EnumPropertyOptions)
  },
  "datePropertyOptions": {
    object (DatePropertyOptions)
  },
  "textPropertyOptions": {
    object (TextPropertyOptions)
  },
  "htmlPropertyOptions": {
    object (HtmlPropertyOptions)
  }
  // End of list of possible types for union field property_options.
}
Campos
name

string

Es el nombre de la propiedad. Las solicitudes de indexación de artículos que se envían a la API de Indexing deben establecer property name igual a este valor. Por ejemplo, si el nombre es subject_line, las solicitudes de indexación de elementos de documentos con campos de asunto deben establecer el name de ese campo igual a subject_line. Usa el nombre como identificador de la propiedad del objeto. Una vez que se registra como una propiedad de un objeto, no puedes volver a usar este nombre para otra propiedad dentro de ese objeto. El nombre debe comenzar con una letra y solo puede contener letras (A-Z, a-z) o números (0-9). La longitud máxima es de 256 caracteres.

isReturnable

boolean

Indica que la propiedad identifica datos que se deben mostrar en los resultados de la búsqueda mediante la API de consulta. Si se establece en true, indica que los usuarios de la API de Query pueden usar campos de propiedades coincidentes en los resultados. Sin embargo, el almacenamiento de campos requiere más asignación de espacio y usa más ancho de banda para las consultas de búsqueda, lo que afecta el rendimiento en conjuntos de datos grandes. Establece este valor como true solo si el campo es necesario para los resultados de la búsqueda. No puede ser verdadero para las propiedades cuyo tipo es un objeto.

isRepeatable

boolean

Indica que se permiten varios valores para la propiedad. Por ejemplo, un documento solo tiene una descripción, pero puede tener varios comentarios. No puede ser verdadero para las propiedades cuyo tipo es un valor booleano. Si se establece como "false", las propiedades que contienen más de un valor hacen que se rechace la solicitud de indexación de ese elemento.

isSortable

boolean

Indica que la propiedad se puede usar para el ordenamiento. Esto no sucede con las propiedades repetibles. No puede ser verdadero para las propiedades cuyo tipo es un objeto. IsReturnable debe ser verdadero para establecer esta opción. Solo se admite para propiedades booleanas, de fecha, dobles, de número entero y de marca de tiempo.

isFacetable

boolean

Indica que la propiedad se puede usar para generar facetas. No puede ser verdadero para las propiedades cuyo tipo es un objeto. IsReturnable debe ser verdadero para establecer esta opción. Solo se admite para propiedades booleanas, de enumeración, de número entero y de texto.

isSuggestable

boolean

Indica que la propiedad se puede usar para generar sugerencias de búsqueda.

isWildcardSearchable

boolean

Indica que los usuarios pueden realizar una búsqueda con comodines para esta propiedad. Solo se admite para propiedades de texto. IsReturnable debe ser verdadero para establecer esta opción. En un origen de datos determinado, se puede marcar un máximo de 5 propiedades como isWildcardSearchable. Para obtener más información, consulta Cómo definir propiedades de objetos.

displayOptions

object (PropertyDisplayOptions)

Son las opciones que determinan cómo se muestra la propiedad en la página de resultados de la Búsqueda en la nube si se especifica que se debe mostrar en el display options del objeto.

Campo de unión property_options. Son las opciones específicas de cada tipo que determinan cómo se indexa y utiliza la propiedad. En el caso de que las opciones deban ser las predeterminadas para un tipo, este campo aún debe establecerse en uno de los tipos. Si no se configura este campo, se rechazan las actualizaciones del esquema. Las direcciones (property_options) solo pueden ser una de las siguientes opciones:
integerPropertyOptions

object (IntegerPropertyOptions)

doublePropertyOptions

object (DoublePropertyOptions)

timestampPropertyOptions

object (TimestampPropertyOptions)

booleanPropertyOptions

object (BooleanPropertyOptions)

objectPropertyOptions

object (ObjectPropertyOptions)

enumPropertyOptions

object (EnumPropertyOptions)

datePropertyOptions

object (DatePropertyOptions)

textPropertyOptions

object (TextPropertyOptions)

htmlPropertyOptions

object (HtmlPropertyOptions)

IntegerPropertyOptions

Las opciones para las propiedades de número entero.

Representación JSON
{
  "orderedRanking": enum (IntegerPropertyOptions.OrderedRanking),
  "minimumValue": string,
  "maximumValue": string,
  "operatorOptions": {
    object (IntegerPropertyOptions.IntegerOperatorOptions)
  },
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}
Campos
orderedRanking

enum (IntegerPropertyOptions.OrderedRanking)

Se usa para especificar la clasificación ordenada del número entero. Solo se puede usar si isRepeatable es falso.

minimumValue

string (Int64Value format)

Es el valor mínimo de la propiedad. Los valores mínimo y máximo de la propiedad se usan para clasificar los resultados según ordered ranking. Se aceptan las solicitudes de indexación con valores inferiores al mínimo y se clasifican con el mismo peso que los elementos indexados con el valor mínimo.

maximumValue

string (Int64Value format)

Es el valor máximo de la propiedad. Los valores mínimo y máximo de la propiedad se usan para clasificar los resultados según ordered ranking. Las solicitudes de indexación con valores superiores al máximo se aceptan y se clasifican con la misma ponderación que los elementos indexados con el valor máximo.

operatorOptions

object (IntegerPropertyOptions.IntegerOperatorOptions)

Si se establece, describe cómo se debe usar el número entero como operador de búsqueda.

integerFacetingOptions

object (IntegerFacetingOptions)

Si se establece, describe las opciones de facetas de números enteros para la propiedad de número entero determinada. La propiedad de número entero correspondiente debe estar marcada como isFacetable.

IntegerPropertyOptions.OrderedRanking

Se usa para especificar cómo se debe clasificar un valor de número entero en relación con otros valores. Un número entero con una clasificación ordenada más alta sugiere una mayor importancia. Por ejemplo, en algunas fuentes de datos, una prioridad más baja indica una mayor importancia, mientras que en otras, una prioridad más alta indica una mayor importancia.

Enumeraciones
NO_ORDER No hay un orden de clasificación para la propiedad. Los resultados no se ajustan según el valor de esta propiedad.
ASCENDING Esta propiedad se clasifica en orden ascendente. Los valores más bajos indican una clasificación más baja.
DESCENDING Esta propiedad se clasifica en orden descendente. Los valores más bajos indican una clasificación más alta.

IntegerPropertyOptions.IntegerOperatorOptions

Se usa para proporcionar un operador de búsqueda para propiedades de número entero. Esto es opcional. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca.

Representación JSON
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Campos
operatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de número entero. Por ejemplo, si operatorName es priority y el nombre de la propiedad es priorityVal, las consultas como priority:<value> muestran resultados solo cuando el valor de la propiedad llamada priorityVal coincide con <value>. Por el contrario, una búsqueda que usa el mismo <value> sin un operador muestra todos los elementos en los que <value> coincide con el valor de cualquier propiedad de String o texto dentro del campo de contenido del elemento. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

lessThanOperatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de número entero con el operador menor que. Por ejemplo, si lessThanOperatorName es prioritybelow y el nombre de la propiedad es priorityVal, las consultas como prioritybelow:<value> muestran resultados solo cuando el valor de la propiedad llamada priorityVal es menor que <value>. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

greaterThanOperatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de número entero con el operador mayor que. Por ejemplo, si greaterThanOperatorName es priorityabove y el nombre de la propiedad es priorityVal, las consultas como priorityabove:<value> muestran resultados solo cuando el valor de la propiedad llamada priorityVal es mayor que <value>. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

DoublePropertyOptions

Las opciones para propiedades dobles.

Representación JSON
{
  "operatorOptions": {
    object (DoublePropertyOptions.DoubleOperatorOptions)
  }
}
Campos
operatorOptions

object (DoublePropertyOptions.DoubleOperatorOptions)

Si se establece, describe cómo se debe usar el doble como operador de búsqueda.

DoublePropertyOptions.DoubleOperatorOptions

Se usa para proporcionar un operador de búsqueda para propiedades dobles. Esto es opcional. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca.

Representación JSON
{
  "operatorName": string
}
Campos
operatorName

string

Indica el nombre del operador requerido en la consulta para usar la propiedad doble en la ordenación o como una faceta. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

TimestampPropertyOptions

Las opciones para las propiedades de marca de tiempo.

Representación JSON
{
  "operatorOptions": {
    object (TimestampPropertyOptions.TimestampOperatorOptions)
  }
}
Campos
operatorOptions

object (TimestampPropertyOptions.TimestampOperatorOptions)

Si se establece, describe cómo se debe usar la marca de tiempo como operador de búsqueda.

TimestampPropertyOptions.TimestampOperatorOptions

Se usa para proporcionar un operador de búsqueda para las propiedades de marca de tiempo. Esto es opcional. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca.

Representación JSON
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Campos
operatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de marca de tiempo. Por ejemplo, si operatorName es closedon y el nombre de la propiedad es closeDate, las consultas como closedon:<value> muestran resultados solo cuando el valor de la propiedad llamada closeDate coincide con <value>. Por el contrario, una búsqueda que usa el mismo <value> sin un operador muestra todos los elementos en los que <value> coincide con el valor de cualquier propiedad de String o texto dentro del campo de contenido del elemento. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

lessThanOperatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de marca de tiempo con el operador menor que. Por ejemplo, si lessThanOperatorName es closedbefore y el nombre de la propiedad es closeDate, las consultas como closedbefore:<value> muestran resultados solo cuando el valor de la propiedad closeDate es anterior a <value>. El nombre del operador solo puede contener letras en minúsculas (a-z). La longitud máxima es de 32 caracteres.

greaterThanOperatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de marca de tiempo con el operador mayor que. Por ejemplo, si greaterThanOperatorName es closedafter y el nombre de la propiedad es closeDate, las consultas como closedafter:<value> muestran resultados solo cuando el valor de la propiedad closeDate es posterior a <value>. El nombre del operador solo puede contener letras en minúsculas (a-z). La longitud máxima es de 32 caracteres.

BooleanPropertyOptions

Las opciones para las propiedades booleanas.

Representación JSON
{
  "operatorOptions": {
    object (BooleanPropertyOptions.BooleanOperatorOptions)
  }
}
Campos
operatorOptions

object (BooleanPropertyOptions.BooleanOperatorOptions)

Si se establece, describe cómo se debe usar el valor booleano como operador de búsqueda.

BooleanPropertyOptions.BooleanOperatorOptions

Se usa para proporcionar un operador de búsqueda para propiedades booleanas. Esto es opcional. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca.

Representación JSON
{
  "operatorName": string
}
Campos
operatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad booleana. Por ejemplo, si operatorName es closed y el nombre de la propiedad es isClosed, las consultas como closed:<value> muestran resultados solo cuando el valor de la propiedad llamada isClosed coincide con <value>. Por el contrario, una búsqueda que usa el mismo <value> sin un operador muestra todos los elementos en los que <value> coincide con el valor de cualquier propiedad de String o texto dentro del campo de contenido del elemento. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

ObjectPropertyOptions

Las opciones para las propiedades de los objetos.

Representación JSON
{
  "subobjectProperties": [
    {
      object (PropertyDefinition)
    }
  ]
}
Campos
subobjectProperties[]

object (PropertyDefinition)

Las propiedades del subobjeto Estas propiedades representan un objeto anidado. Por ejemplo, si esta propiedad representa una dirección postal, los subobjetosProperties podrían llamarse calle, ciudad y estado. La cantidad máxima de elementos es 1,000.

EnumPropertyOptions

Las opciones para las propiedades enum, que te permiten definir un conjunto restringido de cadenas para que coincidan con las consultas de los usuarios, establecer clasificaciones para esos valores de cadenas y definir un nombre de operador que se vinculará con esas cadenas para que los usuarios puedan limitar los resultados solo a los elementos con un valor específico Por ejemplo, para los elementos de un sistema de seguimiento de solicitudes con información de prioridad, puedes definir p0 como un valor de enumeración permitido y vincular esta enumeración al nombre del operador priority para que los usuarios de búsqueda puedan agregar priority:p0 a su consulta para restringir el conjunto de resultados solo a aquellos elementos indexados con el valor p0.

Representación JSON
{
  "possibleValues": [
    {
      object (EnumPropertyOptions.EnumValuePair)
    }
  ],
  "orderedRanking": enum (EnumPropertyOptions.OrderedRanking),
  "operatorOptions": {
    object (EnumPropertyOptions.EnumOperatorOptions)
  }
}
Campos
possibleValues[]

object (EnumPropertyOptions.EnumValuePair)

Es la lista de valores posibles para la propiedad de enumeración. Todos los EnumValuePairs deben proporcionar un valor de cadena. Si especificas un valor entero para un EnumValuePair, todos los EnumValuePairs posibles deben proporcionar un valor entero. Tanto el valor de cadena como el valor de número entero deben ser únicos en todos los valores posibles. Una vez establecidos, no se pueden quitar ni modificar los valores posibles. Si proporcionas una clasificación ordenada y crees que podrías insertar valores de enumeración adicionales en el futuro, deja espacios en los valores de número entero iniciales para permitir agregar un valor entre los valores registrados anteriormente. La cantidad máxima de elementos es 100.

orderedRanking

enum (EnumPropertyOptions.OrderedRanking)

Se usa para especificar la clasificación ordenada de la enumeración que determina cómo se usan los valores de números enteros proporcionados en los EnumValuePairs posibles para clasificar los resultados. Si se especifica, se deben proporcionar valores enteros para todos los valores posibles de EnumValuePair que se proporcionan para esta propiedad. Solo se puede usar si isRepeatable es falso.

operatorOptions

object (EnumPropertyOptions.EnumOperatorOptions)

Si se establece, describe cómo se debe usar la enumeración como operador de búsqueda.

EnumPropertyOptions.EnumValuePair

El par de valores de enumeración define dos elementos: un valor de cadena obligatorio y un valor de número entero opcional. El valor de cadena define el término de consulta necesario para recuperar ese elemento, como p0 para un elemento de prioridad. El valor entero determina la clasificación de ese valor de cadena en relación con otros valores enumerados para la misma propiedad. Por ejemplo, puedes asociar p0 con 0 y definir otro par de enumeración, como p1 y 1. Debes usar el valor entero en combinación con ordered ranking para establecer la clasificación de un valor determinado en relación con otros valores enumerados para el mismo nombre de propiedad. Aquí, un orden de clasificación de DESCENDENTE para las propiedades de prioridad genera un aumento de clasificación para los elementos indexados con un valor de p0 en comparación con los elementos indexados con un valor de p1. Sin un orden de clasificación especificado, el valor entero no tiene efecto en la clasificación de los elementos.

Representación JSON
{
  "stringValue": string,
  "integerValue": integer
}
Campos
stringValue

string

El valor de cadena de EnumValuePair. La longitud máxima es de 32 caracteres.

integerValue

integer

Es el valor entero de EnumValuePair, que debe ser no negativo. Opcional.

EnumPropertyOptions.OrderedRanking

Se usa para especificar la dirección de clasificación de un número entero EnumValuePair en relación con otros valores enteros de EnumValuePair. En algunas propiedades, los valores de números enteros más bajos indican una importancia mayor, mientras que en otras, un número entero más alto indica una importancia mayor.

Enumeraciones
NO_ORDER No hay un orden de clasificación para la propiedad. Los resultados no se ajustan según el valor de esta propiedad.
ASCENDING Esta propiedad se clasifica en orden ascendente. Los valores más bajos indican una clasificación más baja.
DESCENDING Esta propiedad se clasifica en orden descendente. Los valores más bajos indican una clasificación más alta.

EnumPropertyOptions.EnumOperatorOptions

Se usa para proporcionar un operador de búsqueda para propiedades enum. Esto es opcional. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca. Por ejemplo, si no proporcionas ningún operador para una propiedad enum priority con los valores posibles p0 y p1, una consulta que contenga el término p0 mostrará los elementos que tengan p0 como valor de la propiedad priority, así como los elementos que contengan la cadena p0 en otros campos. Si proporcionas un nombre de operador para la enumeración, como priority, los usuarios de la búsqueda pueden usar ese operador para definir mejor los resultados y mostrar solo los elementos que tienen p0 como valor de esta propiedad, con la consulta priority:p0.

Representación JSON
{
  "operatorName": string
}
Campos
operatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad enum. Por ejemplo, si operatorName es priority y el nombre de la propiedad es priorityVal, las consultas como priority:<value> muestran resultados solo cuando el valor de la propiedad llamada priorityVal coincide con <value>. Por el contrario, una búsqueda que usa el mismo <value> sin un operador muestra todos los elementos en los que <value> coincide con el valor de cualquier propiedad de String o texto dentro del campo de contenido del elemento. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

DatePropertyOptions

Las opciones para las propiedades de fecha.

Representación JSON
{
  "operatorOptions": {
    object (DatePropertyOptions.DateOperatorOptions)
  }
}
Campos
operatorOptions

object (DatePropertyOptions.DateOperatorOptions)

Si se establece, describe cómo se debe usar la fecha como operador de búsqueda.

DatePropertyOptions.DateOperatorOptions

Opcional. Proporciona un operador de búsqueda para propiedades de fecha. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca.

Representación JSON
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Campos
operatorName

string

Indica la cadena real requerida en la consulta para aislar la propiedad de fecha. Por ejemplo, supongamos que un objeto de esquema de seguimiento de problemas tiene una propiedad llamada closeDate que especifica un operador con un operadorName de closedon. En el caso de las búsquedas en esos datos, las consultas como closedon:<value> muestran resultados solo cuando el valor de la propiedad closeDate coincide con <value>. Por el contrario, una búsqueda que usa el mismo <value> sin un operador muestra todos los elementos en los que <value> coincide con el valor de cualquier propiedad de String o texto dentro del campo de contenido del origen de datos indexado. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

lessThanOperatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de fecha con el operador menor que. Por ejemplo, si lessThanOperatorName es closedbefore y el nombre de la propiedad es closeDate, las consultas como closedbefore:<value> muestran resultados solo cuando el valor de la propiedad closeDate es anterior a <value>. El nombre del operador solo puede contener letras en minúsculas (a-z). La longitud máxima es de 32 caracteres.

greaterThanOperatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de fecha con el operador mayor que. Por ejemplo, si greaterThanOperatorName es closedafter y el nombre de la propiedad es closeDate, las consultas como closedafter:<value> muestran resultados solo cuando el valor de la propiedad closeDate es posterior a <value>. El nombre del operador solo puede contener letras en minúsculas (a-z). La longitud máxima es de 32 caracteres.

TextPropertyOptions

Las opciones para las propiedades de texto.

Representación JSON
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (TextPropertyOptions.TextOperatorOptions)
  }
}
Campos
retrievalImportance

object (RetrievalImportance)

Indica la importancia de la calidad de la búsqueda de los tokens dentro del campo cuando se usan para la recuperación.

operatorOptions

object (TextPropertyOptions.TextOperatorOptions)

Si se establece, describe cómo se debe usar la propiedad como un operador de búsqueda.

RetrievalImportance

Representación JSON
{
  "importance": enum (RetrievalImportance.Importance)
}
Campos
importance

enum (RetrievalImportance.Importance)

Indica la importancia de clasificación que se le otorga a la propiedad cuando coincide durante la recuperación. Una vez establecida, no se puede cambiar la importancia del token de una propiedad.

RetrievalImportance.Importance

Enumeraciones
DEFAULT Trata la coincidencia como una coincidencia de texto del cuerpo.
HIGHEST Trata la coincidencia como una coincidencia con el título del elemento.
HIGH Trata la concordancia con mayor importancia que el texto del cuerpo.
LOW Trata la coincidencia con una importancia menor que el texto del cuerpo.
NONE No realices coincidencias con este campo durante la recuperación. La propiedad se puede seguir usando para la coincidencia de operadores, la creación de facetas y las sugerencias si lo deseas.

TextPropertyOptions.TextOperatorOptions

Se usa para proporcionar un operador de búsqueda para propiedades de texto. Esto es opcional. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca.

Representación JSON
{
  "operatorName": string,
  "exactMatchWithOperator": boolean
}
Campos
operatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad de texto. Por ejemplo, si operatorName es subject y el nombre de la propiedad es subjectLine, las consultas como subject:<value> muestran resultados solo cuando el valor de la propiedad llamada subjectLine coincide con <value>. Por el contrario, una búsqueda que usa el mismo <value> sin un operador muestra todos los elementos en los que <value> coincide con el valor de cualquier propiedad de texto o texto dentro del campo de contenido del elemento. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

exactMatchWithOperator

boolean

Si es verdadero, el valor de texto se segmenta como un valor atómico en las búsquedas de operadores y las coincidencias de facetas. Por ejemplo, si el nombre del operador es "género" y el valor es "ciencia ficción", las restricciones de búsqueda "género:ciencia" y "género:ficción" no coinciden con el artículo, pero "género:ciencia ficción" sí. La coincidencia de valores de texto distingue mayúsculas de minúsculas y no quita caracteres especiales. Si es falso, el texto se tokeniza. Por ejemplo, si el valor es “ciencia ficción”, las búsquedas “género:ciencia” y “género:ficción” coinciden con el artículo.

HtmlPropertyOptions

Las opciones para las propiedades HTML.

Representación JSON
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (HtmlPropertyOptions.HtmlOperatorOptions)
  }
}
Campos
retrievalImportance

object (RetrievalImportance)

Indica la importancia de la calidad de la búsqueda de los tokens dentro del campo cuando se usan para la recuperación. Solo se puede establecer en DEFAULT o NONE.

operatorOptions

object (HtmlPropertyOptions.HtmlOperatorOptions)

Si se establece, describe cómo se debe usar la propiedad como un operador de búsqueda.

HtmlPropertyOptions.HtmlOperatorOptions

Se usa para proporcionar un operador de búsqueda para propiedades HTML. Esto es opcional. Los operadores query.search permiten a los usuarios restringir la búsqueda a campos específicos relevantes para el tipo de elemento que se busca.

Representación JSON
{
  "operatorName": string
}
Campos
operatorName

string

Indica el nombre del operador requerido en la consulta para aislar la propiedad html. Por ejemplo, si operatorName es subject y el nombre de la propiedad es subjectLine, las consultas como subject:<value> muestran resultados solo cuando el valor de la propiedad llamada subjectLine coincide con <value>. Por el contrario, una búsqueda que usa el mismo <value> sin un operador muestra todos los elementos en los que <value> coincide con el valor de cualquier propiedad o texto HTML dentro del campo de contenido del elemento. El nombre del operador solo puede contener letras minúsculas (a-z). La longitud máxima es de 32 caracteres.

PropertyDisplayOptions

Son las opciones de visualización de una propiedad.

Representación JSON
{
  "displayLabel": string
}
Campos
displayLabel

string

Es la etiqueta fácil de usar para la propiedad que se usa si se especifica que se debe mostrar en ObjectDisplayOptions. Si se proporciona, la etiqueta de visualización se muestra delante de los valores de la propiedad cuando esta forma parte de las opciones de visualización del objeto. Por ejemplo, si el valor de la propiedad es "1", es posible que el valor por sí solo no sea un contexto útil para el usuario. Si el nombre visible proporcionado fue "priority", el usuario verá "priority : 1" en los resultados de la búsqueda, lo que proporciona un contexto claro a los usuarios de la búsqueda. Este campo es OPCIONAL. Si no se proporciona, solo se mostrarán los valores de la propiedad. La longitud máxima es de 64 caracteres.