Guida introduttiva: Chiamare l'endpoint di Ricerca personalizzata Bing usando Node.js

Articolo
05/08/2020

Avviso

Il 30 ottobre 2020 le API Ricerca Bing sono state spostate dai servizi di intelligenza artificiale di Azure ai servizi di Ricerca Bing. Questa documentazione viene fornita solo per riferimento. Per la documentazione aggiornata, vedere la documentazione dell'API ricerca Bing. Per istruzioni sulla creazione di nuove risorse di Azure per la ricerca Bing, vedere Creare una risorsa Ricerca Bing tramite il Azure Marketplace.

Seguire questo argomento di avvio rapido per informazioni su come richiedere risultati della ricerca all'istanza di Ricerca personalizzata Bing. Anche se l'applicazione è scritta in JavaScript, l'API Ricerca personalizzata Bing è un servizio Web RESTful compatibile con la maggior parte dei linguaggi di programmazione. Il codice sorgente di questo esempio è disponibile in GitHub.

Prerequisiti

Un'istanza di Ricerca personalizzata Bing. Per altre informazioni, vedere Avvio rapido: Creare la prima istanza di Ricerca personalizzata Bing.
Il runtime JavaScript di Node.js.
La libreria di richieste JavaScript.

Creare una risorsa di Azure

Per iniziare a usare l'API Ricerca personalizzata Bing, creare una delle risorse di Azure seguenti.

Risorsa Ricerca personalizzata Bing

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare il piano tariffario gratuito per provare il servizio ed eseguire in un secondo momento l'aggiornamento a un livello a pagamento per la produzione.

Risorsa multiservizio

disponibile tramite il portale di Azure fino a quando la risorsa non viene eliminata.
Usare la stessa chiave e lo stesso endpoint per le applicazioni in più servizi di intelligenza artificiale di Azure.

Creare e inizializzare l'applicazione

Creare un nuovo file JavaScript nell'IDE o nell'editor preferito e aggiungere un'istruzione require() per la libreria di richieste. Creare variabili per la chiave di sottoscrizione, l'ID configurazione personalizzato e un termine di ricerca.
```
var request = require("request");

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

Inviare e ricevere una richiesta di ricerca

Creare una variabile per archiviare le informazioni inviate nella richiesta. Creare l'URL della richiesta aggiungendo il termine di ricerca al parametro di query q= e l'ID configurazione personalizzato dell'istanza di ricerca al parametro customconfig=. Separare i parametri con una e commerciale (&). È possibile usare l'endpoint globale nel codice seguente o l'endpoint di sottodominio personalizzato visualizzato nel portale di Azure per la risorsa.
```
var info = {
    url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 
        'q=' + searchTerm + "&" +
        'customconfig=' + customConfigId,
    headers: {
        'Ocp-Apim-Subscription-Key' : subscriptionKey
    }
}
```

Usare la libreria di richieste JavaScript per inviare una richiesta di ricerca all'istanza di Ricerca personalizzata Bing e stampare le informazioni sui risultati, inclusi il nome, l'URL e la data dell'ultima ricerca per indicizzazione nella pagina Web.

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();
        }

Passaggi successivi

Compilare un'app Web di Ricerca personalizzata