SearchResponse

A resposta da API Search. ID do PRÓXIMO: 17

Representação 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)

Resultado da interpretação da consulta para a consulta do usuário. Vazia se a interpretação de consulta estiver desativada.
results[]

object (SearchResult)

Resultados de uma consulta de pesquisa.
structuredResults[]

object (StructuredResult)

Resultados estruturados para a consulta do usuário. Esses resultados não são contabilizados em relação ao pageSize.
spellResults[]

object (SpellResult)

Sugestão de ortografia para a consulta.
facetResults[]

object (FacetResult)

Resultados de atributos repetidos.
hasMoreResults

boolean

Se há mais resultados de pesquisa que correspondem à consulta.
debugInfo

object (ResponseDebugInfo)

Informações de depuração sobre a resposta.
errorInfo

object (ErrorInfo)

Informações de erro sobre a resposta.
resultCounts

object (ResultCounts)

Informações sobre a contagem de resultados expandida.

Campo de união result_count. A contagem total de resultados em todas as origens de dados solicitadas. Omitido se fontes predefinidas forem incluídas no conjunto de fontes de dados consultadas. As contagens de resultados podem ser retornadas como uma estimativa, em vez de exatas, nas seguintes circunstâncias:

  • Quando a consulta tem mais de dois termos em uma frase, como "result count exact" entre aspas.

  • Quando o número de ACLs de resultados de pesquisa únicos a serem avaliados é muito grande para ser calculado com uma latência razoável.

No caso raro em que o sistema não consegue pesquisar todos os documentos, execute a consulta novamente. result_count pode ser apenas de um dos tipos a seguir:
resultCountEstimate

string (int64 format)

A contagem de resultados estimada para essa consulta.
resultCountExact

string (int64 format)

A contagem exata de resultados para esta consulta.

QueryInterpretation

Representação JSON 
{
  "interpretedQuery": string,
  "interpretationType": enum (QueryInterpretation.InterpretationType),
  "reason": enum (QueryInterpretation.Reason),
  "interpretedQueryActualResultCount": integer,
  "interpretedQueryEstimatedResultCount": string
}
Campos
interpretedQuery

string

A interpretação da consulta usada na pesquisa. Por exemplo, consultas com a intenção de linguagem natural, como "e-mail de João", serão interpretadas como "from:joão source:mail". Este campo não será preenchido quando o motivo for NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY.
interpretationType

enum (QueryInterpretation.InterpretationType)
reason

enum (QueryInterpretation.Reason)

O motivo da interpretação da consulta. Esse campo não será UNSPECIFIED se o tipo de interpretação não for NONE.
interpretedQueryActualResultCount

integer

O número real de resultados retornados pela consulta interpretada.
interpretedQueryEstimatedResultCount

string (int64 format)

O número estimado de resultados retornados pela consulta interpretada.

QueryInterpretation.InterpretationType

Enums
NONE Nem a interpretação da linguagem natural nem uma versão mais ampla da consulta são usadas para buscar os resultados da pesquisa.
BLEND Os resultados da consulta original são mesclados com outros resultados. O motivo para combinar esses outros resultados com os resultados da consulta original é preenchido no campo "Motivo" abaixo.
REPLACE Os resultados da consulta original são substituídos. O motivo da substituição dos resultados da consulta original é preenchido no campo "Motivo" abaixo.

QueryInterpretation.Reason

Enums
UNSPECIFIED
QUERY_HAS_NATURAL_LANGUAGE_INTENT A interpretação da consulta em linguagem natural é usada para buscar os resultados da pesquisa.
NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY A semelhança entre os termos da consulta e do documento é usada para ampliar seletivamente a consulta e recuperar outros resultados de pesquisa, já que não foram encontrados resultados suficientes para a consulta do usuário. A consulta interpretada vai estar vazia para esse caso.

SearchResult

Resultados que contêm informações indexadas de um documento.

Representação JSON 
{
  "title": string,
  "url": string,
  "snippet": {
    object (Snippet)
  },
  "metadata": {
    object (Metadata)
  },
  "clusteredResults": [
    {
      object (SearchResult)
    }
  ],
  "debugInfo": {
    object (ResultDebugInfo)
  }
}
Campos
title

string

Título do resultado da pesquisa.
url

string

O URL do resultado da pesquisa. O URL contém um redirecionamento do Google para o item real. Esse URL está assinado e não pode ser alterado.
snippet

object (Snippet)

A concatenação de todos os trechos (resumos) disponíveis para esse resultado.
metadata

object (Metadata)

metadados do resultado da pesquisa.
clusteredResults[]

