Method: query.sources.list

Renvoie la liste des sources que l'utilisateur peut utiliser pour les API query.search et Suggest.

Remarque:Pour s'exécuter, cette API nécessite un compte utilisateur final standard. Un compte de service ne peut pas effectuer directement de requêtes à l'API Query. Pour utiliser un compte de service pour effectuer des requêtes, configurez la délégation d'autorité au niveau du domaine Google Workspace.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
requestOptions

object (RequestOptions)

Options de requête, telles que l'application de recherche et le fuseau horaire de l'utilisateur.

pageToken

string

Nombre de sources à renvoyer dans la réponse.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Réponse de la liste des sources.

Représentation JSON
{
  "sources": [
    {
      object (QuerySource)
    }
  ],
  "nextPageToken": string
}
Champs
sources[]

object (QuerySource)

nextPageToken

string

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez le guide d'autorisation.

QuerySource

Liste des sources que l'utilisateur peut rechercher à l'aide de l'API de requête.

Représentation JSON
{
  "source": {
    object (Source)
  },
  "shortName": string,
  "displayName": string,
  "operators": [
    {
      object (QueryOperator)
    }
  ]
}
Champs
source

object (Source)

Nom de la source

shortName

string

Nom court ou alias de la source. Cette valeur peut être utilisée avec l'opérateur "source".

displayName

string

Nom à afficher de la source de données.

operators[]

object (QueryOperator)

Liste de tous les opérateurs applicables à cette source.

QueryOperator

Définition d'un opérateur pouvant être utilisé dans une requête query.search/query.suggest.

Représentation 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
}
Champs
operatorName

string

Nom de l'opérateur.

lessThanOperatorName

string

Indique le nom de l'opérateur qui peut être utilisé pour isoler la propriété à l'aide de l'opérateur inférieur.

greaterThanOperatorName

string

Indique le nom de l'opérateur qui peut être utilisé pour isoler la propriété à l'aide de l'opérateur "supérieur à".

type

enum (QueryOperator.Type)

Type de l'opérateur.

displayName

string

Nom à afficher de l'opérateur

isSortable

boolean

Cet opérateur peut-il être utilisé pour trier les résultats ?

isFacetable

boolean

Cet opérateur peut-il être utilisé pour obtenir des facettes ?

isReturnable

boolean

Indique si la propriété associée à cet attribut sera renvoyée dans les résultats de recherche.

isRepeatable

boolean

Indique si plusieurs valeurs peuvent être définies pour cette propriété.

isSuggestable

boolean

Vous pouvez obtenir des suggestions pour ce champ.

enumValues[]

string

Liste des valeurs possibles pour le champ "opérateur". Ce champ n'est renseigné que lorsque nous pouvons énumérer en toute sécurité toutes les valeurs possibles de cet opérateur.

objectType

string

Nom de l'objet correspondant à l'opérateur. Ce champ n'est renseigné que pour les opérateurs spécifiques au schéma et n'est pas défini pour les opérateurs courants.

QueryOperator.Type

Type de l'établissement référencé par l'opérateur.

Enums
UNKNOWN Valeur incorrecte.
INTEGER
DOUBLE
TIMESTAMP
BOOLEAN
ENUM
DATE
TEXT
HTML