Quickstart: Aanroepen van uw Bing Custom Search-eindpunt met Node.js
Waarschuwing
Op 30 oktober 2020 zijn de Zoeken in Bing API's verplaatst van Azure AI-services naar Zoeken in Bing Services. Deze documentatie is alleen bedoeld ter referentie. Zie de bing-documentatie voor zoeken-API voor bijgewerkte documentatie. Zie Een Zoeken in Bing-resource maken via de Azure Marketplace voor instructies over het maken van nieuwe Azure-resources voor Bing Search.
Lees in deze quickstart hoe u zoekresultaten opvraagt van de Bing Custom Search-instantie. Hoewel deze toepassing is geschreven in JavaScript, is de Bing Aangepaste zoekopdrachten-API een RESTful-webservice die compatibel is met vrijwel elke programmeertaal. De broncode voor dit voorbeeld is beschikbaar op GitHub.
Vereisten
Een Bing Custom Search-exemplaar. Zie voor meer informatie Snelstart: Uw eerste Bing Custom Search-instantie maken.
Een Azure-resource maken
Begin met het gebruik van de Bing Custom Search-API door een van de volgende Azure-resources te maken.
Resource voor Bing Custom Search
- Beschikbaar via de 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 categorie voor productie.
Resource voor meerdere services
- Beschikbaar via de 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 JavaScript-bestand in uw favoriete IDE of editor en voeg een instructie
require()
toe voor de aanvragenbibliotheek. Maak variabelen voor de abonnementssleutel, de aangepaste configuratie-id en een zoekterm.var request = require("request"); var subscriptionKey = 'YOUR-SUBSCRIPTION-KEY'; var customConfigId = 'YOUR-CUSTOM-CONFIG-ID'; var searchTerm = 'microsoft';
Een zoekaanvraag verzenden en ontvangen
Maak een variabele voor het opslaan van de gegevens die in uw aanvraag worden verzonden. Stel de aanvraag-URL samen door uw zoekterm toe te voegen aan de queryparameter
q=
, en de aangepaste configuratie-id van uw zoekinstantie aan de parametercustomconfig=
. Scheid de parameters van elkaar met een en-teken (&
). U kunt het globale eindpunt in de volgende code gebruiken of het eindpunt voor een aangepast subdomein gebruiken dat wordt weergegeven in de Azure-portal voor uw resource.var info = { url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + "&" + 'customconfig=' + customConfigId, headers: { 'Ocp-Apim-Subscription-Key' : subscriptionKey } }
Gebruik de JavaScript-aanvragenbibliotheek voor het verzenden van een zoekaanvraag naar uw Bing Custom Search-exemplaar en geef informatie weer over de resultaten, waaronder de naam, de URL en de datum waarop de webpagina voor het laatst is verkend.
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(); }