Method: query.sources.list

Retorna uma lista de origens que o usuário pode usar para as APIs query.search e Suggest.

Observação:essa API requer uma conta de usuário final padrão para ser executada. Uma conta de serviço não pode realizar 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

GET https://cloudsearch.googleapis.com/v1/query/sources

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
requestOptions

object (RequestOptions)

Opções de solicitação, como o app de pesquisa e o fuso horário do usuário.

pageToken

string

Número de origens a serem retornadas na resposta.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Resposta da lista de origens.

Representação JSON
{
  "sources": [
    {
      object (QuerySource)
    }
  ],
  "nextPageToken": string
}
Campos
sources[]

object (QuerySource)

nextPageToken

string

Escopos de autorização

Requer um dos seguintes escopos do 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.

QuerySource

Lista de origens que o usuário pode pesquisar usando a API de consulta.

Representação JSON
{
  "source": {
    object (Source)
  },
  "shortName": string,
  "displayName": string,
  "operators": [
    {
      object (QueryOperator)
    }
  ]
}
Campos
source

object (Source)

O nome da origem

shortName

string

Um nome curto ou alias para a fonte. Esse valor pode ser usado com o atributo "source" usando um operador lógico.

displayName

string

Nome de exibição da fonte de dados.

operators[]

object (QueryOperator)

Lista de todos os operadores aplicáveis a esta fonte.

QueryOperator

A definição de um operador que pode ser usado em uma solicitação query.search/query.suggest.

Representação JSON
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string,
  "type": enum (QueryOperator.Type),
  "displayName": string,
  "isSortable": boolean,
  "isFacetable": boolean,
  "isReturnable": boolean,
  "isRepeatable": boolean,
  "isSuggestable": boolean,
  "enumValues": [
    string
  ],
  "objectType": string
}
Campos
operatorName

string

O nome do operador.

lessThanOperatorName

string

Indica o nome do operador que pode ser usado para isolar a propriedade usando o operador menor que.

greaterThanOperatorName

string

Indica o nome do operador que pode ser usado para isolar a propriedade usando o operador "maior que".

type

enum (QueryOperator.Type)

O tipo do operador.

displayName

string

Nome de exibição do operador

isSortable

boolean

Este operador pode ser usado para classificar os resultados?

isFacetable

boolean

Esse operador pode ser usado para receber atributos.

isReturnable

boolean

A propriedade associada a esse atributo será retornada como parte dos resultados da pesquisa?

isRepeatable

boolean

Indica se vários valores podem ser definidos para essa propriedade.

isSuggestable

boolean

Pode receber sugestões para este campo.

enumValues[]

string

Lista de valores potenciais para o campo operacional. Esse campo só é preenchido quando podemos enumerar com segurança todos os valores possíveis desse operador.

objectType

string

O nome do objeto correspondente ao operador. Este campo só é preenchido para operadores específicos do esquema e não é definido para operadores comuns.

QueryOperator.Type

O tipo de propriedade indicada pelo operador.

Enums
UNKNOWN Valor inválido.
INTEGER
DOUBLE
TIMESTAMP
BOOLEAN
ENUM
DATE
TEXT
HTML