Inicio rápido: Uso de la biblioteca cliente de Bing News Search

Artículo
2020-03-12

Advertencia

El 30 de octubre de 2020, las API de Bing Search se trasladaron de los servicios de Azure AI a Bing Search Services. Esta documentación solo se proporciona como referencia. Para obtener documentación actualizada, consulte la documentación de Bing Search API. Para obtener instrucciones sobre cómo crear nuevos recursos de Azure para la búsqueda de Bing, consulte Creación de un recurso de Bing Search a través de Azure Marketplace.

Use este inicio rápido para empezar a buscar noticias con la biblioteca cliente de Bing News Search para C#. Aunque Bing News Search tiene una API REST compatible con la mayoría de los lenguajes de programación, la biblioteca cliente proporciona una manera fácil de integrar el servicio en las aplicaciones. El código fuente de este ejemplo está disponible en GitHub.

Prerrequisitos

Cualquier edición de Visual Studio 2017 o posterior.
El framework Json.NET, disponible en formato de paquete NuGet.
Si usa Linux/MacOS, esta aplicación puede ejecutarse con Mono.
El paquete NuGet del SDK de Bing News Search . Al instalar este paquete también se instala lo siguiente:
- Microsoft.Rest.ClientRuntime
- Microsoft.Rest.ClientRuntime.Azure
- Newtonsoft.Json

Para configurar una aplicación de consola mediante la biblioteca cliente de Bing News Search, vaya a la Manage NuGet Packages opción desde el Explorador de soluciones en Visual Studio. Agregue el paquete Microsoft.Azure.CognitiveServices.Search.NewsSearch.

Creación de un recurso de Azure

Empiece a usar Bing News Search API mediante la creación de uno de los siguientes recursos de Azure:

Recurso de Bing Search v7

Disponible a través del portal de Azure hasta que elimine el recurso.
Use el plan de tarifa gratuito para probar el servicio y actualizarlo más adelante a un nivel de pago para producción.

Recurso de varios servicios

Disponible a través del portal de Azure hasta que elimine el recurso.
Utilice la misma clave y el mismo punto de conexión para sus aplicaciones en varios servicios de Azure AI.

Creación e inicialización de un proyecto

Cree una nueva solución de consola de C# en Visual Studio. A continuación, agregue lo siguiente al archivo de código principal.
```
using System;
using System.Linq;
using Microsoft.Azure.CognitiveServices.Search.NewsSearch;
```
Cree una variable para su clave de API, un término de búsqueda y, a continuación, instancie el cliente de búsqueda de noticias con dicha variable.
```
var key = "YOUR-ACCESS-KEY";
var searchTerm = "Quantum Computing";
var client = new NewsSearchClient(new ApiKeyServiceClientCredentials(key));
```

Enviar una solicitud y analizar el resultado

Use el cliente para enviar una solicitud de búsqueda al servicio Bing News Search:

var newsResults = client.News.SearchAsync(query: searchTerm, market: "en-us", count: 10).Result;

Si se devolvieron resultados, anótelos:

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

Pasos siguientes

Crear una aplicación web de página única

Use este inicio rápido para empezar a buscar noticias con la biblioteca cliente de Bing News Search para Java. Aunque Bing News Search tiene una API REST compatible con la mayoría de los lenguajes de programación, la biblioteca cliente proporciona una manera fácil de integrar el servicio en las aplicaciones. El código fuente de este ejemplo está disponible en GitHub.

Prerrequisitos

Instale las dependencias de la biblioteca cliente de Bing News Search mediante Maven, Gradle u otro sistema de administración de dependencias. El archivo POM de Maven requiere la siguiente declaración:

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

Creación de un recurso de Azure

Empiece a usar Bing News Search API mediante la creación de uno de los siguientes recursos de Azure:

Recurso de Bing Search v7

Disponible a través del portal de Azure hasta que elimine el recurso.
Use el plan de tarifa gratuito para probar el servicio y actualizarlo más adelante a un nivel de pago para producción.

Recurso de varios servicios

Disponible a través del portal de Azure hasta que elimine el recurso.
Utilice la misma clave y el mismo punto de conexión para sus aplicaciones en varios servicios de Azure AI.

Creación e inicialización de un proyecto

Cree un nuevo proyecto de Java en su IDE o editor favorito e importe las siguientes bibliotecas.

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;

Creación de un cliente de búsqueda y almacenamiento de credenciales

Cree un método llamado getClient() que devuelva un nuevo NewsSearchAPIImpl cliente de búsqueda. Agregue el punto de conexión como primer parámetro para el nuevoNewsSearchAPIImpl objeto y un nuevo ServiceClientCredentials objeto para almacenar las credenciales.
```
public static NewsSearchAPIImpl getClient(final String subscriptionKey) {
    return new NewsSearchAPIImpl("https://api.cognitive.microsoft.com/bing/v7.0/",
            new ServiceClientCredentials() {
            });
}
```

Para crear el ServiceClientCredentials objeto, invalide la applyCredentialsFilter() función . Pase un OkHttpClient.Builder al método y use el método del constructor addNetworkInterceptor() para crear sus credenciales para la llamada a la biblioteca de cliente.

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

Enviar y recibir una solicitud de búsqueda

Cree un método que llame getClient() a y envíe una solicitud de búsqueda al servicio Bing News Search. Filtre la búsqueda con los parámetros market y count y, a continuación, imprima información sobre el primer resultado de noticias: nombre, dirección URL, fecha de publicación, descripción, nombre del proveedor y número total de coincidencias estimadas para la búsqueda.

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!");
    }

}

Agregue su método de búsqueda al método main() para ejecutar el código.

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

Pasos siguientes

Crear una aplicación web de página única

Use este inicio rápido para empezar a buscar noticias con la biblioteca cliente de Bing News Search para JavaScript. Aunque Bing News Search tiene una API REST compatible con la mayoría de los lenguajes de programación, la biblioteca cliente proporciona una manera fácil de integrar el servicio en las aplicaciones. El código fuente de este ejemplo está disponible en GitHub.

Prerrequisitos

La versión más reciente de Node.js.
El SDK de Bing News Search para JavaScript
- Para instalarlo, ejecute npm install @azure/cognitiveservices-newssearch.
La clase CognitiveServicesCredentials del paquete @azure/ms-rest-azure-js para autenticar al cliente.
- Para instalarlo, ejecute npm install @azure/ms-rest-azure-js.

Creación de un recurso de Azure

Empiece a usar Bing News Search API mediante la creación de uno de los siguientes recursos de Azure:

Recurso de Bing Search v7

Disponible a través del portal de Azure hasta que elimine el recurso.
Use el plan de tarifa gratuito para probar el servicio y actualizarlo más adelante a un nivel de pago para producción.

Recurso de varios servicios

Disponible a través del portal de Azure hasta que elimine el recurso.
Utilice la misma clave y el mismo punto de conexión para sus aplicaciones en varios servicios de Azure AI.

Creación e inicialización de la aplicación

Cree una instancia de CognitiveServicesCredentials. Cree variables para la clave de suscripción y un término de búsqueda.

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

cree una instancia del cliente:

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

Envío de una consulta de búsqueda

Use el cliente para buscar con un término de consulta, en este caso "Juegos Olímpicos de invierno":

client.newsOperations.search(search_term).then((result) => {
    console.log(result.value);
}).catch((err) => {
    throw err;
});

El código imprime result.value elementos en la consola sin analizar ningún texto. Los resultados, si los hay por categoría, incluirán:

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

Pasos siguientes

Crear una aplicación web de página única

Use este inicio rápido para empezar a buscar noticias con la biblioteca cliente de Bing News Search para Python. Aunque Bing News Search tiene una API REST compatible con la mayoría de los lenguajes de programación, la biblioteca cliente proporciona una manera fácil de integrar el servicio en las aplicaciones. El código fuente de este ejemplo está disponible en GitHub.

Prerrequisitos

Pitón 2.x o 3.x

Se recomienda usar un entorno virtual para el desarrollo de Python. Puede instalar e inicializar el entorno virtual con el módulo venv. Debe instalar un virtualenv para Python 2.7. Puede crear un entorno virtual con:

python -m venv mytestenv

Puede instalar las dependencias de la biblioteca cliente de Bing News Search con este comando:

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

Creación de un recurso de Azure

Empiece a usar Bing News Search API mediante la creación de uno de los siguientes recursos de Azure:

Recurso de Bing Search v7

Disponible a través del portal de Azure hasta que elimine el recurso.
Use el plan de tarifa gratuito para probar el servicio y actualizarlo más adelante a un nivel de pago para producción.

Recurso de varios servicios

Disponible a través del portal de Azure hasta que elimine el recurso.
Utilice la misma clave y el mismo punto de conexión para sus aplicaciones en varios servicios de Azure AI.

Creación e inicialización de la aplicación

Cree un nuevo archivo de Python en su IDE o editor favorito e importe las siguientes bibliotecas. Cree una variable para la clave de suscripción y el término de búsqueda.

from azure.cognitiveservices.search.newssearch import NewsSearchClient
from msrest.authentication import CognitiveServicesCredentials
subscription_key = "YOUR-SUBSCRIPTION-KEY"
endpoint = "YOUR-ENDPOINT"
search_term = "Quantum Computing"

Inicialización del cliente y envío de una solicitud

Cree una instancia de CognitiveServicesCredentials.

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

Envíe una consulta de búsqueda a News Search API y almacene la respuesta.

news_result = client.news.search(query=search_term, market="en-us", count=10)

Análisis de la respuesta

Si se encuentran resultados de búsqueda, imprima el primer resultado de la página web:

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..")

Pasos siguientes

Crear una aplicación web de página única

Compartir a través de

Inicio rápido: Uso de la biblioteca cliente de Bing News Search

Prerrequisitos

Creación de un recurso de Azure

Creación e inicialización de un proyecto

Enviar una solicitud y analizar el resultado

Pasos siguientes

Prerrequisitos

Creación de un recurso de Azure

Creación e inicialización de un proyecto

Creación de un cliente de búsqueda y almacenamiento de credenciales

Enviar y recibir una solicitud de búsqueda

Pasos siguientes

Prerrequisitos

Creación de un recurso de Azure

Creación e inicialización de la aplicación

Envío de una consulta de búsqueda

Pasos siguientes

Prerrequisitos

Creación de un recurso de Azure

Creación e inicialización de la aplicación

Inicialización del cliente y envío de una solicitud

Análisis de la respuesta

Pasos siguientes

Recursos adicionales