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 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

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 "Season", "search", "seagull", etc.
dataSourceRestrictions[]

object (DataSourceRestriction)

Sources à utiliser pour les suggestions. Si aucune valeur n'est spécifiée, les sources de données sont issues 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 Suggestions.

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 est utilisée pour la recherche lorsque l'utilisateur clique dessus
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 la requête suggérée. Par exemple, si "PeopleSuggestion" est présent, "suggested_query" est une suggestion de personne. suggestion ne peut être qu'un des éléments suivants :
querySuggestion

object (QuerySuggestion)

Ce champ sera visible si la requête suggérée est une saisie semi-automatique.
peopleSuggestion

object (PeopleSuggestion)

Ceci est présent 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 l'instant et sert uniquement à indiquer que le résultat de la suggestion était une expression complète.

PeopleSuggestion

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

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

object (Person)

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