Refresh Bing Entity Search REST API quickstarts

Author: dksimpson

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

@@ -9,15 +9,15 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 12/11/2019
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Send a search request to the Bing Entity Search REST API using C#
 
 Use this quickstart to make your first call to the Bing Entity Search API and view the JSON response. This simple C# application sends a news search query to the API, and displays the response. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingEntitySearchv7.cs).
 
-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.
 
 
 ## Prerequisites
@@ -26,18 +26,18 @@ While this application is written in C#, the API is a RESTful Web service compat
 
 - The [Json.NET](https://www.newtonsoft.com/json) framework, available as a NuGet package. To install the NuGet package in Visual Studio:
 
-   1. Right click your project in **Solution Explorer**.
+   1. Right-click your project in **Solution Explorer**.
    2. Select **Manage NuGet Packages**.
-   3. Search for *Newtonsoft.Json* and install the package.
+   3. Search for and select *Newtonsoft.Json*, and then install the package.
 
-- If you're using Linux/MacOS, this application can be run by  using [Mono](https://www.mono-project.com/).
+- If you're using Linux/MacOS, this application can be run by using [Mono](https://www.mono-project.com/).
 
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-entity-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 into the main code file:
 
     ```csharp
     using Newtonsoft.Json;
@@ -46,7 +46,7 @@ While this application is written in C#, the API is a RESTful Web service compat
     using System.Text;
     ```
 
-2. Create a new class, and add variables for the API endpoint, your subscription key, and query you want to search. 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, and add variables for the API endpoint, your subscription key, and the query you want to search. 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
     namespace EntitySearchSample
@@ -71,8 +71,8 @@ While this application is written in C#, the API is a RESTful Web service compat
 
 1. Within the class, create a function called `Search()`. Create a new `HttpClient` object, and add your subscription key to the `Ocp-Apim-Subscription-Key` header.
 
-   1. Construct the URI for your request by combining the host and path. Then add your market, and URL-encode your query.
-   2. Await `client.GetAsync()` to get a HTTP response, and then store the json response by awaiting `ReadAsStringAsync()`.
+   1. Construct the URI for your request by combining the host and path. Then, add your market and URL-encode your query.
+   2. Await `client.GetAsync()` to get an HTTP response, and then store the JSON response by awaiting `ReadAsStringAsync()`.
    3. Format the JSON string with `JsonConvert.DeserializeObject()` and print it to the console.
 
       ```csharp

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

@@ -9,26 +9,26 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 12/11/2019
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 # Quickstart: Send a search request to the Bing Entity Search REST API using Java
 
 Use this quickstart to make your first call to the Bing Entity Search API and view the JSON response. This simple Java application sends a news search query to the API, and displays the 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.
 
 ## Prerequisites
 
-* The [Java Development Kit(JDK)](https://www.oracle.com/technetwork/java/javase/downloads/)
-* The [Gson library](https://github.com/google/gson)
+* The [Java Development Kit (JDK)](https://www.oracle.com/technetwork/java/javase/downloads/).
+* The [Gson library](https://github.com/google/gson).
 
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-entity-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.io.*;
@@ -45,7 +45,7 @@ While this application is written in Java, the API is a RESTful Web service comp
    import com.google.gson.JsonParser;
    ```
 
-2. In a new class, create variables for the API endpoint, your subscription key, and a search query. 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. In a new class, create variables for the API endpoint, your subscription key, and a search query. 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 EntitySearch {
@@ -63,7 +63,7 @@ While this application is written in Java, the API is a RESTful Web service comp
 
 ## Construct a search request string
 
-1. Create a function called `search()` that returns a JSON `String`. url-encode your search query, and add it to a parameters string with `&q=`. Add your market to the string with `?mkt=`.
+1. Create a function called `search()` that returns a JSON `String`. url-encode your search query, and add it to a parameters string with `&q=`. Add your market to the parameter string with `?mkt=`.
 
 2. Create a URL object with your host, path, and parameters strings.
 
@@ -99,7 +99,7 @@ While this application is written in Java, the API is a RESTful Web service comp
     //...
     ```
 
-3. Create a `String` object to store the response from the `BufferedReader`. Iterate through it, and append each line to the string. Then close the reader, and return the response. 
+3. Create a `String` object to store the response from the `BufferedReader`. Iterate through it, and append each line to the string. Then, close the reader and return the response. 
 
     ```java
     String line;
@@ -114,9 +114,9 @@ While this application is written in Java, the API is a RESTful Web service comp
 
 ## Format the JSON response
 
-1. Create a new function called `prettify` to format the JSON response. Create a new `JsonParser`, and call `parse()` on the json text, and store it as a JSON object. 
+1. Create a new function called `prettify` to format the JSON response. Create a new `JsonParser`, call `parse()` on the JSON text, and then store it as a JSON object. 
 
-2. Use the Gson library to create a new `GsonBuilder()`, and use `setPrettyPrinting().create()` to format the json. Then return it.    
+2. Use the Gson library to create a new `GsonBuilder()`, use `setPrettyPrinting().create()` to format the JSON, and then return it.    
 
    ```java
    //...

articles/cognitive-services/Bing-Entities-Search/quickstarts/nodejs.md

@@ -9,34 +9,34 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 12/11/2019
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Send a search request to the Bing Entity Search REST API using Node.js
 
 Use this quickstart to make your first call to the Bing Entity Search API and view the JSON response. This simple JavaScript application sends a news search query to the API, and displays the response. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/nodejs/Search/BingEntitySearchv7.js).
 
-While this application is written in JavaScript, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in JavaScript, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
 * The latest version of [Node.js](https://nodejs.org/en/download/).
 
-* The [JavaScript Request Library](https://github.com/request/request)
+* The [JavaScript Request Library](https://github.com/request/request).
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-entity-search-signup-requirements.md)]
 
 ## Create and initialize the application
 
-1. Create a new JavaScript file in your favorite IDE or editor, and set the strictness and https requirements.
+1. Create a new JavaScript file in your favorite IDE or editor, and set the strictness and HTTPS requirements.
 
     ```javaScript
     'use strict';
     let https = require ('https');
     ```
 
-2. Create variables for the API endpoint, your subscription key, and search query. 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 query. 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
     let subscriptionKey = 'ENTER YOUR KEY HERE';
@@ -63,14 +63,14 @@ While this application is written in JavaScript, the API is a RESTful Web servic
         };
         ```
 
-    2. Store the body of the response when the **data** flag is called
+    2. Store the body of the response when the `data` flag is called.
         ```javascript
         response.on('data', function (d) {
             body += d;
         });
         ```
 
-    3. When an **end** flag is signaled, parse the JSON, and print it.
+    3. When an `end` flag is signaled, parse the JSON, and print it.
 
         ```javascript
         response.on ('end', function () {
@@ -81,10 +81,10 @@ While this application is written in JavaScript, the API is a RESTful Web servic
 
 ## Send a request
 
-1. Create a function called `Search` to send a search request. In it, perform the following steps.
+1. Create a function called `Search` to send a search request. In it, perform the following steps:
 
-   1. Create a JSON object containing your request parameters: use `Get` for the method, and add your host and path information. Add your subscription key to the `Ocp-Apim-Subscription-Key` header. 
-   2. Use `https.request()` to send the request with the response handler created earlier, and your search parameters.
+   1. Create a JSON object containing your request parameters. Use `Get` for the method, and add your host and path information. Add your subscription key to the `Ocp-Apim-Subscription-Key` header. 
+   2. Use `https.request()` to send the request with the response handler created previously, and your search parameters.
 
       ```javascript
       let Search = function () {

articles/cognitive-services/Bing-Entities-Search/quickstarts/php.md

@@ -9,15 +9,15 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 12/11/2019
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Send a search request to the Bing Entity Search REST API using PHP
 
 Use this quickstart to make your first call to the Bing Entity Search API and view the JSON response. This simple PHP application sends a news search query to the API, and displays the response. 
 
-While this application is written in PHP, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in PHP, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
@@ -27,12 +27,12 @@ While this application is written in PHP, the API is a RESTful Web service compa
 
 ## Search entities
 
-To run this application, follow these steps.
+To run this application, follow these steps:
 
 1. Create a new PHP project in your favorite IDE.
 2. Add the code provided below.
 3. Replace the `key` value with an access key valid for your subscription.
-4. 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.
+4. 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.
 5. Run the program.
 
 ```php
@@ -79,7 +79,7 @@ echo json_encode (json_decode ($result), JSON_PRETTY_PRINT);
 ?>
 ```
 
-**Response**
+## Example JSON response
 
 A successful response is returned in JSON, as shown in the following example: 
 

articles/cognitive-services/Bing-Entities-Search/quickstarts/python.md

@@ -9,15 +9,15 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 12/11/2019
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart: Send a search request to the Bing Entity Search REST API using Python
 
 Use this quickstart to make your first call to the Bing Entity Search API and view the JSON response. This simple Python application sends a news search query to the API, and displays the response. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/python/Search/BingEntitySearchv7.py).
 
-While this application is written in Python, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in Python, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
@@ -27,7 +27,7 @@ While this application is written in Python, the API is a RESTful Web service co
 
 ## Create and initialize the application
 
-1. Create a new Python file in your favorite IDE or editor, and add the following imports. Create variables for your subscription key, endpoint, market, and a search query. 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 new Python file in your favorite IDE or editor, and add the following imports. Create variables for your subscription key, endpoint, market, and search query. 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
     import http.client, urllib.parse
@@ -40,18 +40,21 @@ While this application is written in Python, the API is a RESTful Web service co
     query = 'italian restaurants near me'
     ```
 
-2. Create a request url by appending your market variable to the `?mkt=` parameter. Url-encode your query and appending it to the `&q=` parameter. 
+2. Create a request url by appending your market variable to the `?mkt=` parameter. Url-encode your query and append it to the `&q=` parameter. 
 
     ```python
     params = '?mkt=' + mkt + '&q=' + urllib.parse.quote (query)
     ```
 
 ## Send a request and get a response
 
-1. Create a function called `get_suggestions()`. Then perform the following steps.
-   1. Add your subscription key to a dictionary with `Ocp-Apim-Subscription-Key` as a key.
-   2. Use `http.client.HTTPSConnection()` to create a HTTPS client object. Send a `GET` request using `request()` with your path and parameters, and header information.
-   3. Store the response with `getresponse()`, and return `response.read()`.
+1. Create a function called `get_suggestions()`. 
+
+2. In this function, add your subscription key to a dictionary with `Ocp-Apim-Subscription-Key` as a key.
+
+3. Use `http.client.HTTPSConnection()` to create an HTTPS client object. Send a `GET` request using `request()` with your path and parameters, and header information.
+
+4. Store the response with `getresponse()`, and return `response.read()`.
 
       ```python
       def get_suggestions ():
@@ -62,7 +65,7 @@ While this application is written in Python, the API is a RESTful Web service co
        return response.read()
       ```
 
-2. Call `get_suggestions()`, and print the json response.
+5. Call `get_suggestions()`, and print the JSON response.
 
     ```python
     result = get_suggestions ()

articles/cognitive-services/Bing-Entities-Search/quickstarts/ruby.md

@@ -9,15 +9,15 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 12/11/2019
+ms.date: 05/08/2020
 ms.author: aahi
 ---
 
 # Quickstart for Bing Entity Search API with Ruby
 
 Use this quickstart to make your first call to the Bing Entity Search API and view the JSON response. This simple Ruby application sends a news search query to the API, and displays the response. The source code for this application is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/ruby/Search/BingEntitySearchv7.rb).
 
-While this application is written in Ruby, the API is a RESTful Web service compatible with most programming languages.
+Although this application is written in Ruby, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
@@ -27,15 +27,15 @@ While this application is written in Ruby, the API is a RESTful Web service comp
 
 ## Create and initialize the application
 
-1. In your favorite IDE or code editor, create a news Ruby file and import the following packages.
+1. In your favorite IDE or code editor, create a news Ruby file and import the following packages:
 
     ```ruby
     require 'net/https'
     require 'cgi'
     require 'json'
     ```
 
-2. Create variables for your API endpoint, News search URL, your subscription key, and a search query. 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 your API endpoint, News search URL, your subscription key, and search query. 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.
 
     ```ruby
     host = 'https://api.cognitive.microsoft.com'
@@ -61,7 +61,7 @@ While this application is written in Ruby, the API is a RESTful Web service comp
     request['Ocp-Apim-Subscription-Key'] = subscriptionKey
     ```
 
-3. Send the request, and print the response
+3. Send the request, and print the response.
 
     ```ruby
     response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|