BingNews Interface

Package:

com.microsoft.azure.cognitiveservices.search.newssearch

Maven Artifact:

com.microsoft.azure.cognitiveservices:azure-cognitiveservices-newssearch:1.0.2

public interface BingNews

An instance of this class provides access to all the operations defined in BingNews.

Method Summary

Modifier and Type	Method and Description
abstract WithExecute	category() The News Category API lets lets you search on Bing and get back a list of top news articles by category.
abstract NewsModel	category(CategoryOptionalParameter categoryOptionalParameter) The News Category API lets lets you search on Bing and get back a list of top news articles by category.
abstract rx.Observable<NewsModel>	categoryAsync(CategoryOptionalParameter categoryOptionalParameter) The News Category API lets lets you search on Bing and get back a list of top news articles by category.
abstract WithQuery	search() The News Search API lets you send a search query to Bing and get back a list of news that are relevant to the search query.
abstract NewsModel	search(String query, SearchOptionalParameter searchOptionalParameter) The News Search API lets you send a search query to Bing and get back a list of news that are relevant to the search query.
abstract rx.Observable<NewsModel>	searchAsync(String query, SearchOptionalParameter searchOptionalParameter) The News Search API lets you send a search query to Bing and get back a list of news that are relevant to the search query.
abstract WithExecute	trending() The News Trending Topics API lets lets you search on Bing and get back a list of trending news topics that are currently trending on Bing.
abstract TrendingTopics	trending(TrendingOptionalParameter trendingOptionalParameter) The News Trending Topics API lets lets you search on Bing and get back a list of trending news topics that are currently trending on Bing.
abstract rx.Observable<TrendingTopics>	trendingAsync(TrendingOptionalParameter trendingOptionalParameter) The News Trending Topics API lets lets you search on Bing and get back a list of trending news topics that are currently trending on Bing.

Method Details

category

public abstract BingNews.BingNewsCategoryDefinitionStages.WithExecute category()

The News Category API lets lets you search on Bing and get back a list of top news articles by category. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Returns:

the first stage of the category call

category

public abstract NewsModel category(CategoryOptionalParameter categoryOptionalParameter)

The News Category API lets lets you search on Bing and get back a list of top news articles by category. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Parameters:

categoryOptionalParameter - the object representing the optional parameters to be set before calling this API

Returns:

the NewsModel object if successful.

categoryAsync

public abstract Observable categoryAsync(CategoryOptionalParameter categoryOptionalParameter)

The News Category API lets lets you search on Bing and get back a list of top news articles by category. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Parameters:

categoryOptionalParameter - the object representing the optional parameters to be set before calling this API

Returns:

the observable to the NewsModel object

search

public abstract BingNews.BingNewsSearchDefinitionStages.WithQuery search()

The News Search API lets you send a search query to Bing and get back a list of news that are relevant to the search query. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Returns:

the first stage of the search call

search

public abstract NewsModel search(String query, SearchOptionalParameter searchOptionalParameter)

The News Search API lets you send a search query to Bing and get back a list of news that are relevant to the search query. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Parameters:

query - The user's search query string. The query string cannot be empty. The query string may contain Bing Advanced Operators. For example, to limit news to a specific domain, use the site: operator. Use this parameter only with the News Search API. Do not specify this parameter when calling the Trending Topics API or News Category API.

searchOptionalParameter - the object representing the optional parameters to be set before calling this API

Returns:

the NewsModel object if successful.

searchAsync

public abstract Observable searchAsync(String query, SearchOptionalParameter searchOptionalParameter)

The News Search API lets you send a search query to Bing and get back a list of news that are relevant to the search query. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Parameters:

query - The user's search query string. The query string cannot be empty. The query string may contain Bing Advanced Operators. For example, to limit news to a specific domain, use the site: operator. Use this parameter only with the News Search API. Do not specify this parameter when calling the Trending Topics API or News Category API.

searchOptionalParameter - the object representing the optional parameters to be set before calling this API

Returns:

the observable to the NewsModel object

trending

public abstract BingNews.BingNewsTrendingDefinitionStages.WithExecute trending()

The News Trending Topics API lets lets you search on Bing and get back a list of trending news topics that are currently trending on Bing. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Returns:

the first stage of the trending call

trending

public abstract TrendingTopics trending(TrendingOptionalParameter trendingOptionalParameter)

The News Trending Topics API lets lets you search on Bing and get back a list of trending news topics that are currently trending on Bing. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Parameters:

trendingOptionalParameter - the object representing the optional parameters to be set before calling this API

Returns:

the TrendingTopics object if successful.

trendingAsync

public abstract Observable trendingAsync(TrendingOptionalParameter trendingOptionalParameter)

The News Trending Topics API lets lets you search on Bing and get back a list of trending news topics that are currently trending on Bing. This section provides technical details about the query parameters and headers that you use to request news and the JSON response objects that contain them. For examples that show how to make requests, see [Searching the web for news](https://docs.microsoft.com/en-us/azure/cognitive-services/bing-news-search/search-the-web).

Parameters:

trendingOptionalParameter - the object representing the optional parameters to be set before calling this API

Returns:

the observable to the TrendingTopics object