SearchResponse

La respuesta de la API de búsqueda. ID de NEXT: 17

Representación JSON 
{
  "queryInterpretation": {
    object (QueryInterpretation)
  },
  "results": [
    {
      object (SearchResult)
    }
  ],
  "structuredResults": [
    {
      object (StructuredResult)
    }
  ],
  "spellResults": [
    {
      object (SpellResult)
    }
  ],
  "facetResults": [
    {
      object (FacetResult)
    }
  ],
  "hasMoreResults": boolean,
  "debugInfo": {
    object (ResponseDebugInfo)
  },
  "errorInfo": {
    object (ErrorInfo)
  },
  "resultCounts": {
    object (ResultCounts)
  },

  // Union field result_count can be only one of the following:
  "resultCountEstimate": string,
  "resultCountExact": string
  // End of list of possible types for union field result_count.
}
Campos
queryInterpretation

object (QueryInterpretation)

Es el resultado de la interpretación de la consulta del usuario. Estará vacío si la interpretación de consultas está inhabilitada.
results[]

object (SearchResult)

Resultados de una búsqueda.
structuredResults[]

object (StructuredResult)

Resultados estructurados para la consulta del usuario. Estos resultados no se tienen en cuenta en pageSize.
spellResults[]

object (SpellResult)

Ortografía sugerida para la búsqueda.
facetResults[]

object (FacetResult)

Resultados de facetas repetidos
hasMoreResults

boolean

Indica si hay más resultados de la búsqueda que coinciden con la consulta.
debugInfo

object (ResponseDebugInfo)

Información de depuración sobre la respuesta.
errorInfo

object (ErrorInfo)

Información de error sobre la respuesta.
resultCounts

object (ResultCounts)

Información expandida del recuento de resultados.

Campo de unión result_count. Es el recuento total de resultados en todas las fuentes de datos solicitadas. Se omite si se incluyen fuentes predefinidas en el conjunto de fuentes de datos consultadas. Los recuentos de resultados pueden mostrarse como una estimación, en lugar de un valor exacto, en las siguientes circunstancias:

  • Cuando la consulta tiene más de 2 términos en una frase, como "result count exact" entre comillas.

  • Cuando la cantidad de LCA de resultados de búsqueda únicos que se deben evaluar es demasiado grande para calcularse dentro de una latencia razonable.

En el caso poco frecuente en que el sistema no pueda buscar en todos los documentos, vuelve a ejecutar la consulta. result_count puede ser una de las siguientes opciones:
resultCountEstimate

string (int64 format)

Es el recuento estimado de resultados para esta consulta.
resultCountExact

string (int64 format)

Es el recuento exacto de resultados de esta consulta.

QueryInterpretation

Representación JSON 
{
  "interpretedQuery": string,
  "interpretationType": enum (QueryInterpretation.InterpretationType),
  "reason": enum (QueryInterpretation.Reason),
  "interpretedQueryActualResultCount": integer,
  "interpretedQueryEstimatedResultCount": string
}
Campos
interpretedQuery

string

Es la interpretación de la consulta que se usa en la búsqueda. Por ejemplo, las búsquedas con un intent de lenguaje natural, como "correo electrónico de Juan", se interpretarán como "from:juan source:mail". Este campo no se completará cuando el motivo sea NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY.
interpretationType

enum (QueryInterpretation.InterpretationType)
reason

enum (QueryInterpretation.Reason)

Es el motivo de la interpretación de la consulta. Este campo no será UNSPECIFIED si el tipo de interpretación no es NONE.
interpretedQueryActualResultCount

integer

Es la cantidad real de resultados que muestra la consulta interpretada.
interpretedQueryEstimatedResultCount

string (int64 format)

Es la cantidad estimada de resultados que muestra la consulta interpretada.

QueryInterpretation.InterpretationType

