Partager via


Démarrage rapide : Effectuer une recherche d’actualités à l’aide de Python et l’API REST Recherche d’actualités Bing

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 effectuer votre premier appel à l’API Recherche d’actualités Bing. Cette application Python simple envoie une requête de recherche à l’API et traite le résultat JSON.

Bien que cette application soit écrite en Python, l’API est un service web RESTful compatible avec la plupart des langages de programmation.

Pour exécuter cet exemple de code en tant que notebook Jupyter sur MyBinder, sélectionnez le badge de lancement de Binder :

Lancer Binder

Le code source de cet exemple est également disponible sur GitHub.

Créer une ressource Azure

Commencez à utiliser l’API Recherche d’actualités Bing en créant une des ressources Azure suivantes :

Ressource Recherche Bing v7

  • 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 importez le module de requête. Créez des variables pour votre clé d’abonnement, le point de terminaison et le terme de recherche. 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.

import requests

subscription_key = "your subscription key"
search_term = "Microsoft"
search_url = "https://api.cognitive.microsoft.com/bing/v7.0/news/search"

Créer les paramètres de la requête

Ajoutez votre clé d’abonnement à un nouveau dictionnaire en utilisant Ocp-Apim-Subscription-Key comme clé. Faites de même pour vos paramètres de recherche.

headers = {"Ocp-Apim-Subscription-Key" : subscription_key}
params  = {"q": search_term, "textDecorations": True, "textFormat": "HTML"}

Envoyer une requête et obtenir une réponse

  1. Utilisez la bibliothèque de requêtes pour appeler l’API Recherche visuelle Bing avec votre clé d’abonnement et les objets de dictionnaire que vous avez créés à l’étape précédente.

    response = requests.get(search_url, headers=headers, params=params)
    response.raise_for_status()
    search_results = json.dumps(response.json())
    
  2. Accédez aux descriptions des articles contenus dans la réponse de l’API, qui est stockée dans search_results sous la forme d’un objet JSON.

    descriptions = [article["description"] for article in search_results["value"]]
    

Afficher les résultats

Ces descriptions peuvent ensuite être restituées sous la forme d’un tableau, avec le mot clé de recherche surligné en gras.

from IPython.display import HTML
rows = "\n".join(["<tr><td>{0}</td></tr>".format(desc)
                  for desc in descriptions])
HTML("<table>"+rows+"</table>")

Étapes suivantes