Merge pull request #97717 from aahill/bing-setup-updates

ktoliver · web-flow · commit d69d8cd1db03 · 2019-12-06T12:46:11.000-07:00
[CogSvcs][Bing web search] updating setup instructions
diff --git a/articles/cognitive-services/Bing-Web-Search/quickstarts/csharp.md b/articles/cognitive-services/Bing-Web-Search/quickstarts/csharp.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/03/2019
 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#.
@@ -28,6 +28,8 @@ Here are a few things that you'll need before running this quickstart:
 
 This example program only uses .NET Core classes.
 
+## Create a Bing Web Search resource
+
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]
 
 ## Create a project and declare dependencies
@@ -58,7 +60,7 @@ namespace BingSearchApisQuickstart
 
 ## Define variables
 
-A few variables must be set before we can continue. 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. `uriBase` can be the global endpoint below, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) endpoint displayed in the Azure portal for your resource. 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.
 
 ```csharp
 // Enter a valid subscription key.
diff --git a/articles/cognitive-services/Bing-Web-Search/quickstarts/go.md b/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: 03/12/2019
+ms.date: 12/03/2019
 ms.author: aahi
 ms.reviewer: nhoyadx@gmail.com, v-gedod, erhopf
 ms.custom: seodec2018
@@ -19,8 +19,6 @@ ms.custom: seodec2018
 
 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.
 
-See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
-
 ## Prerequisites
 Here are a few things that you'll need before running this quickstart:
 
@@ -29,6 +27,8 @@ Here are a few things that you'll need before running this quickstart:
 
 This quickstart only requires **core** libraries, there are no external dependencies.  
 
+## Create a Bing Web Search resource
+
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]  
 
 ## Create a project and import core libraries
@@ -109,7 +109,9 @@ type BingAnswer struct {
 
 ## Declare the main function and define variables  
 
-This code declares the main function and sets required variables. 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 required variables. `endpoint` can be the global endpoint below, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) 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`.
 
 ```go
 // Declare the main function. This is required for all Go programs.
diff --git a/articles/cognitive-services/Bing-Web-Search/quickstarts/java.md b/articles/cognitive-services/Bing-Web-Search/quickstarts/java.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 07/22/2019
+ms.date: 12/03/2019
 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.
@@ -26,6 +26,8 @@ Here are a few things that you'll need before running this quickstart:
 * [Gson library](https://github.com/google/gson)
 * A subscription key
 
+## Create a Bing Web Search resource
+
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]
 
 ## Create a project and import dependencies
@@ -69,7 +71,9 @@ public class BingWebSearch {
 
 ## Define variables
 
-This code sets the `subscriptionKey`, `host`, `path`, and `searchTerm`. Confirm that the endpoint is correct and 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.
+This code sets the `subscriptionKey`, `host`, `path`, and `searchTerm`. `host` can be the global endpoint below, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) endpoint displayed in the Azure portal for your resource.
+
+Confirm that the endpoint is correct and 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.
 
 ```java
 // Enter a valid subscription key.
diff --git a/articles/cognitive-services/Bing-Web-Search/quickstarts/nodejs.md b/articles/cognitive-services/Bing-Web-Search/quickstarts/nodejs.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/03/2019
 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 Node.js.
@@ -25,6 +25,8 @@ Here are a few things that you'll need before running this quickstart:
 * [Node.js 6](https://nodejs.org/en/download/) or later
 * A subscription key
 
+## Create a Bing Web Search resource
+
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]
 
 ## Create a project and declare required modules
