Merge pull request #105908 from john-par/1678688-adding-zone-pivots-bing-custom-search

1678688, adding zone pivots bing custom search

Author: PMEds28

.openpublishing.redirection.json

@@ -32618,6 +32618,21 @@
       "redirect_url": "/azure/cognitive-services/bing-web-search/language-support",
       "redirect_document_id": true
     },
+    {
+      "source_path": "articles/cognitive-services/Bing-Custom-Search/sdk-csharp-quick-start.md",
+      "redirect_url": "/azure/cognitive-services/bing-custom-search/quickstarts/client-libraries",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Bing-Custom-Search/sdk-java-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/bing-custom-search/quickstarts/client-libraries",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Bing-Custom-Search/sdk-python-quickstart.md",
+      "redirect_url": "/azure/cognitive-services/bing-custom-search/quickstarts/client-libraries",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/cognitive-services/Bing-Autosuggest/bing-autosuggest-supported-languages.md",
       "redirect_url": "/azure/cognitive-services/bing-autosuggest/language-support",

articles/cognitive-services/Bing-Custom-Search/sdk-csharp-quick-start.md renamed to articles/cognitive-services/Bing-Custom-Search/includes/quickstarts/custom-search-client-library-csharp.md

@@ -1,24 +1,26 @@
 ---
-title: "Quickstart: Call your Bing Custom Search endpoint using the C# SDK"
+title: Bing Custom Search C# client library quickstart 
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to begin requesting search results from your Bing Custom Search instance using the C# SDK. 
 services: cognitive-services
-author: swhite-msft
+author: aahill
 manager: nitinme
 ms.service: cognitive-services
-ms.subservice: bing-custom-search
-ms.topic: quickstart
-ms.date: 12/09/2019
-ms.author: scottwhi
+ms.topic: include
+ms.date: 02/27/2020
+ms.author: aahi
 ---
 
-# Quickstart: Call your Bing Custom Search endpoint using the C# SDK 
+Get started with the Bing Custom Search client library for C#. Follow these steps to install the package and try out the example code for basic tasks. The Bing Custom Search API enables you to create tailored, ad-free search experiences for topics that you care about. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples/tree/master/BingSearchv7/BingCustomWebSearch).
+
+Use the Bing Custom Search client library for C# to:
+* Find search results on the web, from your Bing Custom Search instance.
+
+[Reference documentation](https://docs.microsoft.com/dotnet/api/overview/azure/cognitiveservices/client/bingcustomsearch?view=azure-dotnet) | [Library source code](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/cognitiveservices/Search.BingCustomSearch) | [Package (NuGet)](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Search.CustomSearch/1.2.0) | [Samples](https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples)
 
-Use this quickstart to begin requesting search results from your Bing Custom Search instance, using the C# SDK. While Bing Custom Search has a REST API compatible with most programming languages, the Bing Custom Search SDK provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-dotnet-sdk-samples/tree/master/BingSearchv7/BingCustomWebSearch).
 
 ## 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. 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 2017 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/).
@@ -28,7 +30,7 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
         - Microsoft.Rest.ClientRuntime.Azure
         - Newtonsoft.Json
 
-[!INCLUDE [cognitive-services-bing-news-search-prerequisites](../../../includes/cognitive-services-bing-custom-search-signup-requirements.md)]
+[!INCLUDE [cognitive-services-bing-custom-search-prerequisites](~/includes/cognitive-services-bing-custom-search-signup-requirements.md)]
 
 
 ## Create and initialize the application
@@ -84,4 +86,4 @@ Use this quickstart to begin requesting search results from your Bing Custom Sea
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Build a Custom Search web app](./tutorials/custom-search-web-page.md)
+> [Build a Custom Search web app](../../tutorials/custom-search-web-page.md)

articles/cognitive-services/Bing-Custom-Search/sdk-java-quickstart.md renamed to articles/cognitive-services/Bing-Custom-Search/includes/quickstarts/custom-search-client-library-java.md

@@ -1,20 +1,16 @@
 ---
-title: "Quickstart: Bing Custom Search client library for Java"
-description: Get started with the Bing Custom Search client library for Java by requesting search results from your Bing Custom Search instance in this quickstart. 
+title: Bing Custom Search Java client library quickstart 
+titleSuffix: Azure Cognitive Services
 services: cognitive-services
 author: aahill
 manager: nitinme
 ms.service: cognitive-services
-ms.subservice: 
-ms.topic: quickstart
-ms.date: 12/09/2019
+ms.topic: include
+ms.date: 02/27/2020
 ms.author: aahi
 ---
 
-
-# Quickstart: Bing Custom Search client library for Java
-
-Get started with the Bing Custom Search client library for Java. Follow these steps to install the package and try out the example code for basic tasks. The Bing Custom Search API enables you to create tailored, ad-free search experiences for topics that you care about.
+Get started with the Bing Custom Search client library for Java. Follow these steps to install the package and try out the example code for basic tasks. The Bing Custom Search API enables you to create tailored, ad-free search experiences for topics that you care about. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-java-sdk-samples/tree/master/Search/BingCustomSearch)
 
 Use the Bing Custom Search client library for Java to:
 
