Suggestion de termes de requête
Avertissement
Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.
En général, vous appelez l’API Suggestion automatique Bing chaque fois qu’un utilisateur tape un nouveau caractère dans la zone de recherche de votre application. L’exhaustivité de la chaîne de requête conditionne la pertinence des termes suggérés par l’API. Plus la chaîne de requête est complète, plus la liste de termes suggérés est pertinente. Par exemple, les suggestions que l’API peut retourner pour s sont probablement moins pertinentes que celles retournées pour sailing dinghies (dériveurs).
Exemple de requête
L’exemple suivant illustre une requête qui renvoie les chaînes de requête suggérées pour sail (voile). N’oubliez pas d’encoder en URL le terme de requête partiel de l’utilisateur quand vous définissez le paramètre de requête q. Par exemple, si l’utilisateur a tapé sailing les, affectez la valeur sailing+les ou sailing%20les à q.
GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com
La réponse suivante contient une liste d’objets SearchAction contenant les termes de requête suggérés.
{
"url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "WebSearch"
}, ...
Utilisation des termes de requête suggérés
Chaque suggestion comporte les champs displayText, query et url. Le champ displayText correspond à la requête suggérée que vous utilisez pour remplir la liste déroulante de la zone de recherche. Vous devez afficher toutes les suggestions incluses dans la réponse, dans l’ordre indiqué.
L’exemple suivant montre une zone déroulante de recherche avec les termes de requête suggérés provenant de l’API Suggestion automatique Bing.
Si l’utilisateur sélectionnait une suggestion de requête dans la liste déroulante, vous utiliseriez la chaîne de requête du champ query pour appeler l’API Recherche Web Bing et afficher vous-même les résultats. Vous pourriez aussi utiliser l’URL du champ url pour rediriger plutôt l’utilisateur vers la page des résultats de la recherche Bing.