快速入门：使用必应新闻搜索客户端库

在删除资源前，可通过 Azure 门户使用。
使用免费定价层试用该服务，稍后升级到用于生产的付费层。

在删除资源前，可通过 Azure 门户使用。
在多个 Azure AI 服务中对应用程序使用相同的密钥和终结点。

创建并初始化项目

在 Visual Studio 中创建一个新的 C# 控制台解决方案。然后将以下内容添加到主代码文件。
```
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));

发送请求并分析结果

使用客户端向必应新闻搜索服务发送搜索请求：

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();

后续步骤

通过本快速入门开始使用适用于 Java 的必应新闻搜索客户端库来搜索新闻。虽然必应新闻搜索具有与大多数编程语言兼容的 REST API，但该客户端库提供了一种简单方法来将服务集成到应用程序中。可以在 GitHub 上找到此示例的源代码。

先决条件

使用 Maven、Gradle 或其他依赖项管理系统安装必应新闻搜索客户端库依赖项。 Maven POM 文件需要以下声明：

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

创建 Azure 资源

通过创建以下 Azure 资源之一开始使用必应新闻搜索 API：

在删除资源前，可通过 Azure 门户使用。
使用免费定价层试用该服务，稍后升级到用于生产的付费层。

在删除资源前，可通过 Azure 门户使用。
在多个 Azure AI 服务中对应用程序使用相同的密钥和终结点。

创建并初始化项目

在你最喜欢的 IDE 或编辑器中新建一个 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 传递到该方法，并使用 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() 并向必应新闻搜索服务发送一个搜索请求。使用 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);
}

后续步骤

通过本快速入门开始使用适用于 JavaScript 的必应新闻搜索客户端库来搜索新闻。虽然必应新闻搜索具有与大多数编程语言兼容的 REST API，但该客户端库提供了一种简单方法来将服务集成到应用程序中。可以在 GitHub 上找到此示例的源代码。

先决条件

最新版本的 Node.js。
适用于 JavaScript 的必应资讯搜索 SDK
- 若要安装，请运行 npm install @azure/cognitiveservices-newssearch
@azure/ms-rest-azure-js 包中的 CognitiveServicesCredentials 类，用于对客户端进行身份验证。
- 若要安装，请运行 npm install @azure/ms-rest-azure-js

创建 Azure 资源

通过创建以下 Azure 资源之一开始使用必应新闻搜索 API：

在删除资源前，可通过 Azure 门户使用。
使用免费定价层试用该服务，稍后升级到用于生产的付费层。

在删除资源前，可通过 Azure 门户使用。
在多个 Azure AI 服务中对应用程序使用相同的密钥和终结点。

创建并初始化应用程序

创建 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'

后续步骤

通过本快速入门开始使用适用于 Python 的必应新闻搜索客户端库来搜索新闻。虽然必应新闻搜索具有与大多数编程语言兼容的 REST API，但该客户端库提供了一种简单方法来将服务集成到应用程序中。可以在 GitHub 上找到此示例的源代码。

先决条件

Python 2.x 或 3.x

建议使用虚拟环境进行 python 开发。可以使用 venv 模块安装并初始化虚拟环境。必须安装适用于 Python 2.7 的 virtualenv。可以使用以下命令创建虚拟环境：

python -m venv mytestenv

可以使用以下命令安装必应新闻搜索客户端库依赖项：

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

创建 Azure 资源

通过创建以下 Azure 资源之一开始使用必应新闻搜索 API：

在删除资源前，可通过 Azure 门户使用。
使用免费定价层试用该服务，稍后升级到用于生产的付费层。

在删除资源前，可通过 Azure 门户使用。
在多个 Azure AI 服务中对应用程序使用相同的密钥和终结点。

创建并初始化应用程序

在你最喜欢使用的 IDE 或编辑器中新建一个 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..")

后续步骤