Quickstart: Uw Bing Custom Search-eindpunt aanroepen met behulp van Python

Artikel
05/08/2020

Waarschuwing

Op 30 oktober 2020 zijn de Bing Search-API's verplaatst van Azure AI-services naar Bing Search Services. Deze documentatie wordt alleen ter referentie verstrekt. Zie de bing zoek-API-documentatie voor bijgewerkte documentatie. Voor instructies voor het maken van nieuwe Azure-resources voor Bing, zie Een Bing Search-resource maken via de Azure Marketplace.

Gebruik deze snelle startgids om te leren hoe u zoekresultaten kunt aanvragen bij uw Bing Custom Search-instantie. Hoewel deze toepassing is geschreven in Python, is de Bing Custom Search-API een RESTful-webservice die compatibel is met de meeste programmeertalen. De broncode voor dit voorbeeld is beschikbaar op GitHub-.

Benodigdheden

Een Bing Custom Search-exemplaar. Zie Quickstart: Uw eerste Bing Custom Search-exemplaar makenvoor meer informatie.
Python 2.x of 3.x.

Een Azure-resource maken

Begin met het gebruik van de Bing Custom Search-API door een van de volgende Azure-resources te maken.

Bing Custom Search-resource

Beschikbaar via Azure Portal totdat u de resource verwijdert.
Gebruik de gratis prijscategorie om de service uit te proberen en voer later een upgrade uit naar een betaalde laag voor productie.

multi-service-resource

Beschikbaar via Azure Portal totdat u de resource verwijdert.
Gebruik dezelfde sleutel en hetzelfde eindpunt voor uw toepassingen, in meerdere Azure AI-services.

De toepassing maken en initialiseren

Maak een nieuw Python-bestand in uw favoriete IDE of editor en voeg de volgende importinstructies toe. Maak variabelen voor uw abonnementssleutel, aangepaste configuratie-id en zoekterm.
```
import json
import requests

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

Een zoekaanvraag verzenden en ontvangen

Maak de aanvraag-URL door je zoekterm toe te voegen aan de parameter q= van de query en de aangepaste configuratie-ID van je zoekinstantie aan de parameter customconfig=. Scheid de parameters met een en-teken (&). U kunt het globale eindpunt in de volgende code gebruiken of het aangepast subdomein gebruiken eindpunt dat wordt weergegeven in Azure Portal voor uw resource.
```
url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
```
Verzend de aanvraag naar uw Bing Custom Search-instantie en geef de geretourneerde zoekresultaten weer.
```
r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
print(r.text)
```

Volgende stappen

een web-app voor aangepaste zoekopdrachten maken

Delen via