Schnellstart: Aufrufen Ihres Bing Custom Search-Endpunkts mit Python

2020-05-08

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.

In dieser Schnellstartanleitung erfahren Sie, wie Sie Suchergebnisse aus Ihrer benutzerdefinierten Bing-Suchinstanz anfordern. Obwohl diese Anwendung in Python geschrieben ist, ist die Bing Custom Search API ein RESTful-Webdienst, der mit den meisten Programmiersprachen kompatibel ist. Der Quellcode für dieses Beispiel ist auf GitHub-verfügbar.

Voraussetzungen

Eine benutzerdefinierte Bing-Suchinstanz. Weitere Informationen finden Sie unter Schnellstart: Erstellen Ihrer ersten benutzerdefinierten Bing-Suchinstanz.
Python 2.x oder 3.x.

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der benutzerdefinierten Bing-Such-API, indem Sie eine der folgenden Azure-Ressourcen erstellen.

benutzerdefinierte Bing-Suchressource

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.

Mehrdienstressource

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 Bevorzugten Editor, und fügen Sie die folgenden Importanweisungen hinzu. Erstellen Sie Variablen für Den Abonnementschlüssel, die benutzerdefinierte Konfigurations-ID und den Suchbegriff.
```
import json
import requests

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

Senden und Empfangen einer Suchanfrage

Erstellen Sie die Anforderungs-URL, indem Sie Ihren Suchbegriff an den abfrageparameter q= und die benutzerdefinierte Konfigurations-ID Ihrer Suchinstanz an den customconfig= Parameter anfügen. Trennen Sie die Parameter mit einem Ampersand (&). 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.
```
url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
```
Senden Sie die Anforderung an Ihre Benutzerdefinierte Bing-Suchinstanz, und drucken Sie die zurückgegebenen Suchergebnisse.
```
r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
print(r.text)
```

Nächste Schritte

Erstellen einer benutzerdefinierten Suchweb-App

Freigeben über