Démarrage rapide : Appeler votre point de terminaison Recherche personnalisée Bing avec Python

Article
05/08/2020

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.

Utilisez ce guide de démarrage rapide pour découvrir comment demander des résultats de recherche à partir de votre instance Recherche personnalisée Bing. Bien que cette application est écrite en Python, l’API Recherche personnalisée Bing constitue un service web RESTful compatible avec la plupart des langages de programmation. Le code source de cet exemple est disponible sur GitHub.

Prérequis

Une instance Recherche personnalisée Bing. Pour plus d’informations, consultez Démarrage rapide : Créer votre première instance de Recherche personnalisée Bing.
Python 2.x ou 3.x.

Créer une ressource Azure

Commencez à utiliser l’API Recherche personnalisée Bing en créant une des ressources Azure suivantes.

Ressource Recherche personnalisée Bing

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez le niveau tarifaire Gratuit pour tester le service, puis effectuez par la suite une mise à niveau vers un niveau payant pour la production.

Ressource multiservice

Disponible via le portail Azure jusqu’à ce que vous supprimiez la ressource.
Utilisez la même clé et le même point de terminaison pour vos applications, sur plusieurs services Azure AI.

Créer et initialiser l’application

Créez un fichier Python dans votre éditeur ou IDE favori, puis ajoutez les instructions d’importation suivantes. Créez des variables pour votre clé d’abonnement, votre ID de configuration personnalisée et un terme de recherche.
```
import json
import requests

subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
customConfigId = "YOUR-CUSTOM-CONFIG-ID"
searchTerm = "microsoft"
```

Envoyer et recevoir une requête de recherche

Construisez l’URL de requête en ajoutant votre terme de recherche au paramètre de requête q=, et l’ID de configuration personnalisée de votre instance de recherche au paramètre customconfig=. Séparez les paramètres par une esperluette (&). Vous pouvez utiliser le point de terminaison global dans le code suivant, ou le point de terminaison de sous-domaine personnalisé affiché dans le portail Azure pour votre ressource.
```
url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
```
Envoyez la requête à votre instance Recherche personnalisée Bing et affichez les résultats de recherche retournés.
```
r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
print(r.text)
```

Étapes suivantes

Créer une application web Recherche personnalisée