Краткое руководство. Вызов конечной точки службы "Пользовательский поиск Bing" с помощью Node.js

Статья
05/08/2020

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

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

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

Предварительные требования

Экземпляр службы "Пользовательский поиск Bing". Дополнительные сведения см. в кратком руководстве Создание первого экземпляра Пользовательского поиска Bing.
Среда выполнения JavaScript Node.js.
Библиотека запросов JavaScript.

Создание ресурса 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';
```

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

Создайте переменную для хранения сведений, отправляемых в запросе. Создайте 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
    }
}
```

Используйте библиотеку запросов 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();
        }

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

Создание веб-страницы пользовательского поиска