Merge pull request #114216 from dksimpson/DKS-US1712683-bing-custom-search

Refresh Bing Custom Search API quickstarts

Author: megvanhuygen

articles/cognitive-services/Bing-Custom-Search/call-endpoint-csharp.md

@@ -9,31 +9,37 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-custom-search
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Call your Bing Custom Search endpoint using C# 
 
-Use this quickstart to begin requesting search results from your Bing Custom Search instance. While this application is written in C#, the Bing Custom Search API is a RESTful web service compatible with most programming languages. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingCustomSearchv7.cs).
+Use this quickstart to learn how to request search results from your Bing Custom Search instance. Although this application is written in C#, the Bing Custom Search 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/dotnet/Search/BingCustomSearchv7.cs).
 
 ## Prerequisites
 
-- A Bing Custom Search instance. See [Quickstart: Create your first Bing Custom Search instance](quick-start.md) for more information.
-- Microsoft [.NET Core](https://www.microsoft.com/net/download/core)
-- Any edition of [Visual Studio 2019 or later](https://www.visualstudio.com/downloads/)
-- If you are using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
-- The [Bing Custom Search](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Search.CustomSearch/1.2.0) NuGet package. 
-    - From **Solution Explorer** in Visual Studio, right-click your project and select **Manage NuGet Packages** from the menu. Install the `Microsoft.Azure.CognitiveServices.Search.CustomSearch` package. Installing the NuGet Custom Search package also installs the following assemblies:
-        - Microsoft.Rest.ClientRuntime
-        - Microsoft.Rest.ClientRuntime.Azure
-        - Newtonsoft.Json
+- A Bing Custom Search instance. For more information, see [Quickstart: Create your first Bing Custom Search instance](quick-start.md).
+- [Microsoft .NET Core](https://www.microsoft.com/net/download/core).
+- Any edition of [Visual Studio 2019 or later](https://www.visualstudio.com/downloads/).
+- If you're using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
+- The [Bing Custom Search](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Search.CustomSearch/2.0.0) NuGet package. 
+
+   To install this package in Visual Studio: 
+     1. Right-click your project in **Solution Explorer**, and then select **Manage NuGet Packages**. 
+     2. Search for and select *Microsoft.Azure.CognitiveServices.Search.CustomSearch*, and then install the package.
+
+   When you install the Bing Custom Search NuGet package, Visual Studio also installs the following packages:
+     - **Microsoft.Rest.ClientRuntime**
+     - **Microsoft.Rest.ClientRuntime.Azure**
+     - **Newtonsoft.Json**
+
 
 [!INCLUDE [cognitive-services-bing-custom-search-prerequisites](../../../includes/cognitive-services-bing-custom-search-signup-requirements.md)]
 
 ## Create and initialize the application
 
-1. Create a new C# console application in Visual Studio. Then add the following packages to your project.
+1. Create a new C# console application in Visual Studio. Then, add the following packages to your project:
 
     ```csharp
     using System;
@@ -42,7 +48,7 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
     using Newtonsoft.Json;
     ```
 
-2. Create the following classes to store the search results returned by the Bing Custom Search API.
+2. Create the following classes to store the search results returned by the Bing Custom Search API:
 
     ```csharp
     public class BingCustomSearchResponse {        
@@ -66,15 +72,15 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
     }
     ```
 
-3. In the main method of your project, create variables for your Bing Custom Search API subscription key, your search instance's Custom Configuration ID, and a search term.
+3. In the main method of your project, create the following variables for your Bing Custom Search API subscription key, search instance's custom configuration ID, and search term:
 
     ```csharp
     var subscriptionKey = "YOUR-SUBSCRIPTION-KEY";
     var customConfigId = "YOUR-CUSTOM-CONFIG-ID";
     var searchTerm = args.Length > 0 ? args[0]:"microsoft";
     ```
 
-4. Construct the request URL by appending your search term to the `q=` query parameter, and your search instance's Custom Configuration ID to `customconfig=`. separate the parameters with a `&` character. `url` 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.
+4. Construct the request URL by appending your search term to the `q=` query parameter, and your search instance's custom configuration ID to the `customconfig=` parameter. Separate the parameters with an ampersand (`&`). For the `url` variable 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.
 
     ```csharp
     var url = "https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?" +
@@ -98,9 +104,9 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
     var responseContent = httpResponseMessage.Content.ReadAsStringAsync().Result;
     BingCustomSearchResponse response = JsonConvert.DeserializeObject<BingCustomSearchResponse>(responseContent);
     ```
-   ## Process and view the results
+## Process and view the results
 
-3. Iterate over the response object to display information about each search result, including its name, url, and the date the webpage was last crawled.
+- Iterate over the response object to display information about each search result, including its name, url, and the date the webpage was last crawled.
 
     ```csharp
     for(int i = 0; i < response.webPages.value.Length; i++) {                

articles/cognitive-services/Bing-Custom-Search/call-endpoint-java.md

@@ -9,27 +9,27 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-custom-search
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Call your Bing Custom Search endpoint using Java
 
-Use this quickstart to begin requesting search results from your Bing Custom Search instance. While this application is written in Java, the Bing Custom Search 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/BingCustomSearchv7.java).
+Use this quickstart to learn how to request search results from your Bing Custom Search instance. Although this application is written in Java, the Bing Custom Search 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/BingCustomSearchv7.java).
 
 ## Prerequisites
 
-- A Bing Custom Search instance. See [Quickstart: Create your first Bing Custom Search instance](quick-start.md) for more information.
+- A Bing Custom Search instance. For more information, see [Quickstart: Create your first Bing Custom Search instance](quick-start.md).
 
-- The latest [Java Development Kit](https://www.oracle.com/technetwork/java/javase/downloads/index.html)  
+- The latest [Java Development Kit](https://www.oracle.com/technetwork/java/javase/downloads/index.html).
 
-- The [Gson library](https://github.com/google/gson)
+- The [Gson library](https://github.com/google/gson).
 
 [!INCLUDE [cognitive-services-bing-custom-search-prerequisites](../../../includes/cognitive-services-bing-custom-search-signup-requirements.md)]
 
 ## Create and initialize the application
 
-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.io.InputStream;
@@ -46,7 +46,7 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
     import com.google.gson.JsonParser;
     ```
 
-2. Create a class named `CustomSrchJava`, and create variables for your subscription key, custom search endpoint, and your search instance's Custom Configuration ID. 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 class named `CustomSrchJava`, and then create variables for your subscription key, custom search endpoint, and search instance's custom configuration ID. 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 class CustomSrchJava {
         static String host = "https://api.cognitive.microsoft.com";
@@ -84,7 +84,7 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
 
 ## Send and receive a search request 
 
-1. Create a function named `SearchWeb()` that sends a request and returns a `SearchResults` object. Create the request url by combining your Custom Configuration ID, query, and  endpoint information. Add your Subscription key to the `Ocp-Apim-Subscription-Key` header.
+1. Create a function named `SearchWeb()` that sends a request and returns a `SearchResults` object. Create the request url by combining your custom configuration ID, query, and  endpoint information. Add your subscription key to the `Ocp-Apim-Subscription-Key` header.
 
     ```java
     public class CustomSrchJava {
@@ -116,7 +116,7 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
         }
     ```
 
-3. In the main method of your application, call `SearchWeb()` with your search term, 
+3. Print the JSON response.
 
     ```java
     System.out.println("\nJSON Response:\n");

articles/cognitive-services/Bing-Custom-Search/call-endpoint-nodejs.md

@@ -1,35 +1,35 @@
 ---
 title: "Quickstart: Call your Bing Custom Search endpoint using Node.js | Microsoft Docs"
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to begin requesting search results from your Bing Custom Search instance using Node.js
+description: Use this quickstart to begin requesting search results from your Bing Custom Search instance using Node.js.
 services: cognitive-services
 author: aahill
 manager: nitinme
 
 ms.service: cognitive-services
 ms.subservice: bing-custom-search
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Call your Bing Custom Search endpoint using Node.js
 
-Use this quickstart to begin requesting search results from your Bing Custom Search instance. While this application is written in JavaScript, the Bing Custom Search 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/nodejs/Search/BingCustomSearchv7.js).
+Use this quickstart to learn how to request search results from your Bing Custom Search instance. Although this application is written in JavaScript, the Bing Custom Search 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/nodejs/Search/BingCustomSearchv7.js).
 
 ## Prerequisites
 
-- A Bing Custom Search instance. See [Quickstart: Create your first Bing Custom Search instance](quick-start.md) for more information.
+- A Bing Custom Search instance. For more information, see [Quickstart: Create your first Bing Custom Search instance](quick-start.md).
 
-- [Node.js](https://www.nodejs.org/)
+- [The Node.js JavaScript runtime](https://www.nodejs.org/).
 
-- The [JavaScript Request Library](https://github.com/request/request)
+- The [JavaScript request library](https://github.com/request/request).
 
 [!INCLUDE [cognitive-services-bing-custom-search-prerequisites](../../../includes/cognitive-services-bing-custom-search-signup-requirements.md)]
 
 ## Create and initialize the application
 
-1. Create a new JavaScript file in your favorite IDE or editor, and add a `require()` statement for the requests library. Create variables for your subscription key, Custom Configuration ID, and a search term. 
+- Create a new JavaScript file in your favorite IDE or editor, and add a `require()` statement for the requests library. Create variables for your subscription key, custom configuration ID, and search term.
 
     ```javascript
     var request = require("request");
@@ -41,7 +41,7 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
 
 ## Send and receive a search request 
 
-1. Create a variable to store the information being sent in your request. Construct the request URL by appending your search term to the `q=` query parameter, and your search instance's Custom Configuration ID to `customconfig=`. separate the parameters with a `&` character. 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.
+1. Create a variable to store the information being sent in your request. Construct the request URL by appending your search term to the `q=` query parameter, and your search instance's custom configuration ID to the `customconfig=` parameter. Separate the parameters with an ampersand (`&`). 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.
 
     ```javascript
     var info = {
@@ -54,7 +54,7 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
     }
     ```
 
-1. Use the JavaScript Request Library to send a search request to your Bing Custom Search instance and print out information about the results, including its name, url, and the date the webpage was last crawled.
+1. Use the JavaScript request library to send a search request to your Bing Custom Search instance and print information about the results, including its name, url, and the date the webpage was last crawled.
 
     ```javascript
     request(info, function(error, response, body){

articles/cognitive-services/Bing-Custom-Search/call-endpoint-python.md

@@ -1,33 +1,33 @@
 ---
 title: "Quickstart: Call your Bing Custom Search endpoint using Python | Microsoft Docs"
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to begin requesting search results from your Bing Custom Search instance using Python
+description: Use this quickstart to begin requesting search results from your Bing Custom Search instance using Python.
 services: cognitive-services
 author: aahill
 manager: nitinme
 
 ms.service: cognitive-services
 ms.subservice: bing-custom-search
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Call your Bing Custom Search endpoint using Python
 
-Use this quickstart to begin requesting search results from your Bing Custom Search instance. While this application is written in Python, the Bing Custom Search 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/python/Search/BingCustomSearchv7.py).
+Use this quickstart to learn how to request search results from your Bing Custom Search instance. Although this application is written in Python, the Bing Custom Search 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/python/Search/BingCustomSearchv7.py).
 
 ## Prerequisites
 
-- A Bing Custom Search instance. See [Quickstart: Create your first Bing Custom Search instance](quick-start.md) for more information.
-- [Python](https://www.python.org/) 2.x or 3.x
+- A Bing Custom Search instance. For more information, see [Quickstart: Create your first Bing Custom Search instance](quick-start.md).
+- [Python](https://www.python.org/) 2.x or 3.x.
 
 [!INCLUDE [cognitive-services-bing-custom-search-prerequisites](../../../includes/cognitive-services-bing-custom-search-signup-requirements.md)]
 
 
 ## Create and initialize the application
 
-1. Create a new Python file in your favorite IDE or editor, and add the following import statements. Create variables for your subscription key, Custom Configuration ID, and a search term. 
+- Create a new Python file in your favorite IDE or editor, and add the following import statements. Create variables for your subscription key, custom configuration ID, and search term.
 
     ```python
     import json
@@ -40,13 +40,13 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
 
 ## Send and receive a search request 
 
-1. Construct the request URL by appending your search term to the `q=` query parameter, and your search instance's Custom Configuration ID to `customconfig=`. separate the parameters with a `&` character. 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.
+1. Construct the request URL by appending your search term to the `q=` query parameter, and your search instance's custom configuration ID to the `customconfig=` parameter. Separate the parameters with an ampersand (`&`). 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.
 
     ```python
     url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
     ```
 
-2. Send the request to your Bing Custom Search instance, and print out the returned search results.  
+2. Send the request to your Bing Custom Search instance, and print the returned search results.  
 
     ```python
     r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})