Method: query.suggest

Fournit des suggestions pour la saisie semi-automatique de la requête.

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

Requête HTTP

POST https://cloudsearch.googleapis.com/v1/query/suggest

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "requestOptions": {
    object (RequestOptions)
  },
  "query": string,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ]
}
Champs
requestOptions

object (RequestOptions)

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

string

Requête partielle pour laquelle des suggestions de saisie semi-automatique seront affichées. Par exemple, si la requête est "mer", le serveur peut renvoyer "saison", "recherche", "mouette". et ainsi de suite.
dataSourceRestrictions[]

object (DataSourceRestriction)

Sources à utiliser pour les suggestions. Si aucune valeur n'est spécifiée, les sources de données sont extraites de l'application de recherche actuelle.

REMARQUE: Les suggestions ne sont acceptées que pour les sources suivantes:

  • Sources de données tierces
  • PredefinedSource.PERSON
  • PredefinedSource.GOOGLE_DRIVE

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 l'API de suggestion.

Représentation JSON 
{
  "suggestResults": [
    {
      object (SuggestResult)
    }
  ]
}
Champs
suggestResults[]

object (SuggestResult)

Liste de suggestions.

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 relatif aux autorisations.

SuggestResult

Un résultat de suggestion.

Représentation JSON 
{
  "suggestedQuery": string,
  "source": {
    object (Source)
  },

  // Union field suggestion can be only one of the following:
  "querySuggestion": {
    object (QuerySuggestion)
  },
  "peopleSuggestion": {
    object (PeopleSuggestion)
  }
  // End of list of possible types for union field suggestion.
}
Champs
suggestedQuery

string

Requête suggérée qui sera utilisée pour la recherche lorsque l'utilisateur clique sur la suggestion
source

object (Source)

Source de la suggestion.
Champ d'union suggestion. Contient des métadonnées supplémentaires sur la requête suggérée. Il indique également le type de requête suggérée. Par exemple, Si PeopleSuggestion est présent, cela signifie que suggest_query est une suggestion de personne. suggestion ne peut être qu'un des éléments suivants :
querySuggestion

object (QuerySuggestion)

Ce champ apparaît si la requête suggérée consiste à compléter un mot/une expression.
peopleSuggestion

object (PeopleSuggestion)

Il apparaît lorsque la suggestion indique une personne. Elle contient plus d'informations sur la personne, comme son adresse e-mail, son nom, etc.

QuerySuggestion

Ce champ ne contient rien pour le moment. Il sert simplement à indiquer que le résultat de la suggestion était la saisie semi-automatique.

PeopleSuggestion

Ce champ contient des informations sur la personne suggérée.

Représentation JSON 
{
  "person": {
    object (Person)
  }
}
Champs
person

object (Person)

Contact suggéré. Il est possible que tous les champs de l'objet personne ne soient pas renseignés.