Merge pull request #115070 from dksimpson/DKS-US1712683-bing-news-search

Refresh Bing News Search REST API quickstarts

Author: denrea

articles/cognitive-services/Bing-News-Search/csharp.md

@@ -8,28 +8,30 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-news-search
 ms.topic: quickstart
-ms.date: 12/12/2019
+ms.date: 05/22/2020
 ms.author: aahi
 ms.custom: seodec2018
 ---
 
 # Quickstart: Search for news using C# and the Bing News Search REST API
 
-Use this quickstart to make your first call to the Bing News Search API and view the JSON response. This simple C# application sends a news search query to the API, and displays the response. The full code to this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingNewsSearchv7.cs).
+Use this quickstart to make your first call to the Bing News Search API. This simple C# application sends a news search query to the API, and displays the JSON response. 
 
-While this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
+
+The full code to this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingNewsSearchv7.cs).
 
 ## Prerequisites
 
 * Any edition of [Visual Studio 2017 or later](https://www.visualstudio.com/downloads/).
 * The [Json.NET](https://www.newtonsoft.com/json) framework, available as a NuGet package.
-* If you are using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
+* If you're using Linux/MacOS, you can run this application by using [Mono](https://www.mono-project.com/).
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create and initialize a project
 
-1. create a new C# console solution in Visual Studio. Then add the following namespaces into the main code file.
+1. Create a new C# console solution in Visual Studio. Then, add the following namespaces to the main code file:
 
     ```csharp
     using System;
@@ -39,30 +41,33 @@ While this application is written in C#, the API is a RESTful Web service compat
     using System.Collections.Generic;
     ```
 
-2. Create variables for the API endpoint, your subscription key, and search term. You can use the global endpoint below, or the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. Create variables for the API endpoint, your subscription key, and search term. You can use the global endpoint in the following code, or use the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
     ```csharp
     const string accessKey = "enter key here";
     const string uriBase = "https://api.cognitive.microsoft.com/bing/v7.0/news/search";
     const string searchTerm = "Microsoft";
     ```
-   ## Create a struct to format the Bing News Search response
+   
+## Create a struct to format the Bing News Search response
 
-1. Define a `SearchResult` struct to contain the image search results, and JSON header information.
+Define a `SearchResult` struct to contain the news search results and JSON header information.
 
-    ```csharp
-    struct SearchResult
-    {
-        public String jsonResult;
-        public Dictionary<String, String> relevantHeaders;
-    }
-    ```
+```csharp
+struct SearchResult
+{
+    public String jsonResult;
+    public Dictionary<String, String> relevantHeaders;
+}
+```
 
 ## Create and handle a news search request
 
-Create a method named `BingNewsSearch` to perform the call to the API, and set the return type to the `SearchResult` struct created earlier. In the method, perform the following steps:
+1. Create a method named `BingNewsSearch()` to call the API, and set the return type to the `SearchResult` struct created previously. 
+
+   Add code to this method in the steps that follow.
 
-1. Construct the URI for the search request. Note that the search term `toSearch` must be formatted before being appended to the string.
+1. Construct the URI for the search request. The `toSearch` search term must be formatted before it's appended to the string.
 
     ```csharp
     static SearchResult BingNewsSearch(string toSearch){
@@ -71,7 +76,7 @@ Create a method named `BingNewsSearch` to perform the call to the API, and set t
     //...
     ```
 
-2. Perform the web request and get the response as a JSON string.
+1. Perform the web request and get the response as a JSON string.
 
     ```csharp
     WebRequest request = WebRequest.Create(uriQuery);
@@ -80,7 +85,7 @@ Create a method named `BingNewsSearch` to perform the call to the API, and set t
     string json = new StreamReader(response.GetResponseStream()).ReadToEnd();
     ```
 
-3. Create the search result object, and extract the Bing HTTP headers. Then return `searchResult`.
+1. Create the search result object, and extract the Bing HTTP headers. Then, return `searchResult`.
 
     ```csharp
     // Create the result object for return
@@ -101,16 +106,16 @@ Create a method named `BingNewsSearch` to perform the call to the API, and set t
 
 ## Process the response
 
-1. In the main method, call `BingNewsSearch()` and store the returned response. Then deserialize the JSON into an object. You can then view the values of the response.
+In the main method, call `BingNewsSearch()` and store the returned response. Then, deserialize the JSON into an object where you can view the values of the response.
 
-    ```csharp
-    SearchResult result = BingNewsSearch(searchTerm);
-    //deserialize the JSON response
-    dynamic jsonObj = Newtonsoft.Json.JsonConvert.DeserializeObject(result.jsonResult);
-    Console.WriteLine(jsonObj["value"][0])
-    ```
+```csharp
+SearchResult result = BingNewsSearch(searchTerm);
+//deserialize the JSON response
+dynamic jsonObj = Newtonsoft.Json.JsonConvert.DeserializeObject(result.jsonResult);
+Console.WriteLine(jsonObj["value"][0])
+```
 
-## JSON Response
+## Example JSON response
 
 A successful response is returned in JSON, as shown in the following example:
 

articles/cognitive-services/Bing-News-Search/go.md

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-visual-search
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/22/2020
 ms.author: aahi
 ---
 
@@ -18,15 +18,14 @@ ms.author: aahi
 This quickstart uses the Go language to call the Bing News Search API. The results include names and URLs of news sources identified by the query string.
 
 ## Prerequisites
-* Install the [Go binaries](https://golang.org/dl/)
-* Install the go-spew library for it pretty printer to display results
-    * Install this library: `$ go get -u https://github.com/davecgh/go-spew`
+* Install the [Go binaries](https://golang.org/dl/).
+* Install the go-spew library to use a deep pretty printer to display the results. Use this command to install the library: `$ go get -u https://github.com/davecgh/go-spew`.
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create a project and import libraries
 
-Create a new Go project in your IDE or editor. Then import `net/http` for requests, `ioutil` to read the response, and `encoding/json` to handle the JSON text of results. The go-spew library is needed to parse JSON. 
+Create a new Go project in your IDE or editor. Then, import `net/http` for requests, `ioutil` to read the response, `encoding/json` to handle the JSON text of results, and the `go-spew` library to parse the JSON results. 
 
 ```go
 package main
@@ -41,9 +40,9 @@ import (
 
 ```
 
-## Create a struct to format the News search results
+## Create a struct to format the news search results
 
-The `NewsAnswer` struct formats the data provided in the response. The response JSON is multilevel and quite complex.  The following implementation covers the essentials.
+The `NewsAnswer` struct formats the data provided in the response JSON, which is multilevel and complex. The following implementation covers the essentials:
 
 ```go
 // This struct formats the answer provided by the Bing News Search API.
@@ -83,7 +82,7 @@ type NewsAnswer struct {
 
 ## Declare the main function and define variables  
 
-The following code declares the main function and assigns required variables. Confirm that the endpoint is correct and replace the `token` value with a valid subscription key from your Azure account. You can use the global endpoint below, or the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+The following code declares the main function and assigns the required variables. Confirm that the endpoint is correct, and then replace the `token` value with a valid subscription key from your Azure account. You can use the global endpoint in the following code, or use the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
 ```go
 func main() {
@@ -104,7 +103,7 @@ func main() {
 
 ## Query and header
 
-Add the query string and access key header
+Add the query string and access key header.
 
 ```go
 // Add the query to the request.  
@@ -117,9 +116,9 @@ req.Header.Add("Ocp-Apim-Subscription-Key", token)
 
 ```
 
-## Get request
+## GET request
 
-Create the client and send the Get request. 
+Create the client and send the GET request. 
 
 ```go
 // Instantiate a client.  
@@ -135,7 +134,7 @@ if err != nil {
 
 ## Send the request
 
-Send the request and read results using `ioutil`.
+Send the request and read the results by using `ioutil`.
 
 ```go
 resp, err := client.Do(req)
@@ -156,7 +155,7 @@ if err != nil {
 
 ## Handle the response
 
-The `Unmarshall` function extracts information from the JSON text returned by the News Search API.  Then you can display nodes from the results using the `go-spew` pretty printer.
+The `Unmarshall` function extracts information from the JSON text returned by the Bing News Search API. Then, display nodes from the results with the `go-spew` pretty printer.
 
 ```go
 // Create a new answer object 
@@ -177,7 +176,7 @@ spew.Dump(result.Name, result.URL)
 
 ## Results
 
-The results contain name and URL of each result.
+The following output contains the name and URL of each result:
 
 ```
 (string) (len=91) "Cognitive Services Market: Global Industry Analysis and Opportunity Assessment, 2019 - 2025"

articles/cognitive-services/Bing-News-Search/java.md

@@ -9,31 +9,30 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-news-search
 ms.topic: quickstart
-ms.date: 12/16/2019
+ms.date: 05/22/2020
 ms.author: aahi
 ms.custom: seodec2018
 ---
 
 # Quickstart: Perform a news search using Java and the Bing News Search REST API
 
-Use this quickstart to make your first call to the Bing News Search API and view the JSON response. This simple Java application sends a news search query to the API, and displays the response.
+Use this quickstart to make your first call to the Bing News Search API. This simple Java application sends a news search query to the API, and displays the JSON response.
 
-While this application is written in Java, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in Java, the API is a RESTful Web service compatible with most programming languages.
 
-The source code for this sample is available [on GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingNewsSearchv7.java) 
+The source code for this sample is available [on GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingNewsSearchv7.java). 
 
 ## Prerequisites
 
-* The [Java Development Kit(JDK) 7 or 8](https://aka.ms/azure-jdks)
-
-* The [Gson library](https://github.com/google/gson)
+* The [Java Development Kit (JDK) 7 or 8](https://aka.ms/azure-jdks).
+* The [Gson library](https://github.com/google/gson).
 
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../includes/cognitive-services-bing-news-search-signup-requirements.md)]
 
 ## Create and initialize a project
 
-1. Create a new Java project in your favorite IDE or editor, and import the following libraries.
+1. Create a new Java project in your favorite IDE or editor, and import the following libraries:
 
     ```java
     import java.net.*;
@@ -46,7 +45,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     import com.google.gson.JsonParser;
     ```
 
-2. Create a new class, with variables for the API endpoint, your subscription key, and search term. You can use the global endpoint below, or the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. Create a new class. Add variables for the API endpoint, your subscription key, and search term. You can use the global endpoint in the following code, or use the [custom subdomain](../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
     ```java
     public static SearchResults SearchNews (String searchQuery) throws Exception {
@@ -60,7 +59,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
 
 ## Construct the search request, and receive a JSON response
 
-1. Use the variables from the last step to format a search URL for the API request. Note that your search term must be URL-encoded before being appended to the request.
+1. Use the variables from the previous step to format a search URL for the API request. URL-encode your search term before you append it to the request.
 
     ```java
     public static SearchResults SearchNews (String searchQuery) throws Exception {
@@ -71,7 +70,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     }
     ```
 
-2. Receive the JSON response from the Bing News Search API, and construct the result object.
+2. Receive the JSON response from the Bing News Search API and construct the result object.
 
     ```java
     // receive JSON body
@@ -84,6 +83,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
 ## Process the JSON response
 
 1. Separate the Bing-related HTTP headers from the JSON body, then close the stream and return the API response.
+
     ```java
     // extract Bing-related HTTP headers
     Map<String, List<String>> headers = connection.getHeaderFields();
@@ -97,7 +97,8 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     return results;
     ```
 
-2. Create a method to parse and reserialize JSON
+2. Create a method to parse and reserialize the JSON results.
+
     ```java
     // pretty-printer for JSON; uses GSON parser to parse and re-serialize
     public static String prettify(String json_text) {
@@ -108,8 +109,9 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     }
     ```
 
-3. In the main method of your application, call the search method, and display the results.
-    ```csharp
+3. In the main method of your application, call the search method and display the results.
+
+    ```java
    public static void main (String[] args) {
        System.out.println("Searching the Web for: " + searchTerm);
        SearchResults result = SearchNews(searchTerm);
@@ -122,7 +124,7 @@ The source code for this sample is available [on GitHub](https://github.com/Azur
     }
     ```
 
-## JSON Response
+## Example JSON response
 
 A successful response is returned in JSON, as shown in the following example: