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

Статья
05/08/2020

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

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

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

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

Экземпляр службы "Пользовательский поиск Bing". Дополнительные сведения см. в кратком руководстве Создание первого экземпляра Пользовательского поиска Bing.
Python версии 2.x или 3.x.

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

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

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

доступен на портале Azure до удаления.
Используйте бесплатную ценовую категорию, чтобы опробовать службу, а затем выполните обновление до платного уровня для рабочей среды.

Ресурс для нескольких служб.

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

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

Создайте файл Python в любой интегрированной среде разработки или редакторе и добавьте следующие инструкции импорта. Создайте переменные для ключа подписки, идентификатора пользовательской конфигурации и условия поиска.
```
import json
import requests

subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
customConfigId = "YOUR-CUSTOM-CONFIG-ID"
searchTerm = "microsoft"
```

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

Создайте URL-адрес запроса, добавив условие поиска к параметру запроса q= и идентификатор пользовательской конфигурации экземпляра поиска к параметру customconfig=. Разделите параметры символом &. Вы можете использовать глобальную конечную точку в следующем коде или конечную точку личного поддомена, отображаемую на портале Azure для вашего ресурса.
```
url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
```
Отправьте запрос к экземпляру Пользовательского поиска Bing и выведите на экран полученные результаты поиска.
```
r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
print(r.text)
```

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

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