Merge pull request #115777 from dksimpson/DKS-US1712683-bing-web-search

Refresh Bing Web Search REST API quickstarts

Author: GitHubber17

articles/cognitive-services/Bing-Web-Search/quickstarts/csharp.md

@@ -8,15 +8,17 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 12/09/2019
+ms.date: 05/22/2020
 ms.author: aahi
 ms.custom: seodec2018
 #Customer intent: As a new developer, I want to make my first call to the Bing Web Search API and receive a response using C#.
 ---
 
 # Quickstart: Search the web using the Bing Web Search REST API and C#
 
-Use this quickstart to make your first call to the Bing Web Search API and receive the JSON response. This C# application sends a search request to the API, and shows the response. While this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
+Use this quickstart to make your first call to the Bing Web Search API. This C# application sends a search request to the API, and shows the JSON response. Although this application is written in C#, the API is a RESTful Web service compatible with most programming languages.
+
+This example program in this quickstart uses only .NET Core classes.
 
 ## Prerequisites
 
@@ -26,13 +28,11 @@ Here are a few things that you'll need before running this quickstart:
 * Linux/macOS: [Mono](https://www.mono-project.com/)  
 * A subscription key
 
-This example program only uses .NET Core classes.
-
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]
 
 ## Create a project and declare dependencies
 
-Create a new project in Visual Studio or Mono. Then use this code to import required namespaces and types.
+Create a new project in Visual Studio or Mono. Use the following code to import the required namespaces and types:
 
 ```csharp
 using System;
@@ -58,7 +58,13 @@ namespace BingSearchApisQuickstart
 
 ## Define variables
 
-A few variables must be set before we can continue.  `uriBase` can be the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Confirm that the `uriBase` is valid and replace the `accessKey` value with a valid subscription key from your Azure account. Feel free to customize the search query by replacing the value for `searchTerm`. Remember to add this code to the `Program` class as noted above.
+A few variables must be set before we can continue. Add this code to the `Program` class you created in the previous section: 
+
+1. For the `uriBase` value, 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. 
+
+2. Confirm that `uriBase` is valid and replace the `accessKey` value with a subscription key from your Azure account. 
+
+3. Optionally, customize the search query by replacing the value for `searchTerm`. 
 
 ```csharp
 // Enter a valid subscription key.
@@ -74,9 +80,9 @@ const string searchTerm = "Microsoft Cognitive Services";
 
 ## Declare the Main method
 
-The `Main()` method is required and it's the first method invoked when the program is started. In this application, the main method  validates the `accessKey`, makes a request, and prints the response.
+The `Main()` method is required and is the first method invoked when you start the program. In this application, the main method  validates the `accessKey`, makes a request, and prints the response.
 
-Keep in mind that `main()` is dependent on methods that are created in the next few sections.
+The `main()` method is dependent on methods that you create in the next sections.
 
 ```csharp
 static void Main()
@@ -105,7 +111,7 @@ static void Main()
 
 ## Create a struct for search results
 
-This struct returns search results with relevant headers. It's called when making a request to the Bing Web Search API to create a result object.
+Create a struct that returns search results with relevant headers. You call it when you make a request to the Bing Web Search API to create a result object.
 
 ```csharp
 // Returns search results with headers.
@@ -154,7 +160,7 @@ static SearchResult BingWebSearch(string searchQuery)
 
 ## Format the response
 
