Schnellstart: Aufrufen Ihres Endpunkts für die benutzerdefinierte Bing-Suche mit Node.js

Artikel
05/08/2020

Warnung

Am 30. Oktober 2020 wurden die Bing-Suche-APIs aus den Azure KI Services in die Bing-Suchdienste verschoben. Diese Dokumentation wird nur zu Referenzzwecken 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 zu erfahren, wie Sie Suchergebnisse von Ihrer Instanz der benutzerdefinierten Bing-Suche anfordern. Diese Anwendung ist zwar in JavaScript geschrieben, aber die API für die benutzerdefinierte Bing-Suche ist ein RESTful-Webdienst, der mit den meisten Programmiersprachen kompatibel ist. Den Quellcode des Beispiels finden Sie auf GitHub.

Voraussetzungen

Eine Instanz der benutzerdefinierten Bing-Suche. Weitere Informationen finden Sie unter Schnellstart: Erstellen Ihrer ersten Instanz der benutzerdefinierten Bing-Suche.
Node.js-JavaScript-Runtime
JavaScript-Bibliothek für Anforderungen

Erstellen einer Azure-Ressource

Beginnen Sie mit der Verwendung der API für die benutzerdefinierte Bing-Suche, indem Sie eine der folgenden Azure-Ressourcen erstellen:

Ressource für die benutzerdefinierte Bing-Suche

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie den Tarif „Free“, um den Dienst zu testen, und führen Sie später für die Produktion ein Upgrade auf einen kostenpflichtigen Tarif durch.

Ressource für mehrere Dienste

Verfügbar über das Azure-Portal, bis Sie die Ressource löschen.
Verwenden Sie in allen Azure KI Services-Instanzen denselben Schlüssel und Endpunkt für Ihre Anwendungen.

Erstellen und Initialisieren der Anwendung

Erstellen Sie eine neue JavaScript-Datei in Ihrer bevorzugten IDE oder einem Editor, und fügen Sie eine require()-Anweisung für die Bibliothek mit den Anforderungen hinzu. Erstellen Sie Variablen für Ihren Abonnementschlüssel, die benutzerdefinierte Konfigurations-ID und den Suchbegriff.
```
var request = require("request");

var subscriptionKey = 'YOUR-SUBSCRIPTION-KEY';
var customConfigId = 'YOUR-CUSTOM-CONFIG-ID';
var searchTerm = 'microsoft';
```

Senden und Empfangen einer Suchanforderung

Erstellen Sie eine Variable zum Speichern der Informationen, die in Ihrer Anforderung gesendet werden. Erstellen Sie die Anforderungs-URL, indem Sie Ihren Suchbegriff an den Abfrageparameter q= und Ihre benutzerdefinierte Konfigurations-ID der Suchinstanz an den Parameter customconfig= anfügen. Trennen Sie die Parameter durch ein kaufmännisches Und-Zeichen (&) voneinander. Sie können den globalen Endpunkt im folgenden Code oder den Endpunkt der benutzerdefinierten Unterdomäne verwenden, der im Azure-Portal für Ihre Ressource angezeigt wird.
```
var info = {
    url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 
        'q=' + searchTerm + "&" +
        'customconfig=' + customConfigId,
    headers: {
        'Ocp-Apim-Subscription-Key' : subscriptionKey
    }
}
```

Verwenden Sie die JavaScript-Anforderungsbibliothek zum Senden einer Suchanforderung an Ihre Instanz der benutzerdefinierten Bing-Suche, und geben Sie Informationen zu den Ergebnissen aus, z. B. Name, URL und das Datum des letzten Crawl-Vorgangs der Webseite.

request(info, function(error, response, body){
        var searchResponse = JSON.parse(body);
        for(var i = 0; i < searchResponse.webPages.value.length; ++i){
            var webPage = searchResponse.webPages.value[i];
            console.log('name: ' + webPage.name);
            console.log('url: ' + webPage.url);
            console.log('displayUrl: ' + webPage.displayUrl);
            console.log('snippet: ' + webPage.snippet);
            console.log('dateLastCrawled: ' + webPage.dateLastCrawled);
            console.log();
        }

Nächste Schritte

Erstellen einer Web-App für die benutzerdefinierte Suche

Freigeben über