Быстрый старт: Вызов конечной точки пользовательского поиска Bing с помощью Python

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

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

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

Предпосылки

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

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

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

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

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

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

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

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

    import json
    import requests
    
    subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
    customConfigId = "YOUR-CUSTOM-CONFIG-ID"
    searchTerm = "microsoft"
    

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

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

    url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
    
  2. Отправьте запрос в экземпляр пользовательского поиска Bing и распечатайте возвращенные результаты поиска.

    r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
    print(r.text)
    

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