-This method formats the JSON response, primarily indenting and adding line breaks.
+This method formats the JSON response, primarily by indenting and adding line breaks.
 
 ```csharp
 /// <summary>
@@ -231,9 +237,9 @@ static string JsonPrettyPrint(string json)
 
 ## Put it all together
 
-The last step is to run your code! If you'd like to compare your code with ours, [sample code is available on GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingWebSearchv7.cs).
+The last step is to run your code. If you'd like to compare your code with ours, see the [sample code on GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingWebSearchv7.cs).
 
-## Sample response
+## Example JSON response
 
 Responses from the Bing Web Search API are returned as JSON. This sample response has been truncated to show a single result.  
 
@@ -362,6 +368,6 @@ Responses from the Bing Web Search API are returned as JSON. This sample respons
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

articles/cognitive-services/Bing-Web-Search/quickstarts/go.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 12/09/2019
+ms.date: 05/22/2020
 ms.author: aahi
 ms.reviewer: [email protected], v-gedod, erhopf
 ms.custom: seodec2018
@@ -17,21 +17,21 @@ ms.custom: seodec2018
 
 # Quickstart: Search the web using the Bing Web Search REST API and Go
 
-Use this quickstart to make your first call to the Bing Web Search API and receive the JSON response. This Go application sends a search request to the API, and shows the response. While this application is written in Go, the API is a RESTful Web service compatible with most programming languages.
+Use this quickstart to make your first call to the Bing Web Search API. This Go application sends a search request to the API, and shows the JSON response. Although this application is written in Go, the API is a RESTful Web service compatible with most programming languages.
+
+ The code examples in this quickstart require only core libraries; there are no external dependencies.  
 
 ## Prerequisites
 Here are a few things that you'll need before running this quickstart:
 
 * [Go binaries](https://golang.org/dl/)
 * A subscription key
 
-This quickstart only requires **core** libraries, there are no external dependencies.  
-
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]  
 
 ## Create a project and import core libraries
 
-Create a new Go project in your favorite IDE or editor. Then import `net/http` for requests, `ioutil` to read the response, `time` and `encoding/json` to handle the JSON, and `fmt` to print the output.
+Create a new Go project in your favorite IDE or editor. Then, import `net/http` for requests, `ioutil` to read the response, `time` and `encoding/json` to handle the JSON, and `fmt` to print the output.
 
 ```go
 package main
