Início Rápido: Chamar o ponto final da Pesquisa Personalizada do Bing com Node.js

Artigo
05/08/2020

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

Utilize este início rápido para saber como pedir resultados de pesquisa à sua instância de Pesquisa Personalizada do Bing. Embora esta aplicação esteja escrita em JavaScript, a API de Pesquisa Personalizada do Bing é um serviço Web RESTful compatível com a maioria das linguagens de programação. O código fonte para este exemplo está disponível no GitHub.

Pré-requisitos

Uma instância de Pesquisa Personalizada do Bing. Para obter mais informações, veja Início Rápido: Criar a sua primeira instância de Pesquisa Personalizada do Bing.
O Node.js runtime javaScript.
A biblioteca de pedidos javaScript.

Criar um recurso do Azure

Comece a utilizar a API de Pesquisa Personalizada do Bing ao criar um dos seguintes recursos do Azure.

Recurso de Pesquisa Personalizada do Bing

Disponível através do portal do Azure até eliminar o recurso.
Utilize o escalão de preço gratuito para experimentar o serviço e atualize mais tarde para um escalão pago para produção.

Recurso multi-serviço

Disponível através do portal do Azure até eliminar o recurso.
Utilize a mesma chave e ponto final para as suas aplicações, em vários serviços de IA do Azure.

Criar e inicializar a aplicação

Crie um novo ficheiro JavaScript no seu IDE ou editor favorito e adicione uma require() instrução para a biblioteca de pedidos. Crie variáveis para a sua chave de subscrição, ID de configuração personalizada e termo de pesquisa.
```
var request = require("request");

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

Enviar e receber um pedido de pesquisa

Crie uma variável para armazenar as informações que estão a ser enviadas no seu pedido. Construa o URL do pedido ao acrescentar o termo de pesquisa ao parâmetro de consulta e o q= ID de configuração personalizado da instância de pesquisa para o customconfig= parâmetro . Separe os parâmetros com um e comercial (&). Pode utilizar o ponto final global no seguinte código ou utilizar o ponto final de subdomínio personalizado apresentado no portal do Azure do recurso.
```
var info = {
    url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 
        'q=' + searchTerm + "&" +
        'customconfig=' + customConfigId,
    headers: {
        'Ocp-Apim-Subscription-Key' : subscriptionKey
    }
}
```

Utilize a biblioteca de pedidos JavaScript para enviar um pedido de pesquisa para a sua instância de Pesquisa Personalizada do Bing e imprimir informações sobre os resultados, incluindo o respetivo nome, URL e a data em que a página Web foi pesquisada pela última vez.

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

Passos seguintes

Criar uma aplicação Web de Pesquisa Personalizada

Partilhar via