@@ -27,16 +23,9 @@ Use the Bing Custom Search client library for Java to:
 * Azure subscription - [Create one for free](https://azure.microsoft.com/free/).
 * The current version of the [Java Development Kit (JDK)](https://www.oracle.com/technetwork/java/javase/downloads/index.html).
 * The [Gradle build tool](https://gradle.org/install/), or another dependency manager.
-* A Bing Custom Search instance. See [Quickstart: Create your first Bing Custom Search instance](quick-start.md) for more information.
-
-## Setting up
-
-### Create a Bing Custom Search Azure resource
-
-Azure Cognitive Services are represented by Azure resources that you subscribe to. Create a resource for Bing Custom Search using the [Azure portal](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account) or [Azure CLI](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli) on your local machine. You can also:
+* A Bing Custom Search instance. See [Quickstart: Create your first Bing Custom Search instance](../../quick-start.md) for more information.
 
-* Get a [trial key](https://azure.microsoft.com/try/cognitive-services/#decision) valid for 7 days for free. After signing up, it will be available on the [Azure website](https://azure.microsoft.com/try/cognitive-services/my-apis/).  
-* View your resource on the [Azure portal](https://portal.azure.com/).
+[!INCLUDE [cognitive-services-bing-custom-search-prerequisites](~/includes/cognitive-services-bing-custom-search-signup-requirements.md)]
 
 After you get a key from your trial subscription or resource, [create an environment variable](https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account#configure-an-environment-variable-for-authentication) for the key, named `AZURE_BING_CUSTOM_SEARCH_API_KEY`.
 
@@ -147,10 +136,10 @@ gradle run
 
 If you want to clean up and remove a Cognitive Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
-* [Portal](../cognitive-services-apis-create-account.md#clean-up-resources)
-* [Azure CLI](../cognitive-services-apis-create-account-cli.md#clean-up-resources)
+* [Portal](../../../cognitive-services-apis-create-account.md#clean-up-resources)
+* [Azure CLI](../../../cognitive-services-apis-create-account-cli.md#clean-up-resources)
 
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Build a Custom Search web app](./tutorials/custom-search-web-page.md)
+> [Build a Custom Search web app](../../tutorials/custom-search-web-page.md)

articles/cognitive-services/Bing-Custom-Search/sdk-python-quickstart.md renamed to articles/cognitive-services/Bing-Custom-Search/includes/quickstarts/custom-search-client-library-python.md

@@ -1,30 +1,34 @@
 ---
-title: "Quickstart: Call your Bing Custom Search endpoint using the Python SDK"
+title: Bing Custom Search Python client library quickstart 
 titleSuffix: Azure Cognitive Services
-description: Use this quickstart to begin requesting search results from your Bing Custom Search instance using the Python SDK. 
 services: cognitive-services
 author: aahill
 manager: nitinme
 ms.service: cognitive-services
-ms.subservice: bing-custom-search
-ms.topic: quickstart
-ms.date: 02/12/2020
+ms.topic: include
+ms.date: 02/27/2020
 ms.author: aahi
 ---
 
-# Quickstart: Call your Bing Custom Search endpoint using the Python SDK 
+Get started with the Bing Custom Search client library for Python. Follow these steps to install the package and try out the example code for basic tasks. The Bing Custom Search API enables you to create tailored, ad-free search experiences for topics that you care about.The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-python-sdk-samples/blob/master/samples/search/custom_search_samples.py).
+
+Use the Bing Custom Search client library for Python to:
+* Find search results on the web, from your Bing Custom Search instance.
+
+[Reference documentation](https://docs.microsoft.com/python/api/overview/azure/cognitiveservices/customsearch?view=azure-python) | [Library source code](https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/cognitiveservices/azure-cognitiveservices-search-customsearch) | [Package (PyPi)](https://pypi.org/project/azure-cognitiveservices-search-customsearch/) | [Samples](https://github.com/Azure-Samples/cognitive-services-python-sdk-samples/)
 
-Use this quickstart to begin requesting search results from your Bing Custom Search instance, using the Python SDK. While Bing Custom Search has a REST API compatible with most programming languages, the Bing Custom Search SDK provides an easy way to integrate the service into your applications. The source code for this sample can be found on [GitHub](https://github.com/Azure-Samples/cognitive-services-python-sdk-samples/blob/master/samples/search/custom_search_samples.py) with additional error handling and annotations.
 
 ## 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. See [Quickstart: Create your first Bing Custom Search instance](../../quick-start.md) for more information.
 - Python [2.x or 3.x](https://www.python.org/) 
 - The [Bing Custom Search SDK for Python](https://pypi.org/project/azure-cognitiveservices-search-customsearch/) 
 
-## Install the Python SDK
+[!INCLUDE [cognitive-services-bing-custom-search-prerequisites](~/includes/cognitive-services-bing-custom-search-signup-requirements.md)]
+
+## Install the Python client library
 
-Install the Bing Custom Search SDK with the following command.
+Install the Bing Custom Search client library with the following command.
 
 ```Console
 python -m pip install azure-cognitiveservices-search-customsearch
@@ -78,4 +82,4 @@ else:
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Build a Custom Search web app](./tutorials/custom-search-web-page.md)
+> [Build a Custom Search web app](../../tutorials/custom-search-web-page.md)

articles/cognitive-services/Bing-Custom-Search/quickstarts/client-libraries.md

@@ -0,0 +1,35 @@
+---
+title: 'Quickstart: Use the Bing Custom Search client library'
+titleSuffix: Azure Cognitive Services
+description: The Custom Search API offers client libraries that makes it easy to integrate search capabilities into your applications. Use this quickstart to start sending search requests, and get back results.
+services: cognitive-services
+author: aahill
+manager: nitinme
+zone_pivot_groups: programming-languages-set-eleven
+
+ms.service: cognitive-services
+ms.subservice: bing-custom-search
+ms.topic: quickstart
+ms.date: 02/27/2020
+ms.author: aahi
+---
+
+# Quickstart: Use the Bing Custom Search client library
+
+::: zone pivot="programming-language-csharp"
+
+[!INCLUDE [C# quickstart](../includes/quickstarts/custom-search-client-library-csharp.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-python"
+
+[!INCLUDE [Python quickstart](../includes/quickstarts/custom-search-client-library-python.md)]
+
+::: zone-end
+
+::: zone pivot="programming-language-java"
+
+[!INCLUDE [Java quickstart](../includes/quickstarts/custom-search-client-library-java.md)]
+
+::: zone-end

articles/cognitive-services/Bing-Custom-Search/toc.yml

@@ -27,12 +27,8 @@
             href: call-endpoint-python.md
       - name: SDK
         items:
-          - name: Using C#
-            href: sdk-csharp-quick-start.md
-          - name: Using Python
-            href: sdk-python-quickstart.md
-          - name: Using Java
-            href: sdk-java-quickstart.md
+          - name: Bing Custom Search client libraries
+            href: ./quickstarts/client-libraries.md
 - name: Tutorials
   items:
     - name: Build a Custom Search web page

articles/cognitive-services/Bing-Web-Search/index.yml

@@ -66,13 +66,13 @@ conceptualContent:
           url: ../bing-custom-search/quick-start.md
         - text: Use C#
           itemType: quickstart
-          url: ../bing-custom-search/sdk-csharp-quick-start.md
+          url: ../bing-custom-search/quickstarts/client-libraries.md?pivots=programming-language-csharp
         - text: Use Java
           itemType: quickstart
-          url: ../bing-custom-search/sdk-java-quickstart.md
+          url: ../bing-custom-search/quickstarts/client-libraries.md?pivots=programming-language-java
         - text: Use Python
           itemType: quickstart
-          url: ../bing-custom-search/sdk-python-quickstart.md
+          url: ../bing-custom-search/quickstarts/client-libraries.md?pivots=programming-language-python
         - text: Create a single page web-app
           itemType: tutorial
           url: ../bing-custom-search/tutorials/custom-search-web-page.md

articles/zone-pivot-groups.yml

@@ -151,6 +151,17 @@ groups:
     title: JavaScript
   - id: programming-language-python
     title: Python
+- id: programming-languages-set-eleven
+# Owner: aahill
+  title: Programming languages
+  prompt: Choose a programming language
+  pivots:
+  - id: programming-language-csharp
+    title: C#
+  - id: programming-language-java
+    title: Java
+  - id: programming-language-python
+    title: Python
 # Service-specific groups
 - id: cogsvcs-text-analytics-features
   title: Text Analytics features