object (SearchResult)

Se a origem for agrupada, forneça uma lista de resultados agrupados. Só haverá um nível de resultados agrupados. Se a origem atual não estiver ativada para agrupamento, esse campo vai ficar vazio.
debugInfo

object (ResultDebugInfo)

Informações de depuração sobre esse resultado da pesquisa.

Snippet

Snippet do resultado da pesquisa, que resume o conteúdo da página resultante.

Representação JSON 
{
  "snippet": string,
  "matchRanges": [
    {
      object (MatchRange)
    }
  ]
}
Campos
snippet

string

O snippet do documento. Pode conter caracteres HTML escapados que precisam ser desativados antes da renderização.
matchRanges[]

object (MatchRange)

Os intervalos correspondentes no snippet.

MatchRange

Intervalo correspondente de um snippet [início, fim].

Representação JSON 
{
  "start": integer,
  "end": integer
}
Campos
start

integer

Posição inicial da correspondência no snippet.
end

integer

Fim da correspondência no snippet.

Metadados

metadados de um resultado de pesquisa correspondente.

Representação 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)

A origem nomeada do resultado, como o Gmail.
mimeType

string

Tipo MIME do resultado da pesquisa.
thumbnailUrl

string

O URL da miniatura do resultado.
owner

object (Person)

proprietário (geralmente o criador) do documento ou objeto do resultado da pesquisa.
createTime

string (Timestamp format)

A hora de criação do documento ou objeto no resultado da pesquisa.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

A data da última modificação do objeto no resultado da pesquisa. Se não for definido no item, o valor retornado aqui vai estar vazio. Quando updateTime é usado para calcular a atualização e não está definido, esse valor é definido como 2 anos a partir do momento atual.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
fields[]

object (NamedProperty)

Campos indexados em dados estruturados, retornados como uma propriedade nomeada genérica.
displayOptions

object (ResultDisplayMetadata)

opções que especificam como mostrar um resultado de pesquisa de dados estruturados.
objectType

string

Tipo de objeto do resultado da pesquisa.

ResultDisplayMetadata

Representação JSON 
{
  "objectTypeLabel": string,
  "metalines": [
    {
      object (ResultDisplayMetadata.ResultDisplayLine)
    }
  ]
}
Campos
objectTypeLabel

string

O rótulo de exibição do objeto.
metalines[]

object (ResultDisplayMetadata.ResultDisplayLine)

O conteúdo das metalinhas que será mostrado com o resultado.

ResultDisplayMetadata.ResultDisplayLine

A coleção de campos que compõem uma linha exibida

Representação JSON 
{
  "fields": [
    {
      object (ResultDisplayMetadata.ResultDisplayField)
    }
  ]
}
Campos
fields[]

object (ResultDisplayMetadata.ResultDisplayField)

ResultDisplayMetadata.ResultDisplayField

Campos de exibição para resultados da pesquisa

Representação JSON 
{
  "label": string,
  "operatorName": string,
  "property": {
    object (NamedProperty)
  }
}
Campos
label

string

O rótulo de exibição da propriedade.
operatorName

string

O nome do operador da propriedade.
property

object (NamedProperty)

O par de nome e valor da propriedade.

ResultDebugInfo

Informações de depuração sobre o resultado.

Representação JSON 
{
  "formattedDebugInfo": string
}
Campos
formattedDebugInfo

string

Informações gerais de depuração formatadas para exibição.

StructuredResult

Resultados estruturados que são retornados como parte da solicitação de pesquisa.

Representação 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ão structured_result.

structured_result pode ser apenas de um dos tipos a seguir:
person

object (Person)

Representação de uma pessoa

SpellResult

Representação JSON 
{
  "suggestedQuery": string,
  "suggestionType": enum (SpellResult.SuggestionType),
  "suggestedQueryHtml": {
    object (SafeHtmlProto)
  }
}
Campos
suggestedQuery

string

A ortografia sugerida da consulta.
suggestionType

enum (SpellResult.SuggestionType)

sugestão acionada para a consulta atual.
suggestedQueryHtml

object (SafeHtmlProto)

O HTML limpo que representa a consulta com grafia corrigida que pode ser usada na interface. Geralmente, ele tem tags específicas para marcar partes da consulta que são verificadas quanto à ortografia.

SpellResult.SuggestionType

O tipo de sugestão acionada para a consulta.

