Merge pull request #98684 from aahill/bing-entity-update

ktoliver · web-flow · commit 4222a844998f · 2019-12-11T15:51:58.000-07:00
[CogSvcs] Autosuggest &amp; Entity Search setup update
diff --git a/articles/cognitive-services/Bing-Autosuggest/quickstarts/csharp.md b/articles/cognitive-services/Bing-Autosuggest/quickstarts/csharp.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 07/26/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 # Quickstart: Suggest search queries with the Bing Autosuggest REST API and C#
@@ -35,7 +35,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     using System.Text;
     ```
 
-2. In a new class, create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a partial search query.
+2. In a new class, create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a partial 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.
 
     ```csharp
     static string host = "https://api.cognitive.microsoft.com";
@@ -60,7 +60,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     }
     ```
 
-2. In the same function above, create a request URI by combining your API host and path. Append your market to the `?mkt=` parameter, and your query to the `&query=` paramter. Be sure to URL-encode your query. 
+2. In the same function above, create a request URI by combining your API host and path. Append your market to the `?mkt=` parameter, and your query to the `&query=` parameter. Be sure to URL-encode your query. 
 
     ```csharp
     string uri = host + path + "?mkt=" + market + "&query=" + System.Net.WebUtility.UrlEncode (query);
diff --git a/articles/cognitive-services/Bing-Autosuggest/quickstarts/java.md b/articles/cognitive-services/Bing-Autosuggest/quickstarts/java.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 07/26/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -40,7 +40,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     import com.google.gson.JsonParser;
     ```
 
-2. Create variables for your subscription key, the API host and path, your [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a search query.
+2. Create variables for your subscription key, the API host and path, your [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), 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.
     
     ```java
     static String subscriptionKey = "enter key here";
diff --git a/articles/cognitive-services/Bing-Autosuggest/quickstarts/nodejs.md b/articles/cognitive-services/Bing-Autosuggest/quickstarts/nodejs.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 07/26/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -33,7 +33,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     let https = require ('https');
     ```
 
-2. Create variables for the API endpoint host and path, your subscription key, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a search term.
+2. Create variables for the API endpoint host and path, your subscription key, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a 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.
 
     ```javascript
     // Replace the subscriptionKey string value with your valid subscription key.
diff --git a/articles/cognitive-services/Bing-Autosuggest/quickstarts/php.md b/articles/cognitive-services/Bing-Autosuggest/quickstarts/php.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 07/26/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -28,7 +28,8 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
 1. Create a new PHP project in your favorite IDE.
 2. Add the code provided below.
 3. Replace the `subscriptionKey` value with an access key valid for your subscription.
-4. Run the program.
+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.
+5. Run the program.
 
 ```php
 <?php
diff --git a/articles/cognitive-services/Bing-Autosuggest/quickstarts/python.md b/articles/cognitive-services/Bing-Autosuggest/quickstarts/python.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 07/26/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 # Quickstart: Suggest search queries with the Bing Autosuggest REST API and Python
@@ -30,7 +30,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     import http.client, urllib.parse, json
     ```
 
-2. Create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a partial search query.
+2. Create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a partial 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.
 
     ```python
     subscriptionKey = 'enter key here'
diff --git a/articles/cognitive-services/Bing-Autosuggest/quickstarts/ruby.md b/articles/cognitive-services/Bing-Autosuggest/quickstarts/ruby.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 07/26/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -34,7 +34,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     require 'json'
     ```
 
-2. Create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), partial search query.
+2. Create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), partial 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.
 
     ```ruby
     subscriptionKey = 'enter your key here'
diff --git a/articles/cognitive-services/Bing-Autosuggest/tutorials/autosuggest.md b/articles/cognitive-services/Bing-Autosuggest/tutorials/autosuggest.md
@@ -189,7 +189,7 @@ function bingAutosuggest(query, key) {
 ```
 
 Specify the Bing Autosuggest API endpoint and declare an XMLHttpRequest object, which we will
-use to send requests to the endpoint.
+use to send requests. 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.
 
 ```html
     var endpoint = "https://api.cognitive.microsoft.com/bing/v7.0/Suggestions";
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/csharp.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/csharp.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -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.
+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.
 
     ```csharp
     namespace EntitySearchSample
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-csharp-quickstart.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-csharp-quickstart.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/15/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-java-quickstart.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-java-quickstart.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/24/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 # Quickstart: Send a search request with the Bing Entity Search SDK for Java
@@ -62,7 +62,7 @@ Install the Bing Entity Search SDK dependencies by using Maven, Gradle, or anoth
 
 ## Create a search client
 
