Быстрый старт: Использование клиентской библиотеки для веб-поиска Bing

2020-10-19

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

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

Клиентская библиотека поиска в Интернете Bing упрощает интеграцию Bing Web Search в приложение C#. В этом кратком руководстве вы узнаете, как создать экземпляр клиента, отправить запрос и вывести ответ на экран.

Хотите увидеть код прямо сейчас? Примеры клиентских библиотек поиска Bing для .NET доступны на сайте GitHub.

Предпосылки

Перед началом работы с этим кратким руководством вам понадобятся несколько вещей.

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

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

Ресурс Bing Search версии 7

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

Ресурс с несколькими службами

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

Создание проекта и установка зависимостей

Подсказка

Получите последний код в виде решения Visual Studio из GitHub.

Первым шагом является создание нового консольного проекта. Если вам нужна помощь по настройке консольного проекта, см. статью Hello World — Ваша первая программа (руководство по программированию на C#). Чтобы использовать пакет SDK для поиска в Интернете Bing в приложении, необходимо установить Microsoft.Azure.CognitiveServices.Search.WebSearch с помощью диспетчера пакетов NuGet.

Пакет Web Search SDK также устанавливает:

Microsoft.Rest.ClientRuntime
Microsoft.Rest.ClientRuntime.Azure
Newtonsoft.Json

Объявление зависимостей

Откройте проект в Visual Studio или Visual Studio Code и импортируйте следующие зависимости:

using System;
using System.Collections.Generic;
using Microsoft.Azure.CognitiveServices.Search.WebSearch;
using Microsoft.Azure.CognitiveServices.Search.WebSearch.Models;
using System.Linq;
using System.Threading.Tasks;

Создание основы проекта

При создании нового консольного проекта необходимо создать пространство имен и класс для приложения. Программа должна выглядеть следующим образом:

namespace WebSearchSDK
{
    class YOUR_PROGRAM
    {

        // The code in the following sections goes here.

    }
}

В следующих разделах мы создадим пример приложения в этом классе.

Создание запроса

Этот код создает поисковый запрос.

public static async Task WebResults(WebSearchClient client)
{
    try
    {
        var webData = await client.Web.SearchAsync(query: "Yosemite National Park");
        Console.WriteLine("Searching for \"Yosemite National Park\"");

        // Code for handling responses is provided in the next section...

    }
    catch (Exception ex)
    {
        Console.WriteLine("Encountered exception. " + ex.Message);
    }
}

Обработка ответа

Затем добавим код, чтобы проанализировать ответ и распечатать результаты. Name и Url для первой веб-страницы, изображения, новостной статьи и видео печатаются, если они присутствуют в объекте ответа.

if (webData?.WebPages?.Value?.Count > 0)
{
    // find the first web page
    var firstWebPagesResult = webData.WebPages.Value.FirstOrDefault();

    if (firstWebPagesResult != null)
    {
        Console.WriteLine("Webpage Results # {0}", webData.WebPages.Value.Count);
        Console.WriteLine("First web page name: {0} ", firstWebPagesResult.Name);
        Console.WriteLine("First web page URL: {0} ", firstWebPagesResult.Url);
    }
    else
    {
        Console.WriteLine("Didn't find any web pages...");
    }
}
else
{
    Console.WriteLine("Didn't find any web pages...");
}

/*
 * Images
 * If the search response contains images, the first result's name
 * and url are printed.
 */
if (webData?.Images?.Value?.Count > 0)
{
    // find the first image result
    var firstImageResult = webData.Images.Value.FirstOrDefault();

    if (firstImageResult != null)
    {
        Console.WriteLine("Image Results # {0}", webData.Images.Value.Count);
        Console.WriteLine("First Image result name: {0} ", firstImageResult.Name);
        Console.WriteLine("First Image result URL: {0} ", firstImageResult.ContentUrl);
    }
    else
    {
        Console.WriteLine("Didn't find any images...");
    }
}
else
{
    Console.WriteLine("Didn't find any images...");
}

/*
 * News
 * If the search response contains news articles, the first result's name
 * and url are printed.
 */
if (webData?.News?.Value?.Count > 0)
{
    // find the first news result
    var firstNewsResult = webData.News.Value.FirstOrDefault();

    if (firstNewsResult != null)
    {
        Console.WriteLine("\r\nNews Results # {0}", webData.News.Value.Count);
        Console.WriteLine("First news result name: {0} ", firstNewsResult.Name);
        Console.WriteLine("First news result URL: {0} ", firstNewsResult.Url);
    }
    else
    {
        Console.WriteLine("Didn't find any news articles...");
    }
}
else
{
    Console.WriteLine("Didn't find any news articles...");
}

/*
 * Videos
 * If the search response contains videos, the first result's name
 * and url are printed.
 */
if (webData?.Videos?.Value?.Count > 0)
{
    // find the first video result
    var firstVideoResult = webData.Videos.Value.FirstOrDefault();

    if (firstVideoResult != null)
    {
        Console.WriteLine("\r\nVideo Results # {0}", webData.Videos.Value.Count);
        Console.WriteLine("First Video result name: {0} ", firstVideoResult.Name);
        Console.WriteLine("First Video result URL: {0} ", firstVideoResult.ContentUrl);
    }
    else
    {
        Console.WriteLine("Didn't find any videos...");
    }
}
else
{
    Console.WriteLine("Didn't find any videos...");
}

Объявление основного метода

В этом приложении основной метод включает код, который создает экземпляр клиента, проверяет subscriptionKeyи вызывает WebResults. Прежде чем продолжить, введите допустимый ключ подписки для учетной записи Azure.

static async Task Main(string[] args)
{
    var client = new WebSearchClient(new ApiKeyServiceClientCredentials("YOUR_SUBSCRIPTION_KEY"));

    await WebResults(client);

    Console.WriteLine("Press any key to exit...");
    Console.ReadKey();
}

Запуск приложения

Давайте запустите приложение!

dotnet run

Определение функций и результатов фильтрации

Теперь, когда вы выполнили первый вызов API Bing для поиска в Интернете, давайте рассмотрим несколько функций, которые выделяют функции пакета SDK для уточнения запросов и фильтрации результатов. Каждую функцию можно добавить в приложение C#, созданное в предыдущем разделе.

Ограничение количества результатов, возвращаемых Bing

В этом примере используются параметры count и offset, чтобы ограничить количество результатов, возвращаемых для "Лучшие рестораны в Сиэтле". Печатаются Name и Url для первого результата.

Добавьте этот код в проект консоли:

public static async Task WebResultsWithCountAndOffset(WebSearchClient client)
{
    try
    {
        var webData = await client.Web.SearchAsync(query: "Best restaurants in Seattle", offset: 10, count: 20);
        Console.WriteLine("\r\nSearching for \" Best restaurants in Seattle \"");

        if (webData?.WebPages?.Value?.Count > 0)
        {
            var firstWebPagesResult = webData.WebPages.Value.FirstOrDefault();

            if (firstWebPagesResult != null)
            {
                Console.WriteLine("Web Results #{0}", webData.WebPages.Value.Count);
                Console.WriteLine("First web page name: {0} ", firstWebPagesResult.Name);
                Console.WriteLine("First web page URL: {0} ", firstWebPagesResult.Url);
            }
            else
            {
                Console.WriteLine("Couldn't find first web result!");
            }
        }
        else
        {
            Console.WriteLine("Didn't see any Web data..");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Encountered exception. " + ex.Message);
    }
}

Добавьте WebResultsWithCountAndOffset в main:

static async Task Main(string[] args)
{
    var client = new WebSearchClient(new ApiKeyServiceClientCredentials("YOUR_SUBSCRIPTION_KEY"));

    await WebResults(client);
    // Search with count and offset...
    await WebResultsWithCountAndOffset(client);  

    Console.WriteLine("Press any key to exit...");
    Console.ReadKey();
}

Запустите приложение.

Фильтрация новостей

В этом примере используется параметр response_filter для фильтрации результатов поиска. Возвращаемые результаты поиска ограничены новостями для "Майкрософт". Печатаются Name и Url для первого результата.

Добавьте этот код в проект консоли:

public static async Task WebSearchWithResponseFilter(WebSearchClient client)
{
    try
    {
        IList<string> responseFilterstrings = new List<string>() { "news" };
        var webData = await client.Web.SearchAsync(query: "Microsoft", responseFilter: responseFilterstrings);
        Console.WriteLine("\r\nSearching for \" Microsoft \" with response filter \"news\"");

        if (webData?.News?.Value?.Count > 0)
        {
            var firstNewsResult = webData.News.Value.FirstOrDefault();

            if (firstNewsResult != null)
            {
                Console.WriteLine("News Results #{0}", webData.News.Value.Count);
                Console.WriteLine("First news result name: {0} ", firstNewsResult.Name);
                Console.WriteLine("First news result URL: {0} ", firstNewsResult.Url);
            }
            else
            {
                Console.WriteLine("Couldn't find first News results!");
            }
        }
        else
        {
            Console.WriteLine("Didn't see any News data..");
        }

    }
    catch (Exception ex)
    {
        Console.WriteLine("Encountered exception. " + ex.Message);
    }
}

Добавьте WebResultsWithCountAndOffset в main:

static Task Main(string[] args)
{
    var client = new WebSearchClient(new ApiKeyServiceClientCredentials("YOUR_SUBSCRIPTION_KEY"));

    await WebResults(client);
    // Search with count and offset...
    await WebResultsWithCountAndOffset(client);  
    // Search with news filter...
    await WebSearchWithResponseFilter(client);

    Console.WriteLine("Press any key to exit...");
    Console.ReadKey();
}

Запустите приложение.

Используйте безопасный поиск, подсчет ответов и фильтр продвижения

В этом примере используются параметры answer_count, promoteи safe_search для фильтрации результатов поиска "Музыкальные видео". Отображаются Name и ContentUrl для первого результата.

Добавьте этот код в проект консоли:

public static async Task WebSearchWithAnswerCountPromoteAndSafeSearch(WebSearchClient client)
{
    try
    {
        IList<string> promoteAnswertypeStrings = new List<string>() { "videos" };
        var webData = await client.Web.SearchAsync(query: "Music Videos", answerCount: 2, promote: promoteAnswertypeStrings, safeSearch: SafeSearch.Strict);
        Console.WriteLine("\r\nSearching for \"Music Videos\"");

        if (webData?.Videos?.Value?.Count > 0)
        {
            var firstVideosResult = webData.Videos.Value.FirstOrDefault();

            if (firstVideosResult != null)
            {
                Console.WriteLine("Video Results # {0}", webData.Videos.Value.Count);
                Console.WriteLine("First Video result name: {0} ", firstVideosResult.Name);
                Console.WriteLine("First Video result URL: {0} ", firstVideosResult.ContentUrl);
            }
            else
            {
                Console.WriteLine("Couldn't find videos results!");
            }
        }
        else
        {
            Console.WriteLine("Didn't see any data..");
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Encountered exception. " + ex.Message);
    }
}

Добавьте WebResultsWithCountAndOffset в main:

static async Task Main(string[] args)
{
    var client = new WebSearchClient(new ApiKeyServiceClientCredentials("YOUR_SUBSCRIPTION_KEY"));

    await WebResults(client);
    // Search with count and offset...
    await WebResultsWithCountAndOffset(client);  
    // Search with news filter...
    await WebSearchWithResponseFilter(client);
    // Search with answer count, promote, and safe search
    await WebSearchWithAnswerCountPromoteAndSafeSearch(client);

    Console.WriteLine("Press any key to exit...");
    Console.ReadKey();
}

Запустите приложение.

Очистка ресурсов

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

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

Примеры пакета SDK для служб ИИ Azure Node.js

Клиентская библиотека поиска в Интернете Bing упрощает интеграцию Bing Web Search в приложение Java. В этом кратком руководстве вы узнаете, как отправить запрос, получить ответ JSON и отфильтровать результаты и проанализировать результаты.

Хотите увидеть код прямо сейчас? Примеры клиентских библиотек поиска Bing для Java доступны на сайте GitHub.

Предпосылки

Перед началом работы с этим кратким руководством вам понадобятся несколько вещей.

JDK 7 или 8
Apache Maven или ваше любимое средство автоматизации сборки
Ключ подписки

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

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

Ресурс Bing Search версии 7

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

Ресурс с несколькими службами

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

Создание проекта и настройка POM-файла

Создайте проект Java с помощью Maven или выбранного средства автоматизации сборки. При условии, что вы используете Maven, добавьте следующие строки в файл project Object Model (POM). Замените все вхождения mainClass вашим приложением.

<build>
    <plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>exec-maven-plugin</artifactId>
        <version>1.4.0</version>
        <configuration>
          <!--Your comment
            Replace the mainClass with the path to your Java application.
            It should begin with com and doesn't require the .java extension.
            For example: com.bingwebsearch.app.BingWebSearchSample. This maps to
            The following directory structure:
            src/main/java/com/bingwebsearch/app/BingWebSearchSample.java.
          -->
          <mainClass>com.path.to.your.app.APP_NAME</mainClass>
        </configuration>
      </plugin>
      <plugin>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.0</version>
        <configuration>
          <source>1.7</source>
          <target>1.7</target>
        </configuration>
      </plugin>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>attached</goal>
            </goals>
            <configuration>
              <descriptorRefs>
                <descriptorRef>jar-with-dependencies</descriptorRef>
              </descriptorRefs>
              <archive>
                <manifest>
                  <!--Your comment
                    Replace the mainClass with the path to your Java application.
                    For example: com.bingwebsearch.app.BingWebSearchSample.java.
                    This maps to the following directory structure:
                    src/main/java/com/bingwebsearch/app/BingWebSearchSample.java.
                  -->
                  <mainClass>com.path.to.your.app.APP_NAME.java</mainClass>
                </manifest>
              </archive>
            </configuration>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
  <dependencies>
    <dependency>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure</artifactId>
      <version>1.9.0</version>
    </dependency>
    <dependency>
      <groupId>commons-net</groupId>
      <artifactId>commons-net</artifactId>
      <version>3.3</version>
    </dependency>
    <dependency>
      <groupId>com.microsoft.azure.cognitiveservices</groupId>
      <artifactId>azure-cognitiveservices-websearch</artifactId>
      <version>1.0.1</version>
    </dependency>
  </dependencies>

Объявление зависимостей

Откройте проект в любимой интегрированной среде разработки или редакторе и импортируйте следующие зависимости:

import com.microsoft.azure.cognitiveservices.search.websearch.BingWebSearchAPI;
import com.microsoft.azure.cognitiveservices.search.websearch.BingWebSearchManager;
import com.microsoft.azure.cognitiveservices.search.websearch.models.ImageObject;
import com.microsoft.azure.cognitiveservices.search.websearch.models.NewsArticle;
import com.microsoft.azure.cognitiveservices.search.websearch.models.SearchResponse;
import com.microsoft.azure.cognitiveservices.search.websearch.models.VideoObject;
import com.microsoft.azure.cognitiveservices.search.websearch.models.WebPage;

Если вы создали проект с помощью Maven, пакет уже должен быть объявлен. В противном случае декларируйте пакет. Рассмотрим пример.

package com.bingwebsearch.app

Объявление класса BingWebSearchSample

Объявите класс BingWebSearchSample. Он будет включать большую часть нашего кода, включая метод main.

public class BingWebSearchSample {

// The code in the following sections goes here.

}

Создание запроса

Метод runSample, который находится в классе BingWebSearchSample, создает запрос. Скопируйте этот код в приложение:

public static boolean runSample(BingWebSearchAPI client) {
    /*
     * This function performs the search.
     *
     * @param client instance of the Bing Web Search API client
     * @return true if sample runs successfully
     */
    try {
        /*
         * Performs a search based on the .withQuery and prints the name and
         * url for the first web pages, image, news, and video result
         * included in the response.
         */
        System.out.println("Searched Web for \"Xbox\"");
        // Construct the request.
        SearchResponse webData = client.bingWebs().search()
            .withQuery("Xbox")
            .withMarket("en-us")
            .withCount(10)
            .execute();

// Code continues in the next section...

Обработка ответа

Затем добавим код, чтобы проанализировать ответ и распечатать результаты. name и url для первой веб-страницы, изображения, статьи новостей и видео выводятся в печатном виде при их включении в объект ответа.

/*
* WebPages
* If the search response has web pages, the first result's name
* and url are printed.
*/
if (webData != null && webData.webPages() != null && webData.webPages().value() != null &&
        webData.webPages().value().size() > 0) {
    // find the first web page
    WebPage firstWebPagesResult = webData.webPages().value().get(0);

    if (firstWebPagesResult != null) {
        System.out.println(String.format("Webpage Results#%d", webData.webPages().value().size()));
        System.out.println(String.format("First web page name: %s ", firstWebPagesResult.name()));
        System.out.println(String.format("First web page URL: %s ", firstWebPagesResult.url()));
    } else {
        System.out.println("Couldn't find the first web result!");
    }
} else {
    System.out.println("Didn't find any web pages...");
}
/*
 * Images
 * If the search response has images, the first result's name
 * and url are printed.
 */
if (webData != null && webData.images() != null && webData.images().value() != null &&
        webData.images().value().size() > 0) {
    // find the first image result
    ImageObject firstImageResult = webData.images().value().get(0);

    if (firstImageResult != null) {
        System.out.println(String.format("Image Results#%d", webData.images().value().size()));
        System.out.println(String.format("First Image result name: %s ", firstImageResult.name()));
        System.out.println(String.format("First Image result URL: %s ", firstImageResult.contentUrl()));
    } else {
        System.out.println("Couldn't find the first image result!");
    }
} else {
    System.out.println("Didn't find any images...");
}
/*
 * News
 * If the search response has news articles, the first result's name
 * and url are printed.
 */
if (webData != null && webData.news() != null && webData.news().value() != null &&
        webData.news().value().size() > 0) {
    // find the first news result
    NewsArticle firstNewsResult = webData.news().value().get(0);
    if (firstNewsResult != null) {
        System.out.println(String.format("News Results#%d", webData.news().value().size()));
        System.out.println(String.format("First news result name: %s ", firstNewsResult.name()));
        System.out.println(String.format("First news result URL: %s ", firstNewsResult.url()));
    } else {
        System.out.println("Couldn't find the first news result!");
    }
} else {
    System.out.println("Didn't find any news articles...");
}

/*
 * Videos
 * If the search response has videos, the first result's name
 * and url are printed.
 */
if (webData != null && webData.videos() != null && webData.videos().value() != null &&
        webData.videos().value().size() > 0) {
    // find the first video result
    VideoObject firstVideoResult = webData.videos().value().get(0);

    if (firstVideoResult != null) {
        System.out.println(String.format("Video Results#%s", webData.videos().value().size()));
        System.out.println(String.format("First Video result name: %s ", firstVideoResult.name()));
        System.out.println(String.format("First Video result URL: %s ", firstVideoResult.contentUrl()));
    } else {
        System.out.println("Couldn't find the first video result!");
    }
} else {
    System.out.println("Didn't find any videos...");
}

Объявление основного метода

В этом приложении основной метод включает код, который создает экземпляр клиента, проверяет subscriptionKeyи вызывает runSample. Прежде чем продолжить, введите допустимый ключ подписки для учетной записи Azure.

public static void main(String[] args) {
    try {
        // Enter a valid subscription key for your account.
        final String subscriptionKey = "YOUR_SUBSCRIPTION_KEY";
        // Instantiate the client.
        BingWebSearchAPI client = BingWebSearchManager.authenticate(subscriptionKey);
        // Make a call to the Bing Web Search API.
        runSample(client);
    } catch (Exception e) {
        System.out.println(e.getMessage());
        e.printStackTrace();
    }
}

Запуск программы

Последний шаг — запустить программу!

mvn compile exec:java

Очистка ресурсов

После завершения работы с этим проектом обязательно удалите ключ подписки из кода программы.

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

Примеры пакета SDK java для служб искусственного интеллекта Azure

См. также

Справочник по пакету SDK для Java для Azure

Клиентская библиотека Bing для поиска в Интернете упрощает интеграцию Bing Web Search в приложение Node.js. В этом кратком руководстве вы узнаете, как создать экземпляр клиента, отправить запрос и вывести ответ на экран.

Хотите увидеть код прямо сейчас? Примеры клиентских библиотек поиска Bing для JavaScript доступны на сайте GitHub.

Предпосылки

Перед началом работы с этим кратким руководством вам понадобятся несколько вещей.

Node.js 6 или более поздней версии
Ключ подписки

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

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

Ресурс Bing Search версии 7

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

Ресурс с несколькими службами

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

Настройка среды разработки

Начнем с настройки среды разработки для нашего проекта Node.js.

Создайте новый каталог для проекта:
```
mkdir YOUR_PROJECT
```
Создайте файл пакета:
```
cd YOUR_PROJECT
npm init
```
Теперь давайте установим некоторые модули Azure и добавим их в package.json:
```
npm install --save @azure/cognitiveservices-websearch
npm install --save @azure/ms-rest-azure-js
```

Создание проекта и объявление обязательных модулей

В том же каталоге, что и package.json, создайте новый проект Node.js с помощью любимой интегрированной среды разработки или редактора. Например: sample.js.

Затем скопируйте этот код в проект. Он загружает модули, установленные в предыдущем разделе.

const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
const WebSearchAPIClient = require('@azure/cognitiveservices-websearch');

Инициализировать клиент

Этот код создает экземпляр клиента и использует модуль @azure/cognitiveservices-websearch. Прежде чем продолжить, введите допустимый ключ подписки для учетной записи Azure.

let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let webSearchApiClient = new WebSearchAPIClient(credentials);

Сделайте запрос и распечатайте результаты

Используйте клиент для отправки поискового запроса в веб-поиск Bing. Если ответ содержит результаты для любого из элементов в массиве properties, result.value выводится в консоль.

webSearchApiClient.web.search('seahawks').then((result) => {
    let properties = ["images", "webPages", "news", "videos"];
    for (let i = 0; i < properties.length; i++) {
        if (result[properties[i]]) {
            console.log(result[properties[i]].value);
        } else {
            console.log(`No ${properties[i]} data`);
        }
    }
}).catch((err) => {
    throw err;
})

Запуск программы

Последний шаг — запустить программу!

Очистка ресурсов

После завершения работы с этим проектом обязательно удалите ключ подписки из кода программы.

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

Примеры пакета SDK для служб ИИ Azure Node.js

См. также

справочник по пакету SDK для узлов Azure

Клиентская библиотека поиска в Интернете Bing упрощает интеграцию Bing Web Search с приложением Python. В этом кратком руководстве вы узнаете, как отправить запрос, получить ответ JSON и отфильтровать результаты и проанализировать результаты.

Хотите увидеть код прямо сейчас? Примеры клиентских библиотек поиска Bing для Python доступны на сайте GitHub.

Предпосылки

Пакет SDK для поиска в Интернете Bing совместим с Python 2.7 или 3.6+. Мы рекомендуем использовать виртуальную среду для этого краткого руководства.

Python 2.7 или 3.6+
virtualenv для Python 2.7
venv для Python 3.x

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

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

Ресурс Bing Search версии 7

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

Ресурс с несколькими службами

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

Создание и настройка виртуальной среды

Инструкции по настройке и настройке виртуальной среды отличаются для Python 2.x и Python 3.x. Выполните приведенные ниже действия, чтобы создать и инициализировать виртуальную среду.

Python 2.x

Создайте виртуальную среду с virtualenv для Python 2.7:

virtualenv mytestenv

Активируйте среду:

cd mytestenv
source bin/activate

Установите зависимости пакета SDK для поиска в Интернете Bing:

python -m pip install azure-cognitiveservices-search-websearch

Python 3.x

Создайте виртуальную среду с venv для Python 3.x:

python -m venv mytestenv

Активируйте среду:

mytestenv\Scripts\activate.bat

Установите зависимости пакета SDK для поиска в Интернете Bing:

cd mytestenv
python -m pip install azure-cognitiveservices-search-websearch

Создание клиента и печать первых результатов

Теперь, когда вы настроили виртуальную среду и установили зависимости, давайте создадим клиент. Клиент будет обрабатывать запросы и ответы из API Bing для поиска в Интернете.

Если ответ содержит веб-страницы, изображения, новости или видео, выводится первый результат для каждого из них.

Создайте проект Python с помощью любимой интегрированной среды разработки или редактора.

Скопируйте этот пример кода в проект. endpoint может быть глобальной конечной точкой, указанной ниже, или конечной точкой пользовательского поддомена , отображаемой на портале Azure для вашего ресурса.

# Import required modules.
from azure.cognitiveservices.search.websearch import WebSearchClient
from azure.cognitiveservices.search.websearch.models import SafeSearch
from msrest.authentication import CognitiveServicesCredentials

# Replace with your subscription key.
subscription_key = "YOUR_SUBSCRIPTION_KEY"

# Instantiate the client and replace with your endpoint.
client = WebSearchClient(endpoint="YOUR_ENDPOINT", credentials=CognitiveServicesCredentials(subscription_key))

# Make a request. Replace Yosemite if you'd like.
web_data = client.web.search(query="Yosemite")
print("\r\nSearched for Query# \" Yosemite \"")

'''
Web pages
If the search response contains web pages, the first result's name and url
are printed.
'''
if hasattr(web_data.web_pages, 'value'):

    print("\r\nWebpage Results#{}".format(len(web_data.web_pages.value)))

    first_web_page = web_data.web_pages.value[0]
    print("First web page name: {} ".format(first_web_page.name))
    print("First web page URL: {} ".format(first_web_page.url))

else:
    print("Didn't find any web pages...")

'''
Images
If the search response contains images, the first result's name and url
are printed.
'''
if hasattr(web_data.images, 'value'):

    print("\r\nImage Results#{}".format(len(web_data.images.value)))

    first_image = web_data.images.value[0]
    print("First Image name: {} ".format(first_image.name))
    print("First Image URL: {} ".format(first_image.url))

else:
    print("Didn't find any images...")

'''
News
If the search response contains news, the first result's name and url
are printed.
'''
if hasattr(web_data.news, 'value'):

    print("\r\nNews Results#{}".format(len(web_data.news.value)))

    first_news = web_data.news.value[0]
    print("First News name: {} ".format(first_news.name))
    print("First News URL: {} ".format(first_news.url))

else:
    print("Didn't find any news...")

'''
If the search response contains videos, the first result's name and url
are printed.
'''
if hasattr(web_data.videos, 'value'):

    print("\r\nVideos Results#{}".format(len(web_data.videos.value)))

    first_video = web_data.videos.value[0]
    print("First Videos name: {} ".format(first_video.name))
    print("First Videos URL: {} ".format(first_video.url))

else:
    print("Didn't find any videos...")

Замените SUBSCRIPTION_KEY допустимым ключом подписки.
Замените YOUR_ENDPOINT URL-адресом конечной точки на портале и удалите раздел bing/v7.0 из конечной точки.
Запустите программу. Например: python your_program.py.

Определение функций и результатов фильтрации

Теперь, когда вы выполнили первый вызов API Bing для поиска в Интернете, рассмотрим несколько функций. В следующих разделах выделены функции пакета SDK для уточнения запросов и фильтрации результатов. Каждую функцию можно добавить в программу Python, созданную в предыдущем разделе.

Ограничение количества результатов, возвращаемых Bing

В этом примере используются параметры count и offset для ограничения количества возвращаемых результатов с помощью метода SDKsearch. Печатаются name и url для первого результата.

Добавьте этот код в проект Python:

 # Declare the function.
 def web_results_with_count_and_offset(subscription_key):
     client = WebSearchAPI(CognitiveServicesCredentials(subscription_key))

     try:
         '''
         Set the query, offset, and count using the SDK's search method. See:
         https://learn.microsoft.com/python/api/azure-cognitiveservices-search-websearch/azure.cognitiveservices.search.websearch.operations.weboperations?view=azure-python.
         '''
         web_data = client.web.search(query="Best restaurants in Seattle", offset=10, count=20)
         print("\r\nSearching for \"Best restaurants in Seattle\"")

         if web_data.web_pages.value:
             '''
             If web pages are available, print the # of responses, and the first and second
             web pages returned.
             '''
             print("Webpage Results#{}".format(len(web_data.web_pages.value)))

             first_web_page = web_data.web_pages.value[0]
             print("First web page name: {} ".format(first_web_page.name))
             print("First web page URL: {} ".format(first_web_page.url))

         else:
             print("Didn't find any web pages...")

     except Exception as err:
         print("Encountered exception. {}".format(err))

Запустите программу.

Фильтрация новостей и свежести

В этом примере используются параметры response_filter и freshness для фильтрации результатов поиска с помощью метода search SDK. Возвращаемые результаты поиска ограничены новостями и страницами, обнаруженными Bing за последние 24 часа. Печатаются name и url для первого результата.

Добавьте этот код в проект Python:

# Declare the function.
def web_search_with_response_filter(subscription_key):
    client = WebSearchAPI(CognitiveServicesCredentials(subscription_key))
    try:
        '''
        Set the query, response_filter, and freshness using the SDK's search method. See:
        https://learn.microsoft.com/python/api/azure-cognitiveservices-search-websearch/azure.cognitiveservices.search.websearch.operations.weboperations?view=azure-python.
        '''
        web_data = client.web.search(query="xbox",
            response_filter=["News"],
            freshness="Day")
        print("\r\nSearching for \"xbox\" with the response filter set to \"News\" and freshness filter set to \"Day\".")

        '''
        If news articles are available, print the # of responses, and the first and second
        articles returned.
        '''
        if web_data.news.value:

            print("# of news results: {}".format(len(web_data.news.value)))

            first_web_page = web_data.news.value[0]
            print("First article name: {} ".format(first_web_page.name))
            print("First article URL: {} ".format(first_web_page.url))

            print("")

            second_web_page = web_data.news.value[1]
            print("\nSecond article name: {} ".format(second_web_page.name))
            print("Second article URL: {} ".format(second_web_page.url))

        else:
            print("Didn't find any news articles...")

    except Exception as err:
        print("Encountered exception. {}".format(err))

# Call the function.
web_search_with_response_filter(subscription_key)

Запустите программу.

Используйте безопасный поиск, подсчет ответов и фильтр продвижения

В этом примере используются параметры answer_count, promote и safe_search для фильтрации результатов поиска с помощью метода SDK search. Отображаются name и url для первого результата.

Добавьте этот код в проект Python:

# Declare the function.
def web_search_with_answer_count_promote_and_safe_search(subscription_key):

    client = WebSearchAPI(CognitiveServicesCredentials(subscription_key))

    try:
        '''
        Set the query, answer_count, promote, and safe_search parameters using the SDK's search method. See:
        https://learn.microsoft.com/python/api/azure-cognitiveservices-search-websearch/azure.cognitiveservices.search.websearch.operations.weboperations?view=azure-python.
        '''
        web_data = client.web.search(
            query="Niagara Falls",
            answer_count=2,
            promote=["videos"],
            safe_search=SafeSearch.strict  # or directly "Strict"
        )
        print("\r\nSearching for \"Niagara Falls\"")

        '''
        If results are available, print the # of responses, and the first result returned.
        '''
        if web_data.web_pages.value:

            print("Webpage Results#{}".format(len(web_data.web_pages.value)))

            first_web_page = web_data.web_pages.value[0]
            print("First web page name: {} ".format(first_web_page.name))
            print("First web page URL: {} ".format(first_web_page.url))

        else:
            print("Didn't see any Web data..")

    except Exception as err:
        print("Encountered exception. {}".format(err))

Запустите программу.

Очистка ресурсов

Когда вы закончите работу с этим проектом, удалите ключ подписки из кода программы и отключите виртуальную среду.

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

Примеры пакета SDK для Python служб искусственного интеллекта Azure

См. также

Руководство по Azure Python SDK

Поделиться через

Быстрый старт: Использование клиентской библиотеки для веб-поиска Bing

Предпосылки

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

Создание проекта и установка зависимостей

Объявление зависимостей

Создание основы проекта

Создание запроса

Обработка ответа

Объявление основного метода

Запуск приложения

Определение функций и результатов фильтрации

Ограничение количества результатов, возвращаемых Bing

Фильтрация новостей

Используйте безопасный поиск, подсчет ответов и фильтр продвижения

Очистка ресурсов

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

Предпосылки

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

Создание проекта и настройка POM-файла

Объявление зависимостей

Объявление класса BingWebSearchSample

Создание запроса

Обработка ответа

Объявление основного метода

Запуск программы

Очистка ресурсов

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

См. также

Предпосылки

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

Настройка среды разработки

Создание проекта и объявление обязательных модулей

Инициализировать клиент

Сделайте запрос и распечатайте результаты

Запуск программы

Очистка ресурсов

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

См. также

Предпосылки

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

Создание и настройка виртуальной среды

Python 2.x

Python 3.x

Создание клиента и печать первых результатов

Определение функций и результатов фильтрации

Ограничение количества результатов, возвращаемых Bing

Фильтрация новостей и свежести

Используйте безопасный поиск, подсчет ответов и фильтр продвижения

Очистка ресурсов

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

См. также

Дополнительные ресурсы