@@ -107,7 +107,13 @@ type BingAnswer struct {
 
 ## Declare the main function and define variables  
 
-This code declares the main function and sets required variables. `endpoint` can be the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Confirm that the endpoint is correct and replace the `token` value with a valid subscription key from your Azure account. Feel free to customize the search query by replacing the value for `searchTerm`.
+This code declares the main function and sets the required variables: 
+
+1. For the `endpoint` value, 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. 
+
+2. Confirm that the endpoint is correct and replace the `token` value with a valid subscription key from your Azure account. 
+ 
+3. Optionally, customize the search query by replacing the value for `searchTerm`.
 
 ```go
 // Declare the main function. This is required for all Go programs.
@@ -166,7 +172,7 @@ if err != nil {
 
 ## Handle the response
 
-Remember the struct we created earlier? We're going to use it to format the response and print the search results.
+Use the struct we created previously to format the response and print the search results.
 
 ```go
 // Create a new answer.  
@@ -183,7 +189,7 @@ for _, result := range ans.WebPages.Value {
 
 ## Put it all together
 
-The last step is to validate your code and run it! If you'd like to compare your code with ours, here's the complete program:
+The last step is to validate your code and run it. If you'd like to compare your code with ours, here's the complete program:
 
 ```go
 package main
@@ -301,9 +307,9 @@ func main() {
 }
 ```
 
-## Sample response  
+## Example JSON response
 
-Responses from the Bing Web Search API are returned as JSON. This sample response has been formatted using the `BingAnswer` struct and shows the `result.Name` and `result.URL`.
+Responses from the Bing Web Search API are returned as JSON. This sample response has been formatted by using the `BingAnswer` struct and shows the `result.Name` and `result.URL`.
 
 ```go
 Microsoft Cognitive Services || https://www.microsoft.com/cognitive-services
@@ -320,6 +326,6 @@ Cognitive Services - msdn.microsoft.com || https://msdn.microsoft.com/magazine/m
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]

articles/cognitive-services/Bing-Web-Search/quickstarts/java.md

@@ -8,15 +8,15 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 12/09/2019
+ms.date: 05/22/2020
 ms.author: aahi
 ms.custom: seodec2018, seo-java-july2019, seo-java-august2019, seo-java-september2019
 #Customer intent: As a new developer, I want to make my first call to the Bing Web Search API and receive a response using Java.
 ---
 
 # Quickstart: Use Java to search the web with the Bing Web Search REST API, an Azure cognitive service
 
-In this quickstart, you'll use a Java application to make your first call to the Bing Web Search API and receive the JSON response. This Java application sends a search request to the API, and shows the response. While this application is written in Java, the API is a RESTful Web service compatible with most programming languages.
+In this quickstart, you'll use a Java application to make your first call to the Bing Web Search API. This Java application sends a search request to the API, and shows the JSON response. Although this application is written in Java, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
@@ -45,7 +45,7 @@ import com.google.gson.JsonParser;
 
 ### Declare Gson in the Maven POM file
 
-If you're using Maven, declare Gson in the `POM.xml`. Skip this step if you've installed Gson locally.
+If you're using Maven, declare Gson in POM.xml. Skip this step if you've installed Gson locally.
 
 ```xml
 <dependency>
@@ -57,7 +57,7 @@ If you're using Maven, declare Gson in the `POM.xml`. Skip this step if you've i
 
 ## Declare the BingWebSearch class
 
-Declare the `BingWebSearch` class. It will include most of the code we review in this quickstart including the `main` method.  
+Declare the `BingWebSearch` class. It includes most of the code we review in this quickstart, including the `main()` method.  
 
 ```java
 public class BingWebSearch {
@@ -69,7 +69,13 @@ public class BingWebSearch {
 
 ## Define variables
 
-This code sets the `subscriptionKey`, `host`, `path`, and `searchTerm`. `host` can be the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource. Replace the `subscriptionKey` value with a valid subscription key from your Azure account. Feel free to customize the search query by replacing the value for `searchTerm`. Remember to add this code to the `BingWebSearch` class as noted above.
+The following code sets the `subscriptionKey`, `host`, `path`, and `searchTerm`. Add this code to the `BingWebSearch` class described in the previous section:
+
+1. For the `host` value, 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. 
+
+2. Replace the `subscriptionKey` value with a valid subscription key from your Azure account. 
+
+3. Optionally, customize the search query by replacing the value for `searchTerm`. 
 
 ```java
 // Enter a valid subscription key.
@@ -87,7 +93,7 @@ static String searchTerm = "Microsoft Cognitive Services";
 
 ## Construct a request
 
-This method, which lives in the `BingWebSearch` class, constructs the `url`, receives and parses the response, and extracts Bing-related HTTP headers.  
+The `SearchWeb()` method, which is included in the `BingWebSearch` class, constructs the `url`, receives and parses the response, and extracts Bing-related HTTP headers.  
 
 ```java
 public static SearchResults SearchWeb (String searchQuery) throws Exception {
@@ -133,7 +139,7 @@ public static String prettify(String json_text) {
 
 ## Declare the main method
 
-This method is required and is the first method invoked when the program is started. In this application, it includes code that validates the `subscriptionKey`, makes a request, and prints the JSON response.
+The `main()` method is required and is the first method invoked when you start the program. In this application, it includes code that validates the `subscriptionKey`, makes a request, and then prints the JSON response.
 
 ```java
 public static void main (String[] args) {
@@ -163,7 +169,7 @@ public static void main (String[] args) {
 
 ## Create a container class for search results
 
-The `SearchResults` container class is outside of the `BingWebSearch` class. It includes relevant headers and JSON data for the response.
+The `SearchResults` container class is defined outside of the `BingWebSearch` class. It includes relevant headers and JSON data for the response.
 
 ```java
 class SearchResults{
@@ -178,7 +184,7 @@ class SearchResults{
 
 ## Put it all together
 
-The last step is to compile your code and run it! Here are the commands:
+The last step is to compile your code and run it. Use the following commands:
 
 ```powershell
 javac BingWebSearch.java -classpath ./gson-2.8.5.jar -encoding UTF-8
@@ -187,7 +193,7 @@ java -cp ./gson-2.8.5.jar BingWebSearch
 
 If you'd like to compare your code with ours, [sample code is available on GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingWebSearchv7.java).
 
-## Sample response
+## Example JSON response
 
 Responses from the Bing Web Search API are returned as JSON. This sample response has been truncated to show a single result.
 
@@ -316,6 +322,6 @@ Responses from the Bing Web Search API are returned as JSON. This sample respons
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Bing Web search single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
+> [Bing Web Search API single-page app tutorial](../tutorial-bing-web-search-single-page-app.md)
 
 [!INCLUDE [bing-web-search-quickstart-see-also](../../../../includes/bing-web-search-quickstart-see-also.md)]