Enumeraciones
NONE No se usa la interpretación de lenguaje natural ni una versión más amplia de la consulta para recuperar los resultados de la búsqueda.
BLEND Los resultados de la consulta original se combinan con otros. El motivo por el que se combinan estos otros resultados con los de la consulta original se propaga en el campo "reason" que aparece a continuación.
REPLACE Se reemplazan los resultados de la consulta original. El motivo para reemplazar los resultados de la consulta original se propaga en el campo "reason" que aparece a continuación.

QueryInterpretation.Reason

Enumeraciones
UNSPECIFIED
QUERY_HAS_NATURAL_LANGUAGE_INTENT La interpretación de la consulta en lenguaje natural se usa para recuperar los resultados de la búsqueda.
NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY La similitud entre los términos de la consulta y los del documento se usa para ampliar de forma selectiva la búsqueda y recuperar resultados adicionales, ya que no se encontraron suficientes resultados para la búsqueda del usuario. La consulta interpretada estará vacía para este caso.

SearchResult

Resultados que contienen información indexada de un documento.

Representación JSON 
{
  "title": string,
  "url": string,
  "snippet": {
    object (Snippet)
  },
  "metadata": {
    object (Metadata)
  },
  "clusteredResults": [
    {
      object (SearchResult)
    }
  ],
  "debugInfo": {
    object (ResultDebugInfo)
  }
}
Campos
title

string

Es el título del resultado de la búsqueda.
url

string

La URL del resultado de la búsqueda. La URL contiene un redireccionamiento de Google al elemento real. Esta URL está firmada y no se debe cambiar.
snippet

object (Snippet)

Es la concatenación de todos los fragmentos (resúmenes) disponibles para este resultado.
metadata

object (Metadata)

los metadatos del resultado de la búsqueda.
clusteredResults[]

object (SearchResult)

Si la fuente está agrupada, proporciona una lista de los resultados agrupados. Solo habrá un nivel de resultados agrupados. Si la fuente actual no está habilitada para el agrupamiento, este campo estará vacío.
debugInfo

object (ResultDebugInfo)

Información de depuración sobre este resultado de la búsqueda.

Fragmento

Es el fragmento del resultado de la búsqueda, que resume el contenido de la página resultante.

Representación JSON 
{
  "snippet": string,
  "matchRanges": [
    {
      object (MatchRange)
    }
  ]
}
Campos
snippet

string

Es el fragmento del documento. Puede contener caracteres HTML escapados que se deben desescapar antes de la renderización.
matchRanges[]

object (MatchRange)

Los rangos coincidentes en el fragmento

MatchRange

Es el rango coincidente de un fragmento [inicio, fin].

Representación JSON 
{
  "start": integer,
  "end": integer
}
Campos
start

integer

Es la posición inicial de la coincidencia en el fragmento.
end

integer

Final de la coincidencia en el fragmento.

Metadatos

metadatos de un resultado de la búsqueda coincidente

Representación JSON 
{
  "source": {
    object (Source)
  },
  "mimeType": string,
  "thumbnailUrl": string,
  "owner": {
    object (Person)
  },
  "createTime": string,
  "updateTime": string,
  "fields": [
    {
      object (NamedProperty)
    }
  ],
  "displayOptions": {
    object (ResultDisplayMetadata)
  },
  "objectType": string
}
Campos
source

object (Source)

Es la fuente nombrada del resultado, como Gmail.
mimeType

string

Es el tipo de MIME del resultado de la búsqueda.
thumbnailUrl

string

Es la URL de la miniatura del resultado.
owner

object (Person)

propietario (por lo general, el creador) del documento o objeto del resultado de la búsqueda
createTime

string (Timestamp format)

Es la hora de creación de este documento o objeto en el resultado de la búsqueda.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Es la fecha de la última modificación del objeto en el resultado de la búsqueda. Si no se establece en el artículo, el valor que se muestra aquí está vacío. Cuando se usa updateTime para calcular la actualización y no se establece, este valor se establece de forma predeterminada en 2 años a partir de la hora actual.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
fields[]

object (NamedProperty)

Campos indexados en datos estructurados, que se muestran como una propiedad con nombre genérica.
displayOptions