@@ -53,7 +55,7 @@ if (!SUBSCRIPTION_KEY) {
 
 ## Create a function to make the request
 
-This function will make a secure GET request, saving the search query as a query parameter in the path. `encodeURIComponent` is used to escape invalid characters, and the subscription key is passed in a header. The callback receives a [response](https://nodejs.org/dist/latest-v10.x/docs/api/http.html#http_class_http_serverresponse) that subscribes to the `data` event to aggregate the JSON body, the `error` event to log any issues, and the `end` event to know when the message should be considered complete. When complete, the app will print the interesting headers and message body. You can play with the colors and set the depth to suit your preference, a depth of `1` gives a nice summary of the response.
+This function will make a secure GET request, saving the search query as a query parameter in the path. `hostname` can be the global endpoint below, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) endpoint displayed in the Azure portal for your resource. `encodeURIComponent` is used to escape invalid characters, and the subscription key is passed in a header. The callback receives a [response](https://nodejs.org/dist/latest-v10.x/docs/api/http.html#http_class_http_serverresponse) that subscribes to the `data` event to aggregate the JSON body, the `error` event to log any issues, and the `end` event to know when the message should be considered complete. When complete, the app will print the interesting headers and message body. You can play with the colors and set the depth to suit your preference, a depth of `1` gives a nice summary of the response.
 
 ```javascript
 function bingWebSearch(query) {
diff --git a/articles/cognitive-services/Bing-Web-Search/quickstarts/php.md b/articles/cognitive-services/Bing-Web-Search/quickstarts/php.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/03/2019
 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 PHP.
@@ -25,6 +25,8 @@ Here are a few things that you'll need before running this quickstart:
 * [PHP 5.6.x](https://php.net/downloads.php) or later
 * A subscription key  
 
+## Create a Bing Web Search resource
+
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]
 
 ## Enable secure HTTP support
@@ -39,7 +41,7 @@ Before we get started, locate `php.ini` and uncomment this line:
 
 Create a new PHP project in your favorite IDE or editor. Don't forget to add opening and closing tags `<?php` and `?>`.
 
-A few variables must be set before we can continue. Confirm that the `$endpoint` is correct 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 `$term`.
+A few variables must be set before we can continue. `$endpoint` can be the global endpoint below, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) endpoint displayed in the Azure portal for your resource. Confirm that the `$endpoint` is correct 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 `$term`.
 
 ```php
 $accessKey = 'enter key here';
diff --git a/articles/cognitive-services/Bing-Web-Search/quickstarts/python.md b/articles/cognitive-services/Bing-Web-Search/quickstarts/python.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/03/2019
 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 Python.
@@ -26,6 +26,8 @@ This example is run as a Jupyter notebook on [MyBinder](https://mybinder.org). S
 
 * [Python 2.x or 3.x](https://www.python.org/)
 
+## Create a Bing Web Search resource
+
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]
 
 ## Define variables
@@ -37,7 +39,7 @@ subscription_key = "YOUR_ACCESS_KEY"
 assert subscription_key
 ```
 
-Declare the Bing Web Search API endpoint. If you run into any authorization errors, double-check this value against the Bing search endpoint in your Azure dashboard.
+Declare the Bing Web Search API endpoint. It can be the global endpoint below, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) endpoint displayed in the Azure portal for your resource..
 
 ```python
 search_url = "https://api.cognitive.microsoft.com/bing/v7.0/search"
diff --git a/articles/cognitive-services/Bing-Web-Search/quickstarts/ruby.md b/articles/cognitive-services/Bing-Web-Search/quickstarts/ruby.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/03/2019
 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 Ruby.
@@ -25,6 +25,8 @@ Here are a few things that you'll need before running this quickstart:
 * [Ruby 2.4 or later](https://www.ruby-lang.org/en/downloads/)
 * A subscription key
 
+## Create a Bing Web Search resource
+
 [!INCLUDE [bing-web-search-quickstart-signup](../../../../includes/bing-web-search-quickstart-signup.md)]
 
 ## Create a project and declare required modules
@@ -39,7 +41,7 @@ require 'json'
 
 ## Define variables
 
-A few variables must be set before we can continue. Confirm that the `$uri` and `path` are 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 `term`.
+A few variables must be set before we can continue. `uri` can be the global endpoint below, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) endpoint displayed in the Azure portal for your resource. Confirm that the `uri` and `path` are 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 `term`.
 
 ```ruby
 accessKey = "YOUR_SUBSCRIPTION_KEY"
diff --git a/articles/cognitive-services/Bing-Web-Search/web-sdk-java-quickstart.md b/articles/cognitive-services/Bing-Web-Search/web-sdk-java-quickstart.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 07/25/2019
+ms.date: 12/03/2019
 ms.author: aahi
 ---
 
@@ -18,10 +18,6 @@ The Bing Web Search SDK makes it easy to integrate Bing Web Search into your Jav
 
 Want to see the code right now? The [Bing Web Search SDK for Java samples](https://github.com/Azure-Samples/cognitive-services-java-sdk-samples/) are available on GitHub.
 
-[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
-
-See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
-
 ## Prerequisites
 
 Here are a few things that you'll need before running this quickstart:
@@ -30,6 +26,10 @@ Here are a few things that you'll need before running this quickstart:
 * [Apache Maven](https://maven.apache.org/download.cgi) or your favorite build automation tool
 * A subscription key
 
+## Create a Bing Web Search resource
+
+[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
+
 ## Create a project and set up your POM file
 
 Create a new Java project using Maven or your favorite build automation tool. Assuming that you're using Maven, add the following lines to your [Project Object Model (POM)](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html) file. Replace all instances of `mainClass` with your application.
diff --git a/articles/cognitive-services/Bing-Web-Search/web-sdk-python-quickstart.md b/articles/cognitive-services/Bing-Web-Search/web-sdk-python-quickstart.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/03/2019
 ms.author: aahi
 ---
 
@@ -18,17 +18,19 @@ The Bing Web Search SDK makes it easy to integrate Bing Web Search into your Pyt
 
 Want to see the code right now? The [Bing Web Search SDK for Python samples](https://github.com/Azure-Samples/cognitive-services-python-sdk-samples) are available on GitHub.
 
-[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
-
-See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
-
 ## Prerequisites
+
 The Bing Web Search SDK is compatible with Python 2.7, 3.3, 3.4, 3.5, and 3.6. We recommend using a virtual environment for this quickstart.
 
 * Python 2.7, 3.3, 3.4, 3.5 or 3.6
 * [virtualenv](https://docs.python.org/3/tutorial/venv.html) for Python 2.7
 * [venv](https://pypi.python.org/pypi/virtualenv) for Python 3.x
 
+## Create a Bing Web Search resource
+
+[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
+
+
 ## Create and configure your virtual environment
 
 The instructions to set up and configure a virtual environment are different for Python 2.x and Python 3.x. Follow the steps below to create and initialize your virtual environment.
@@ -161,7 +163,7 @@ If the response contains web pages, images, news, or videos, the first result fo
 
 1. Replace `SUBSCRIPTION_KEY` with a valid subscription key.
 
-1. Replace `YOUR_ENDPOINT` with your endpoint url in portal.
+1. Replace `YOUR_ENDPOINT` with your endpoint url. You can use the Bing global endpoint, or the [custom subdomain](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-custom-subdomains) endpoint displayed in the Azure portal for your resource.
 
 1. Run the program. For example: `python your_program.py`.
 
diff --git a/articles/cognitive-services/Bing-Web-Search/web-search-sdk-node-quickstart.md b/articles/cognitive-services/Bing-Web-Search/web-search-sdk-node-quickstart.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 03/12/2019
+ms.date: 12/03/2019
 ms.author: aahi
 ---
 
@@ -18,16 +18,16 @@ The Bing Web Search SDK makes it easy to integrate Bing Web Search into your Nod
 
 Want to see the code right now? The [Bing Web Search SDK for Node.js samples](https://github.com/Azure-Samples/cognitive-services-node-sdk-samples) are available on GitHub.
 
-[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
-
-See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
-
 ## Prerequisites
 Here are a few things that you'll need before running this quickstart:
 
 * [Node.js 6](https://nodejs.org/en/download/) or later
 * A subscription key  
 
+## Create a Bing Web Search resource
+
+[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
+
 ## Set up your development environment
 
 Let's start by setting up the development environment for our Node.js project.
diff --git a/articles/cognitive-services/Bing-Web-Search/web-search-sdk-quickstart.md b/articles/cognitive-services/Bing-Web-Search/web-search-sdk-quickstart.md
@@ -8,18 +8,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: bing-web-search
 ms.topic: quickstart
-ms.date: 04/15/2019
+ms.date: 12/03/2019
 ms.author: aahi
 ---
 
 # Quickstart: Use the Bing Web Search SDK for C#
 
 The Bing Web Search SDK makes it easy to integrate Bing Web Search into your C# application. In this quickstart, you'll learn how to instantiate a client, send a request, and print the response.
 
-[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
-
-See also [Cognitive Services Pricing - Bing Search API](https://azure.microsoft.com/pricing/details/cognitive-services/search-api/).
-
 ## Prerequisites
 Here are a few things that you'll need before running this quickstart:
 
@@ -29,6 +25,11 @@ Here are a few things that you'll need before running this quickstart:
   * [NuGet Package Manager](https://github.com/jmrog/vscode-nuget-package-manager)
 * [.NET Core SDK](https://www.microsoft.com/net/download)
 
+
+## Create a Bing Web Search resource
+
+[!INCLUDE [bing-web-search-quickstart-signup](../../../includes/bing-web-search-quickstart-signup.md)]
+
 ## Create a project and install dependencies
 
 > [!TIP]
diff --git a/includes/bing-web-search-quickstart-signup.md b/includes/bing-web-search-quickstart-signup.md
@@ -1,9 +1,21 @@
 ---
-author: erhopf
-ms.author: erhopf
-ms.service: cognitiveservices
+author: aahill
+ms.author: aahi
+ms.service: cognitive-services
 ms.topic: include
-ms.date: 08/16/2018
+ms.date: 12/03/2019
 ---
 
-This quickstart requires an [Azure Cognitive Services account](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) with Bing Search APIs. If you don't have an account, you can use the [free trial](https://azure.microsoft.com/try/cognitive-services/?api=bing-web-search-api) to get a subscription key.
+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 Bing Search v7 resource](https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesBingSearch-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.
+
+* [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.
