Method: query.sources.list

Restituisce l'elenco delle origini che l'utente può utilizzare per le API query.search e Suggest.

Nota:per l'esecuzione di questa API è necessario un account utente finale standard. Un account di servizio non può eseguire direttamente richieste all'API Query. Per utilizzare un account di servizio per eseguire query, configura la delega dell'autorità a livello di dominio di Google Workspace.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
requestOptions

object (RequestOptions)

Opzioni di richiesta, ad esempio l'applicazione di ricerca e il fuso orario dell'utente.
pageToken

string

Numero di origini da restituire nella risposta.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Risposta dell'elenco di origini.

Rappresentazione JSON 
{
  "sources": [
    {
      object (QuerySource)
    }
  ],
  "nextPageToken": string
}
Campi
sources[]

object (QuerySource)
nextPageToken

string

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud_search.query
  • https://www.googleapis.com/auth/cloud_search

Per ulteriori informazioni, consulta la Guida alle autorizzazioni.

QuerySource

Elenco di origini in cui l'utente può eseguire ricerche utilizzando l'API Query.

Rappresentazione JSON 
{
  "source": {
    object (Source)
  },
  "shortName": string,
  "displayName": string,
  "operators": [
    {
      object (QueryOperator)
    }
  ]
}
Campi
source

object (Source)

Il nome della fonte
shortName

string

Un nome breve o alias per la fonte. Questo valore può essere utilizzato con l'operatore "source".
displayName

string

Nome visualizzato dell'origine dati.
operators[]

object (QueryOperator)

Elenco di tutti gli operatori applicabili per questa origine.

QueryOperator

La definizione di un operatore che può essere utilizzato in una richiesta query.search/query.suggest.

Rappresentazione 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
}
Campi
operatorName

string

Il nome dell'operatore.
lessThanOperatorName

string

Indica il nome dell'operatore che può essere utilizzato per isolare la proprietà utilizzando l'operatore minore di.
greaterThanOperatorName

string

Indica il nome dell'operatore che può essere utilizzato per isolare la proprietà utilizzando l'operatore maggiore di.
type

enum (QueryOperator.Type)

Il tipo di operatore.
displayName

string

Nome visualizzato dell'operatore
isSortable

boolean

Questo operatore può essere utilizzato per ordinare i risultati?
isFacetable

boolean

Questo operatore può essere utilizzato per ottenere facet?
isReturnable

boolean

La proprietà associata a questo facet verrà restituita nei risultati di ricerca?
isRepeatable

boolean

Indica se è possibile impostare più valori per questa proprietà.
isSuggestable

boolean

Consente di ottenere suggerimenti per questo campo.
enumValues[]

string

Potenziale elenco di valori per il campo opeatror. Questo campo viene compilato solo quando possiamo enumerare in modo sicuro tutti i valori possibili di questo operatore.
objectType

string

Il nome dell'oggetto corrispondente all'operatore. Questo campo viene compilato solo per gli operatori specifici dello schema e non è impostato per gli operatori comuni.

QueryOperator.Type

Il tipo di proprietà a cui fa riferimento l'operatore.

Enum
UNKNOWN Valore non valido.
INTEGER
DOUBLE
TIMESTAMP
BOOLEAN
ENUM
DATE
TEXT
HTML