object (ResultDisplayMetadata)

opciones que especifican cómo mostrar un resultado de la búsqueda de datos estructurados.
objectType

string

Es el tipo de objeto del resultado de la búsqueda.

ResultDisplayMetadata

Representación JSON 
{
  "objectTypeLabel": string,
  "metalines": [
    {
      object (ResultDisplayMetadata.ResultDisplayLine)
    }
  ]
}
Campos
objectTypeLabel

string

Es la etiqueta visible del objeto.
metalines[]

object (ResultDisplayMetadata.ResultDisplayLine)

Es el contenido de las líneas de metadatos que se mostrará con el resultado.

ResultDisplayMetadata.ResultDisplayLine

Es la colección de campos que conforman una línea que se muestra.

Representación JSON 
{
  "fields": [
    {
      object (ResultDisplayMetadata.ResultDisplayField)
    }
  ]
}
Campos
fields[]

object (ResultDisplayMetadata.ResultDisplayField)

ResultDisplayMetadata.ResultDisplayField

Campos de visualización para los resultados de la búsqueda

Representación JSON 
{
  "label": string,
  "operatorName": string,
  "property": {
    object (NamedProperty)
  }
}
Campos
label

string

Es la etiqueta visible de la propiedad.
operatorName

string

Es el nombre del operador de la propiedad.
property

object (NamedProperty)

El par nombre-valor de la propiedad.

ResultDebugInfo

Información de depuración sobre el resultado

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

string

Información de depuración general con formato para mostrar.

StructuredResult

Son resultados estructurados que se muestran como parte de una solicitud de búsqueda.

Representación JSON 
{

  // Union field structured_result can be only one of the following:
  "person": {
    object (Person)
  }
  // End of list of possible types for union field structured_result.
}
Campos

Campo de unión structured_result.

structured_result puede ser una de las siguientes opciones:
person

object (Person)

Representación de una persona

SpellResult

Representación JSON 
{
  "suggestedQuery": string,
  "suggestionType": enum (SpellResult.SuggestionType),
  "suggestedQueryHtml": {
    object (SafeHtmlProto)
  }
}
Campos
suggestedQuery

string

La ortografía sugerida de la consulta.
suggestionType

enum (SpellResult.SuggestionType)

sugerencia activada para la consulta actual.
suggestedQueryHtml

object (SafeHtmlProto)

El HTML limpio que representa la consulta corregida ortográficamente que se puede usar en la IU. Por lo general, tiene etiquetas específicas para cada idioma para marcar las partes de la consulta que se corrigen ortográficamente.

SpellResult.SuggestionType

Es el tipo de sugerencia activada para la consulta.

Enumeraciones
SUGGESTION_TYPE_UNSPECIFIED Tipo de corrector ortográfico predeterminado
NON_EMPTY_RESULTS_SPELL_SUGGESTION Sugerencia ortográfica sin ningún resultado modificado. Los resultados de la búsqueda original (que tiene resultados distintos de cero) se siguen mostrando con una sugerencia de ortografía que tendría resultados.
ZERO_RESULTS_FULL_PAGE_REPLACEMENT La sugerencia ortográfica se activa cuando la consulta original no tiene resultados. Cuando la consulta original no tiene resultados y la sugerencia ortográfica sí, activamos los resultados de la consulta corregida.

SafeHtmlProto

IMPORTANTE: No es seguro aceptar este mensaje de una fuente no confiable, ya que es trivial para un atacante falsificar mensajes serializados que no cumplen con el contrato de seguridad del tipo; por ejemplo, podría contener una secuencia de comandos controlada por un atacante. Un sistema que recibe un SafeHtmlProto confía implícitamente en el productor del SafeHtmlProto. Por lo tanto, en general, es seguro mostrar este mensaje en las respuestas de RPC, pero no es seguro aceptarlo en las solicitudes de RPC.

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

string

IMPORTANTE: Nunca configures ni leas este campo, incluso desde las pruebas, ya que es privado. Consulta la documentación en la parte superior del archivo .proto para ver los paquetes de lenguaje de programación con los que crear o leer este mensaje.

