Краткое руководство: вызов конечной точки пользовательского поиска Bing с использованием Node.js

Предупреждение

30 октября 2020 г. API поиска Bing перемещены из служб ИИ Azure в службы поиска Bing. Эта документация предоставляется только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing приведены в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.

Используйте это краткое руководство, чтобы узнать, как запросить результаты поиска из вашего экземпляра пользовательского поиска Bing. Хотя это приложение написано на JavaScript, API пользовательского поиска Bing — это веб-служба RESTful, совместимая с большинством языков программирования. Исходный код для этого примера доступен на GitHub.

Предпосылки

Создание ресурса Azure

Начните использовать API пользовательского поиска Bing, создав один из следующих ресурсов Azure.

Ресурс пользовательского поиска Bing

  • Доступно на портале Azure до удаления ресурса.
  • Используйте бесплатный тарифный план, чтобы попробовать услугу, и перейдите на платный тариф для использования в работе.

многофункциональный ресурс

  • Доступно на портале Azure до удаления ресурса.
  • Используйте один и тот же ключ и конечную точку для приложений в нескольких службах ИИ Azure.

Создание и инициализация приложения

  • Создайте файл JavaScript в любимой интегрированной среде разработки или редакторе и добавьте инструкцию require() для библиотеки запросов. Создайте переменные для ключа подписки, пользовательского идентификатора конфигурации и поискового запроса.

    var request = require("request");
    
    var subscriptionKey = 'YOUR-SUBSCRIPTION-KEY';
    var customConfigId = 'YOUR-CUSTOM-CONFIG-ID';
    var searchTerm = 'microsoft';
    

Отправка и получение поискового запроса

  1. Создайте переменную для хранения информации, отправляемой в запросе. Создайте URL-адрес запроса, добавив поисковый термин к параметру запроса q= и идентификатор пользовательской конфигурации экземпляра поиска к параметру customconfig=. Разделите параметры амперсандом (&). Глобальную конечную точку можно использовать в следующем коде или использовать конечную точку пользовательского поддомена , отображаемую на портале Azure для ресурса.

    var info = {
        url: 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 
            'q=' + searchTerm + "&" +
            'customconfig=' + customConfigId,
        headers: {
            'Ocp-Apim-Subscription-Key' : subscriptionKey
        }
    }
    
  2. Используйте библиотеку запросов JavaScript, чтобы отправить поисковый запрос в экземпляр пользовательского поиска Bing и распечатать сведения о результатах, включая его имя, URL-адрес и дату последнего обхода веб-страницы.

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

Дальнейшие действия