Краткое руководство. Вызов конечной точки службы "Пользовательский поиск Bing" с помощью Python
Предупреждение
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)