- Solicitação HTTP
- Corpo da solicitação
- Corpo da resposta
- Escopos da autorização
- SuggestResult
- QuerySuggestion
- PeopleSuggestion
- Faça um teste
Fornece sugestões para preencher automaticamente a consulta.
Observação:para executar essa API, é preciso ter uma conta de usuário final padrão. Uma conta de serviço não pode fazer solicitações da API Query diretamente. Se você quiser usar uma conta de serviço para fazer consultas, configure a delegação de autoridade em todo o domínio do Google Workspace.
Solicitação HTTP
POST https://cloudsearch.googleapis.com/v1/query/suggest
O URL usa a sintaxe de transcodificação gRPC.
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "requestOptions": { object ( |
Campos | |
---|---|
requestOptions |
Opções de solicitação, como o app de pesquisa e o fuso horário do usuário. |
query |
Consulta parcial para a qual as sugestões de preenchimento automático serão mostradas. Por exemplo, se a consulta for "sea", o servidor poderá retornar "temporada", "pesquisa", "gaivota" e assim por diante. |
dataSourceRestrictions[] |
As fontes a serem usadas para sugestões. Se não for especificado, as origens de dados vão ser extraídas do app de pesquisa atual. OBSERVAÇÃO: as sugestões são compatíveis apenas com as seguintes origens:
|
Corpo da resposta
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Resposta da API de sugestão.
Representação JSON |
---|
{
"suggestResults": [
{
object ( |
Campos | |
---|---|
suggestResults[] |
Lista de sugestões. |
Escopos de autorização
Requer um dos seguintes escopos de OAuth:
https://www.googleapis.com/auth/cloud_search.query
https://www.googleapis.com/auth/cloud_search
Para mais informações, consulte o Guia de autorização.
SuggestResult
Um resultado de sugestão.
Representação JSON |
---|
{ "suggestedQuery": string, "source": { object ( |
Campos | |
---|---|
suggestedQuery |
A consulta sugerida que será usada para a pesquisa quando o usuário clicar na sugestão. |
source |
A fonte da sugestão. |
Campo de união suggestion . Contém metadados adicionais sobre a consulta sugerida. Ela também indica o tipo de consulta sugerida. Por exemplo, se PeopleSuggestion está presente, indica queger_query é uma sugestão de pessoa. suggestion pode ser apenas de um dos tipos a seguir: |
|
querySuggestion |
Este campo estará presente se a consulta sugerida for uma conclusão de palavra/frase. |
peopleSuggestion |
Presente quando a sugestão indica uma pessoa. Ele contém mais informações sobre a pessoa, como ID de e-mail, nome etc. |
QuerySuggestion
Este campo não contém nada a partir de agora e é usado apenas como um indicador de que o resultado da sugestão foi a conclusão de uma frase.
PeopleSuggestion
Esse campo contém informações sobre a pessoa que está sendo sugerida.
Representação JSON |
---|
{
"person": {
object ( |
Campos | |
---|---|
person |
Pessoa sugerida. Nem todos os campos do objeto pessoa podem ser preenchidos. |