Краткое руководство. Использование клиентской библиотеки Поиска новостей Bing

Статья
03/12/2020

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

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

Используйте это краткое руководство, чтобы начать поиск новостей с помощью клиентской библиотеки Поиска новостей Bing для C#. Поскольку REST API Поиска новостей Bing совместим с большинством языков программирования, клиентская библиотека обеспечивает простой способ интеграции службы в ваши приложения. Исходный код для этого шаблона можно найти на портале GitHub.

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

Любой выпуск Visual Studio 2017 или более поздней версии.
Платформа Json.NET, доступная в виде пакета NuGet.
Если вы используете Linux или MacOS, это приложение можно запустить с помощью Mono.
Пакет SDK Поиска новостей Bing для NuGet. При установке этого пакета также устанавливаются следующие компоненты:
- Microsoft.Rest.ClientRuntime
- Microsoft.Rest.ClientRuntime.Azure
- Newtonsoft.Json.

Чтобы настроить консольное приложение с помощью клиентской библиотеки Поиска новостей Bing, в обозревателе решений Visual Studio перейдите к параметру Manage NuGet Packages. Добавьте пакет Microsoft.Azure.CognitiveServices.Search.NewsSearch.

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

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

Ресурс Поиска Bing версии 7

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

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

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

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

Создайте консольное решение C# в Visual Studio. Затем добавьте следующие элементы в основной файл кода.
```
using System;
using System.Linq;
using Microsoft.Azure.CognitiveServices.Search.NewsSearch;
```
Создайте переменную для ключа API, термин для поиска, а затем — экземпляр клиента поиска новостей.
```
var key = "YOUR-ACCESS-KEY";
var searchTerm = "Quantum Computing";
var client = new NewsSearchClient(new ApiKeyServiceClientCredentials(key));
```

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

Используйте клиент для отправки поискового запроса службе Поиска новостей Bing.
```
var newsResults = client.News.SearchAsync(query: searchTerm, market: "en-us", count: 10).Result;
```

Когда результаты будут возвращены, проанализируйте их.

if (newsResults.Value.Count > 0)
{
    var firstNewsResult = newsResults.Value[0];

    Console.WriteLine($"TotalEstimatedMatches value: {newsResults.TotalEstimatedMatches}");
    Console.WriteLine($"News result count: {newsResults.Value.Count}");
    Console.WriteLine($"First news name: {firstNewsResult.Name}");
    Console.WriteLine($"First news url: {firstNewsResult.Url}");
    Console.WriteLine($"First news description: {firstNewsResult.Description}");
    Console.WriteLine($"First news published time: {firstNewsResult.DatePublished}");
    Console.WriteLine($"First news provider: {firstNewsResult.Provider[0].Name}");
}

else
{
    Console.WriteLine("Couldn't find news results!");
}
Console.WriteLine("Enter any key to exit...");
Console.ReadKey();

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

Создание одностраничного веб-приложения

Используйте это краткое руководство, чтобы начать поиск новостей с помощью клиентской библиотеки Поиска новостей Bing для Java. Поскольку REST API Поиска новостей Bing совместим с большинством языков программирования, клиентская библиотека обеспечивает простой способ интеграции службы в ваши приложения. Исходный код для этого шаблона можно найти на портале GitHub.

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

Установите зависимости клиентской библиотеки Поиска новостей Bing с помощью Maven, Gradle или другой системы управления зависимостями. Для файла POM Maven требуется следующее объявление:

    <dependencies>
    <dependency>
        <groupId>com.microsoft.azure.cognitiveservices</groupId>
        <artifactId>azure-cognitiveservices-newssearch</artifactId>
        <version>0.0.1-beta-SNAPSHOT</version>
    </dependency>
    </dependencies>

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

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

Ресурс Поиска Bing версии 7

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

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

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

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

Создайте проект Java в любой интегрированной среде разработки или редакторе, а затем импортируйте в него следующие библиотеки.

import com.microsoft.azure.cognitiveservices.newssearch.*;
import com.microsoft.azure.cognitiveservices.newssearch.implementation.NewsInner;
import com.microsoft.azure.cognitiveservices.newssearch.implementation.NewsSearchAPIImpl;
import com.microsoft.azure.cognitiveservices.newssearch.implementation.TrendingTopicsInner;
import com.microsoft.rest.credentials.ServiceClientCredentials;
import okhttp3.Interceptor;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;

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

Создайте метод getClient(), возвращающий новый клиент для поиска NewsSearchAPIImpl. Добавьте конечную точку в качестве первого параметра для нового объекта NewsSearchAPIImpl и нового объекта ServiceClientCredentials для хранения учетных данных.
```
public static NewsSearchAPIImpl getClient(final String subscriptionKey) {
    return new NewsSearchAPIImpl("https://api.cognitive.microsoft.com/bing/v7.0/",
            new ServiceClientCredentials() {
            });
}
```

Чтобы создать объект ServiceClientCredentials, переопределите функцию applyCredentialsFilter(). Передайте OkHttpClient.Builder в метод и используйте метод addNetworkInterceptor() построителя, чтобы создать учетные данные для вызова клиентской библиотеки.

new ServiceClientCredentials() {
    @Override
    public void applyCredentialsFilter(OkHttpClient.Builder builder) {
        builder.addNetworkInterceptor(
                new Interceptor() {
                    @Override
                    public Response intercept(Chain chain) throws IOException {
                        Request request = null;
                        Request original = chain.request();
                        // Request customization: add request headers.
                        Request.Builder requestBuilder = original.newBuilder()
                                .addHeader("Ocp-Apim-Subscription-Key", subscriptionKey);
                        request = requestBuilder.build();
                        return chain.proceed(request);
                    }
                });
    }
});

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