-1. Implement the `dominantEntityLookup` client, which requires your API endpoint, and an instance of the `ServiceClientCredentials` class.
+1. Implement the `dominantEntityLookup` client, which requires your API endpoint, and an instance of the `ServiceClientCredentials` class. 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.
 
     ```java
     public static EntitySearchAPIImpl getClient(final String subscriptionKey) {
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-node-quickstart.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-node-quickstart.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/24/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-python-quickstart.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/entity-sdk-python-quickstart.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/24/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 # Quickstart: Bing Entity Search SDK with Python
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/java.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/java.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/24/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 # Quickstart: Send a search request to the Bing Entity Search REST API using Java
@@ -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.
+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.
 
    ```java
    public class EntitySearch {
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/nodejs.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/nodejs.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/24/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -36,7 +36,7 @@ While this application is written in JavaScript, the API is a RESTful Web servic
     let https = require ('https');
     ```
 
-2. Create variables for the API endpoint, your subscription key, and search query.
+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.
 
     ```javascript
     let subscriptionKey = 'ENTER YOUR KEY HERE';
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/php.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/php.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/24/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -32,7 +32,8 @@ 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. Run the program.
+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.
+5. Run the program.
 
 ```php
 <?php
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/python.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/python.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 07/24/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -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 find your endpoint in the Azure dashboard.
+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.
 
     ```python
     import http.client, urllib.parse
diff --git a/articles/cognitive-services/Bing-Entities-Search/quickstarts/ruby.md b/articles/cognitive-services/Bing-Entities-Search/quickstarts/ruby.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: quickstart
-ms.date: 08/26/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 
@@ -35,7 +35,7 @@ While this application is written in Ruby, the API is a RESTful Web service comp
     require 'json'
     ```
 
-2. Create variables for your API endpoint, News search URL, your subscription key, and a search query.
+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.
     
     ```ruby
     host = 'https://api.cognitive.microsoft.com'
diff --git a/articles/cognitive-services/Bing-Entities-Search/tutorial-bing-entities-search-single-page-app.md b/articles/cognitive-services/Bing-Entities-Search/tutorial-bing-entities-search-single-page-app.md
@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-entity-search
 ms.topic: tutorial
-ms.date: 07/15/2019
+ms.date: 12/11/2019
 ms.author: aahi
 ---
 # Tutorial: Single-page web app
@@ -81,7 +81,7 @@ The HTML also contains the divisions (HTML `<div>` tags) where the search result
 
 To avoid having to include the Bing Search and Bing Maps API subscription keys in the code, we use the browser's persistent storage to store them. If either key has not been stored, we prompt for it and store it for later use. If the key is later rejected by the API, we invalidate the stored key so the user is asked for it upon their next search.
 
-We define `storeValue` and `retrieveValue` functions that use either the `localStorage` object (if the browser supports it) or a cookie. Our `getSubscriptionKey()` function uses these functions to store and retrieve the user's key.
+We define `storeValue` and `retrieveValue` functions that use either the `localStorage` object (if the browser supports it) or a cookie. Our `getSubscriptionKey()` function uses these functions to store and retrieve the user's key. 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.
 
 ```javascript
 // cookie names for data we store
diff --git a/includes/cognitive-services-bing-autosuggest-signup-requirements.md b/includes/cognitive-services-bing-autosuggest-signup-requirements.md
@@ -3,7 +3,22 @@ author: aahill
 ms.author: aahi
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 02/19/2019
+ms.date: 12/11/2019
 ---
 
-You must have a [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with access to the Bing Autosuggest API. If you don't have an Azure subscription, you can [create an account](https://azure.microsoft.com/try/cognitive-services/?api=bing-news-search-api) for free. Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.
+## Create an Azure resource
+
+Start using the Bing Web Search API by creating one of the Azure resources below.
+
+* [Create a trial resource](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api):
+    * No Azure subscription needed.
+    * Valid for seven days, for free. After signing up, a trial key and endpoint will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).
+
+* [Create a Bing Autosuggest resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesBingAutosuggest-v7):
+    * Available through the Azure portal until you delete the resource.
+    * Use the free pricing tier to try the service, and upgrade later to a paid tier for production.
+    * Bing Autosuggest is also offered in paid tiers of the [Bing Search v7 resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesBingSearch-v7).
+
+* [Create a Multi-Service resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne):
+    * Available through the Azure portal until you delete the resource.  
+    * Use the same key and endpoint for your applications, across multiple Cognitive Services.
diff --git a/includes/cognitive-services-bing-entity-search-signup-requirements.md b/includes/cognitive-services-bing-entity-search-signup-requirements.md
@@ -3,7 +3,22 @@ author: aahill
 ms.author: aahi
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 01/15/2019
+ms.date: 12/11/2019
 ---
 
-You must have a [Cognitive Services API account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with access to the Bing Search APIs. If you don't have an Azure subscription, you can [create an account](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) for free. Before continuing, You will need the access key provided after activating your free trial, or a paid subscription key from your Azure dashboard.
+## Create an Azure resource
+
+Start using the Bing Web Search API by creating one of the Azure resources below.
+
+* [Create a trial resource](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api):
+    * No Azure subscription needed.
+    * Valid for seven days, for free. After signing up, a trial key and endpoint will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).
+
+* [Create a Bing Entity Search resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesBingEntitySearch):
+    * Available through the Azure portal until you delete the resource.
+    * Use the free pricing tier to try the service, and upgrade later to a paid tier for production.
+    * Bing Entity Search is also offered in paid tiers of the [Bing Search v7 resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesBingSearch-v7).
+    
+* [Create a Multi-Service resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne):
+    * Available through the Azure portal until you delete the resource.  
+    * Use the same key and endpoint for your applications, across multiple Cognitive Services.