FacetResult

Respuesta de faceta específica de la fuente

Representación JSON 
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "buckets": [
    {
      object (FacetBucket)
    }
  ]
}
Campos
sourceName

string

Es el nombre de la fuente para la que se muestran los resultados de las facetas. No estará vacío.
objectType

string

Es el tipo de objeto para el que se muestran los resultados de las facetas. Puede estar vacío.
operatorName

string

Es el nombre del operador elegido para la división en facetas. @see cloudsearch.SchemaPropertyOptions
buckets[]

object (FacetBucket)

FacetBuckets para valores en la respuesta que contienen al menos un resultado con el filtro correspondiente.

FacetBucket

Un bucket en un atributo es la unidad básica de operación. Un bucket puede incluir un solo valor O un rango contiguo de valores, según el tipo de campo agrupado. Actualmente, FacetBucket solo se usa para mostrar el objeto de respuesta.

Representación JSON 
{
  "count": integer,
  "percentage": integer,
  "filter": {
    object (Filter)
  },

  // Union field bucket_value can be only one of the following:
  "value": {
    object (Value)
  }
  // End of list of possible types for union field bucket_value.
}
Campos
count

integer

Cantidad de resultados que coinciden con el valor del bucket. Los recuentos solo se muestran para las búsquedas cuando se garantiza la precisión del recuento. Cloud Search no garantiza los recuentos de facetas para ninguna consulta, y es posible que estos solo estén presentes de forma intermitente, incluso para consultas idénticas. No crees dependencias en la existencia del recuento de facetas. En su lugar, usa los porcentajes de recuento de facetas que siempre se muestran.
percentage

integer

Es el porcentaje de resultados que coinciden con el valor del bucket. El valor que se muestra está entre [0-100] y se redondea hacia abajo a un número entero si es fraccionario. Si el valor no se muestra de forma explícita, representa un valor porcentual que se redondea a 0. Los porcentajes se muestran para todas las búsquedas, pero son una estimación. Debido a que siempre se devuelven porcentajes, debes renderizar porcentajes en lugar de recuentos.
filter

object (Filter)

Es el filtro que se pasará en la solicitud de búsqueda si se selecciona el bucket correspondiente.
Campo de unión bucket_value. El rango o valor del bucket que tiene facetas bucket_value puede ser solo uno de los siguientes:
value

object (Value)

ResponseDebugInfo

Información de depuración sobre la respuesta.

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

string

Información de depuración general con formato para mostrar.

ErrorInfo

Información de error sobre la respuesta.

Representación JSON 
{
  "errorMessages": [
    {
      object (ErrorMessage)
    }
  ]
}
Campos
errorMessages[]

object (ErrorMessage)

ErrorMessage

Mensaje de error por respuesta de la fuente

Representación JSON 
{
  "source": {
    object (Source)
  },
  "errorMessage": string
}
Campos
source

object (Source)
errorMessage

string

ResultCounts

Información del recuento de resultados

Representación JSON 
{
  "sourceResultCounts": [
    {
      object (SourceResultCount)
    }
  ]
}
Campos
sourceResultCounts[]

object (SourceResultCount)

Información del recuento de resultados para cada fuente con resultados.

SourceResultCount

Información del recuento de resultados por fuente

Representación JSON 
{
  "source": {
    object (Source)
  },
  "hasMoreResults": boolean,

  // Union field result_count can be only one of the following:
  "resultCountEstimate": string,
  "resultCountExact": string
  // End of list of possible types for union field result_count.
}
Campos
source

object (Source)

Es la fuente con la que está asociada la información del recuento de resultados.
hasMoreResults

boolean

Indica si hay más resultados de la búsqueda para esta fuente.

Campo de unión result_count.

result_count puede ser una de las siguientes opciones:
resultCountEstimate

string (int64 format)

Es el recuento estimado de resultados para esta fuente.
resultCountExact

string (int64 format)

Es el recuento exacto de resultados de esta fuente.