Создайте метод, который вызывает getClient() и отправляет поисковый запрос службе "Поиск новостей Bing". Фильтруйте поиск за параметрами market и count, затем введите сведения о первом результате новостей: имя, URL-адрес, дата публикации, описание, имя поставщика и общее количество предполагаемых совпадений для вашего поиска.

public static void newsSearch(String subscriptionKey)
{
    NewsSearchAPIImpl client = getClient(subscriptionKey);
    String searchTerm = "Quantum Computing";

    NewsInner newsResults = client.searchs().list(searchTerm, null, null, null,
            null, null, 100, null, "en-us",
            null, null, null, null, null,
            null, null);

    if (newsResults.value().size() > 0)
    {
        NewsArticle firstNewsResult = newsResults.value().get(0);

        System.out.println(String.format("TotalEstimatedMatches value: %d", newsResults.totalEstimatedMatches()));
        System.out.println(String.format("News result count: %d", newsResults.value().size()));
        System.out.println(String.format("First news name: %s", firstNewsResult.name()));
        System.out.println(String.format("First news url: %s", firstNewsResult.url()));
        System.out.println(String.format("First news description: %s", firstNewsResult.description()));
        System.out.println(String.format("First news published time: %s", firstNewsResult.datePublished()));
        System.out.println(String.format("First news provider: %s", firstNewsResult.provider().get(0).name()));
    }
    else
    {
        System.out.println("Couldn't find news results!");
    }

}

Добавьте ваш метод поиска к методу main() для выполнения кода.

public static void main(String[] args) {
    String subscriptionKey = "YOUR-SUBSCRIPTION-KEY";
    NewsSearchSDK.newsSearch(subscriptionKey);
}

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

Создание одностраничного веб-приложения

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

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

Последняя версия Node.js.
Пакет SDK для Поиска новостей Bing для JavaScript.
- Чтобы установить его, выполните такую команду. npm install @azure/cognitiveservices-newssearch
Класс CognitiveServicesCredentials из пакета @azure/ms-rest-azure-js для аутентификации клиента.
- Чтобы установить его, выполните такую команду. npm install @azure/ms-rest-azure-js

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

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

Ресурс Поиска Bing версии 7

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

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

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

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

Создайте экземпляр CognitiveServicesCredentials. Создайте переменные для ключа подписки и условие поиска.

const CognitiveServicesCredentials = require('@azure/ms-rest-azure-js').CognitiveServicesCredentials;
let credentials = new CognitiveServicesCredentials('YOUR-ACCESS-KEY');
let search_term = 'Winter Olympics'

Создайте экземпляр клиента.

const NewsSearchAPIClient = require('@azure/cognitiveservices-newssearch');
let client = new NewsSearchAPIClient(credentials);

Отправка поискового запроса

Используйте клиент, чтобы выполнить поиск по условию, например "Winter Olympics" как в этом примере.
```
client.newsOperations.search(search_term).then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});
```

Код выводит элементы result.value в консоль без анализа какого-либо текста. Если будут получены результаты для какой-либо категории, они будут включать в себя следующее:

_type: 'NewsArticle'
_type: 'WebPage'
_type: 'VideoObject'
_type: 'ImageObject'

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

Создание одностраничного веб-приложения

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

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

Python 2.x или 3.x.

Мы рекомендуем для разработки на Python использовать виртуальное окружение. Установите и инициализируйте виртуальное окружение с помощью модуля venv. Необходимо установить virtualenv для Python 2.7. Создайте виртуальное окружение:

python -m venv mytestenv

Установите зависимости клиентской библиотеки для Поиска новостей Bing:

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

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

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

Ресурс Поиска Bing версии 7

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

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

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

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

Создайте проект Python в любой интегрированной среде разработки или редакторе, а затем импортируйте в него следующие библиотеки. Создайте переменные для ключа подписки и термина для поиска.
```
from azure.cognitiveservices.search.newssearch import NewsSearchClient
from msrest.authentication import CognitiveServicesCredentials
subscription_key = "YOUR-SUBSCRIPTION-KEY"
endpoint = "YOUR-ENDPOINT"
search_term = "Quantum Computing"
```

Инициализация клиента и отправка запроса

Создание экземпляра CognitiveServicesCredentials.

client = NewsSearchClient(endpoint=endpoint, credentials=CognitiveServicesCredentials(subscription_key))

Отправьте поисковой запрос к API поиска новостей и сохраните ответ.
```
news_result = client.news.search(query=search_term, market="en-us", count=10)
```

Синтаксический анализ ответа

Получив результаты поиска, выведите первый результат из списка веб-страниц:

if news_result.value:
    first_news_result = news_result.value[0]
    print("Total estimated matches value: {}".format(
        news_result.total_estimated_matches))
    print("News result count: {}".format(len(news_result.value)))
    print("First news name: {}".format(first_news_result.name))
    print("First news url: {}".format(first_news_result.url))
    print("First news description: {}".format(first_news_result.description))
    print("First published time: {}".format(first_news_result.date_published))
    print("First news provider: {}".format(first_news_result.provider[0].name))
else:
    print("Didn't see any news result data..")

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

Создание одностраничного веб-приложения

Краткое руководство. Использование клиентской библиотеки Поиска новостей Bing

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отправка поискового запроса

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

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

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

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

Инициализация клиента и отправка запроса

Синтаксический анализ ответа

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

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