Início Rápido: Chamar o ponto de extremidade da Pesquisa Personalizada do Bing usando o Node.js

Artigo
05/08/2020

Aviso

Em 30 de outubro de 2020, as APIs de Pesquisa do Bing foram migradas dos serviços de IA do Azure para os Serviços de Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter a documentação atualizada, consulte 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, consulte Criar um recurso de Pesquisa do Bing por meio do Azure Marketplace.

Use este início rápido para saber como solicitar os resultados da pesquisa na instância da Pesquisa Personalizada do Bing. Embora esse aplicativo seja escrito 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 deste exemplo está disponível no GitHub.

Pré-requisitos

Uma instância da Pesquisa Personalizada do Bing. Para saber mais, confira Início Rápido: Criar a primeira instância da Pesquisa Personalizada do Bing.
O runtime do JavaScript do Node.js.
A biblioteca de solicitações JavaScript.

Criar um recurso do Azure

Comece a usar a API de Pesquisa Personalizada do Bing criando um dos recursos do Azure a seguir.

Recurso de Pesquisa Personalizada do Bing

Disponível por meio do portal do Azure até que você exclua o recurso.
Use o tipo de preço gratuito para experimentar o serviço e atualize mais tarde para uma camada paga para produção.

Recurso de vários serviços

Disponível por meio do portal do Azure até que você exclua o recurso.
Use a mesma chave e ponto de extremidade para seus aplicativos nos vários serviços de IA do Azure.

Criar e inicializar o aplicativo

Crie um arquivo JavaScript em seu IDE ou editor favorito e adicione uma instrução require() à biblioteca de solicitações. Crie variáveis para sua chave de assinatura, uma ID de configuração personalizada e um termo de pesquisa.
```
var request = require("request");

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

Enviar e receber uma solicitação de pesquisa

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

Use a biblioteca de solicitações JavaScript para enviar uma solicitação de pesquisa à instância da Pesquisa Personalizada do Bing e imprimir informações sobre os resultados, incluindo o nome, a URL e a data em que a página da Web foi rastreada 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();
        }

Próximas etapas

Criar um aplicativo Web de Pesquisa Personalizada

Compartilhar via