Schnelleinstieg: Eine Nachrichtensuche mit Python und der Bing News-Suche REST-API durchführen

Warnung

Am 30. Oktober 2020 wurden die Bing Search-APIs von Azure AI-Diensten zu Bing Search Services verschoben. Diese Dokumentation wird nur zur Referenz bereitgestellt. Eine aktualisierte Dokumentation finden Sie in der Dokumentation zu den Bing-Suche-APIs. Anweisungen zum Erstellen neuer Azure-Ressourcen für die Bing-Suche finden Sie unter Erstellen einer Ressource für die Bing-Suche über Azure Marketplace.

Verwenden Sie diese Schnellstartanleitung, um Ihren ersten Aufruf an die Bing News Search-API durchzuführen. Diese einfache Python-Anwendung sendet eine Suchabfrage an die API und verarbeitet das JSON-Ergebnis.

Obwohl diese Anwendung in Python geschrieben ist, ist die API ein RESTful-Webdienst, der mit den meisten Programmiersprachen kompatibel ist.

Um dieses Codebeispiel als Jupyter-Notizbuch auf MyBinderauszuführen, wählen Sie das Launch Binder Abzeichen aus:

Der Quellcode für dieses Beispiel ist auch auf GitHub-verfügbar.

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der Bing News Search-API, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für Bing-Suche v7

• Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
• Verwenden Sie das kostenlose Preisniveau, um den Dienst auszuprobieren und später auf eine kostenpflichtige Stufe für die Produktion zu aktualisieren.

Ressource für mehrere Dienste

• Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
• Verwenden Sie denselben Schlüssel und Endpunkt für Ihre Anwendungen in mehreren Azure AI-Diensten.

Erstellen und Initialisieren der Anwendung

Erstellen Sie eine neue Python-Datei in Ihrer bevorzugten IDE oder Ihrem Editor, und importieren Sie das Anforderungsmodul. Erstellen Sie Variablen für Ihren Abonnementschlüssel, Endpunkt und Suchbegriff. Sie können den globalen Endpunkt im folgenden Code verwenden oder den benutzerdefinierten Unterdomänen- Endpunkt verwenden, der im Azure-Portal für Ihre Ressource angezeigt wird.

import requests

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

Erstellen von Parametern für die Anforderung

Fügen Sie Ihren Abonnementschlüssel zu einem neuen Wörterbuch hinzu, indem Sie Ocp-Apim-Subscription-Key als Schlüssel verwenden. Führen Sie die gleichen Schritte für Ihre Suchparameter aus.

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

Senden einer Anforderung und Abrufen einer Antwort

1. Verwenden Sie die Anforderungsbibliothek, um die Bing Visual Search-API mit Ihrem Abonnementschlüssel aufzurufen, und die Wörterbuchobjekte, die Sie im vorherigen Schritt erstellt haben.

   response = requests.get(search_url, headers=headers, params=params)
   response.raise_for_status()
   search_results = json.dumps(response.json())
   

2. Greifen Sie auf die Beschreibungen der Artikel zu, die in der Antwort der API enthalten sind, die in search_results als JSON-Objekt gespeichert ist.

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

Anzeigen der Ergebnisse

Diese Beschreibungen können dann als Tabelle gerendert werden, wobei das Suchstichwort fett hervorgehoben ist.

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

Nächste Schritte

Erstellen einer einzelseitigen Web-App-