Enums
SUGGESTION_TYPE_UNSPECIFIED Tipo de verificação ortográfica padrão
NON_EMPTY_RESULTS_SPELL_SUGGESTION Sugestão de ortografia sem resultados alterados. Os resultados ainda são mostrados para a consulta original (que tem resultados não nulos) com uma sugestão de ortografia que teria resultados.
ZERO_RESULTS_FULL_PAGE_REPLACEMENT Sugestão de ortografia acionada quando a consulta original não tem resultados. Quando a consulta original não tem resultados e a sugestão de ortografia tem, nós acionamos os resultados para a consulta corrigida.

SafeHtmlProto

IMPORTANTE: não é seguro aceitar essa mensagem de uma fonte não confiável, já que é trivial para um invasor falsificar mensagens serializadas que não cumprem o contrato de segurança do tipo. Por exemplo, ela pode conter um script controlado pelo invasor. Um sistema que recebe um SafeHtmlProto confia implicitamente no produtor do SafeHtmlProto. Portanto, geralmente é seguro retornar essa mensagem em respostas de RPC, mas não é seguro aceitá-la em solicitações de RPC.

Representação JSON 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Campos
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

IMPORTANTE: nunca defina ou leia este campo, mesmo em testes, porque ele é privado. Consulte a documentação na parte de cima do arquivo .proto para conferir os pacotes de linguagem de programação com os quais criar ou ler essa mensagem.

FacetResult

Resposta de faceta específica da origem

Representação JSON 
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "buckets": [
    {
      object (FacetBucket)
    }
  ]
}
Campos
sourceName

string

Nome da origem para os resultados de atributos retornados. Não pode estar em branco.
objectType

string

Tipo de objeto para o qual os resultados de facetas são retornados. Pode ficar vazio.
operatorName

string

O nome do operador escolhido para a divisão em facetas. @see cloudsearch.SchemaPropertyOptions
buckets[]

object (FacetBucket)

FacetBuckets para valores na resposta que contêm pelo menos um único resultado com o filtro correspondente.

FacetBucket

Um bucket em uma faceta é a unidade básica de operação. Um bucket pode incluir um único valor OU um intervalo contínuo de valores, dependendo do tipo de bucket de campo. No momento, o FacetBucket é usado apenas para retornar o objeto de resposta.

Representação 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

Número de resultados que correspondem ao valor do bucket. Os números são retornados apenas para pesquisas quando a precisão do cálculo é garantida. O Cloud Search não garante a contagem de facetas para nenhuma consulta, e as contagens de facetas podem estar presentes apenas de forma intermitente, mesmo para consultas idênticas. Não crie dependências na existência da contagem de facetas. Use as porcentagens de contagem de facetas, que são sempre retornadas.
percentage

integer

Porcentagem de resultados que correspondem ao valor do bucket. O valor retornado está entre (0-100] e é arredondado para um número inteiro se for fracionário. Se o valor não for retornado explicitamente, ele vai representar um valor percentual arredondado para 0. As porcentagens são retornadas para todas as pesquisas, mas são uma estimativa. Como as porcentagens são sempre retornadas, renderize porcentagens em vez de contagens.
filter

object (Filter)

Filtro a ser transmitido na solicitação de pesquisa se o bucket correspondente for selecionado.
Campo de união bucket_value. O intervalo ou valor do bucket que é bucket_value com facetas só pode ser uma das seguintes opções:
value

object (Value)

ResponseDebugInfo

Informações de depuração sobre a resposta.

Representação JSON 
{
  "formattedDebugInfo": string
}
Campos
formattedDebugInfo

string

Informações gerais de depuração formatadas para exibição.

ErrorInfo

Informações de erro sobre a resposta.

Representação JSON 
{
  "errorMessages": [
    {
      object (ErrorMessage)
    }
  ]
}
Campos
errorMessages[]

object (ErrorMessage)

ErrorMessage

Mensagem de erro por resposta de origem.

Representação JSON 
{
  "source": {
    object (Source)
  },
  "errorMessage": string
}
Campos
source

object (Source)
errorMessage

string

ResultCounts

Informações sobre a contagem de resultados

Representação JSON 
{
  "sourceResultCounts": [
    {
      object (SourceResultCount)
    }
  ]
}
Campos
sourceResultCounts[]

object (SourceResultCount)

Informações sobre a contagem de resultados para cada fonte com resultados.

SourceResultCount

Informações de contagem de resultados por origem.

Representação 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)

A origem com que as informações de contagem de resultados estão associadas.
hasMoreResults

boolean

Se há mais resultados de pesquisa para essa origem.

Campo de união result_count.

result_count pode ser apenas de um dos tipos a seguir:
resultCountEstimate

string (int64 format)

A contagem de resultados estimados para essa origem.
resultCountExact

string (int64 format)

A contagem exata de resultados para essa origem.