Merge pull request #276859 from laujan/launch-253516-unified-document-translation-api

document translation unified urls

Author: v-dirichards

articles/ai-services/.openpublishing.redirection.ai-services-from-applied.json

@@ -660,6 +660,39 @@
       "source_path_from_root": "/articles/ai-services/document-intelligence/concept-retrieval-augumented-generation.md",
       "redirect_url": "/azure/ai-services/document-intelligence/concept-retrieval-augmented-generation",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/quickstarts/asynchronous-rest-api.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/quickstarts/synchronous-rest-api.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/quickstarts/asynchronous-sdk.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/quickstarts/client-library-sdks",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/reference/synchronous-rest-api-guide.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/reference/translate-document",
+      "redirect_document_id": true
+      
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/reference/start-translation.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/reference/start-batch-translation",
+      "redirect_document_id": true
+      
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/translator/document-translation/reference/get-supported-storage-sources.md",
+      "redirect_url": "/azure/ai-services/translator/document-translation/reference/rest-api-guide",
+      "redirect_document_id": false
+      
     }
 
   ]

articles/ai-services/.openpublishing.redirection.ai-services-from-cog.json

@@ -3593,7 +3593,7 @@
     {
       "source_path_from_root": "/articles/cognitive-services/translator/reference/rest-api-guide.md",
       "redirect_url": "/azure/ai-services/translator/reference/rest-api-guide",
-      "redirect_document_id": true
+      "redirect_document_id": false
     },
     {
       "source_path_from_root": "/articles/cognitive-services/translator/reference/v3-0-break-sentence.md",
@@ -4343,7 +4343,7 @@
     {
       "source_path_from_root": "/articles/cognitive-services/translator/document-translation/how-to-guides/use-rest-api-programmatically.md",
       "redirect_url": "/azure/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically",
-      "redirect_document_id": true
+      "redirect_document_id": false
     },
     {
       "source_path_from_root": "/articles/cognitive-services/translator/document-translation/quickstarts/document-translation-rest-api.md",
@@ -4398,7 +4398,7 @@
     {
       "source_path_from_root": "/articles/cognitive-services/translator/document-translation/reference/rest-api-guide.md",
       "redirect_url": "/azure/ai-services/translator/document-translation/reference/rest-api-guide",
-      "redirect_document_id": true
+      "redirect_document_id": false
     },
     {
       "source_path_from_root": "/articles/cognitive-services/translator/document-translation/reference/start-translation.md",

articles/ai-services/reference/rest-api-resources.md

@@ -6,7 +6,7 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-services
 ms.topic: reference
-ms.date: 03/07/2024
+ms.date: 05/15/2024
 ms.author: lajanuar
 ---
 
@@ -32,7 +32,7 @@ Select a service from the table to learn how it can help you meet your developme
 | ![Face icon](../media/service-icons/face.svg) [Face](../computer-vision/overview-identity.md) | Detect and identify people and emotions in images | [Face API](../computer-vision/identity-api-reference.md) |
 | ![Language icon](../media/service-icons/language.svg) [Language](../language-service/index.yml) | Build apps with industry-leading natural language understanding capabilities | [REST API](/rest/api/language/) |
 | ![Speech icon](../media/service-icons/speech.svg) [Speech](../speech-service/index.yml) | Speech to text, text to speech, translation, and speaker recognition | **Speech APIs**<br>&bullet; [speech to text](../speech-service/rest-speech-to-text.md)<br>&bullet; [text to speech](../speech-service/rest-text-to-speech.md) |
-| ![Translator icon](../media/service-icons/translator.svg) [Translator](../translator/index.yml) | Translate more than 100 in-use, at-risk, and endangered languages and dialects | **Translator APIs**<br>&bullet; [text translation](../translator/reference/rest-api-guide.md) <br>&bullet; [batch translation](../translator/document-translation/reference/rest-api-guide.md) <br>&bullet; [synchronous translation](../translator/document-translation/reference/synchronous-rest-api-guide.md)|
+| ![Translator icon](../media/service-icons/translator.svg) [Translator](../translator/index.yml) | Translate more than 100 in-use, at-risk, and endangered languages and dialects | **Translator APIs**<br>&bullet; [text translation](../translator/reference/rest-api-guide.md) <br>&bullet; [document translation](../translator/document-translation/reference/rest-api-guide.md)|
 | ![Video Indexer icon](../media/service-icons/video-indexer.svg) [Video Indexer](/azure/azure-video-indexer) | Extract actionable insights from your videos | [Video Indexer API](/rest/api/videoindexer/accounts?view=rest-videoindexer-2024-01-01&preserve-view=true) |
 | ![Vision icon](../media/service-icons/vision.svg) [Vision](../computer-vision/index.yml) | Analyze content in images and videos | [Vision API](https://eastus.dev.cognitive.microsoft.com/docs/services/Cognitive_Services_Unified_Vision_API_2024-02-01/operations/61d65934cd35050c20f73ab6) |
 

articles/ai-services/translator/containers/translate-document-parameters.md

@@ -82,4 +82,4 @@ curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&t
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Learn more about synchronous document translation](../document-translation/reference/synchronous-rest-api-guide.md)
+> [Learn more about synchronous document translation](../document-translation/reference/rest-api-guide.md)

articles/ai-services/translator/create-translator-resource.yml

@@ -7,7 +7,7 @@ metadata:
   author: laujan
   ms.author: lajanuar
   manager: nitinme
-  ms.date: 09/06/2023
+  ms.date: 05/17/2024
   ms.service: azure-ai-translator
   ms.topic: how-to
   ms.custom:
@@ -26,16 +26,16 @@ procedureSection:
       Create your resource
     summary: |
       With your Azure account, you can access the Translator service through two different resource types:
-    steps: 
+    steps:
       - |
-        [**Single-service**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) resource types enable access to a single service API key and endpoint.
+        [**Single-service**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) resource types enable access to a single service API key and endpoint. ***Document Translation is only supported in the single-service resources type***.
       - |
-        [**Multi-service**](https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne) resource types enable access to multiple Azure AI services by using a single API key and endpoint.
-  - title: 
+        [**Multi-service**](https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne) resource types enable access to multiple Azure AI services by using a single API key and endpoint. Document Translation is not supported in the multi-service resource type.
+  - title:
       Complete your project and instance details
     summary: |
       After you decide which resource type you want use to access the Translator service, you can enter the details for your project and instance.
-    steps: 
+    steps:
       - |
         **Subscription**. Select one of your available Azure subscriptions.
       - |
@@ -53,7 +53,7 @@ procedureSection:
           * Each subscription has a free tier.
           * The free tier has the same features and functionality as the paid plans and doesn't expire.
           * Only one free tier resource is available per subscription.
-          * Document Translation is supported in paid tiers. The Language Studio only supports the S1 or D3 instance tiers. If you just want to try Document Translation, select the Standard S1 instance tier.
+          * Document Translation is supported in paid tier only. The Language Studio only supports the S1 or D3 instance tiers. If you just want to try Document Translation, select the Standard S1 instance tier.
       - |
         If you create a multi-service resource, the links at the bottom of the **Basics** tab provide technical documentation regarding the appropriate operation of the service.
       - |
@@ -73,21 +73,21 @@ procedureSection:
   - title: |
       Get your authentication keys and endpoint
     summary: |
-      To authenticate your connection to your Translator resource, you'll need to find its keys and endpoint.
+      To authenticate your connection to your Translator resource, you need to find its keys and endpoint.
     steps:
       - |
         After your new resource deploys, select **Go to resource** or go to your resource page.
-      - |  
+      - |
         In the left navigation pane, under **Resource Management**, select **Keys and Endpoint**.
-      - |  
+      - |
         Copy and paste your keys and endpoint URL in a convenient location, such as Notepad.
 
           :::image type="content" source="media/keys-and-endpoint-resource.png" alt-text="Screenshot of the Azure portal showing the Keys and Endpoint page of a Translator resource. The keys and endpoints are highlighted.":::
   - title: |
       Create a Text Translation client
     summary: |
       Text Translation supports both [global and regional endpoints](#complete-your-project-and-instance-details). Once you have your [authentication keys](#authentication-keys-and-endpoint-url), you need to create an instance of the `TextTranslationClient`, using an `AzureKeyCredential` for authentication, to interact with the Text Translation service:
-    steps: 
+    steps:
       - |
         To create a `TextTranslationClient` using a global resource endpoint, you need your resource **API key**:
 
@@ -102,39 +102,50 @@ procedureSection:
         AzureKeyCredential credential = new('<apiKey>');
         TextTranslationClient client = new(credential, '<region>');
         ```
+  - title: |
+      Create a Document Translation client
+    summary: |
+      Use the Document Translation API to asynchronously translate large volumes of text and multiple documents across languages. The batch translation process requires an Azure Blob storage account with storage containers for your source and translated documents.
+    steps:
+      - |
+        Document Translation is currently supported in the Translator (single-service) resource using S1 Standard Service Plan (Pay-as-you-go) or in the D3 Volume Discount Plan.
+
+      - |
+        "For more information on creating a Translator resource for Document Translation, see [Prerequisites: Use Document Translation](document-translation/how-to-guides/use-rest-api-programmatically.md#prerequisites)".
+
   - title: |
       How to delete a  resource or resource group
     summary: |
       > [!WARNING]
       >
       > Deleting a resource group also deletes all resources contained in the group.
-  
+
       To delete the resource:
 
-        1. Search and select **Resource groups** in the Azure portal, and select your resource group.
+        1. Search and select ***Resource groups*** in the Azure portal, and select your resource group.
 
         2. Select the resources to be deleted by selecting the adjacent check box.
 
-        3. Select **Delete** from the top menu near the right edge.
+        3. Select ***Delete*** from the top menu near the right edge.
 
-        4. Enter *delete* in the **Delete Resources** dialog box.
+        4. Enter **delete** in the ***Delete Resources*** dialog box.
+
+        5. Select ***Delete***.
 
-        5. Select **Delete**.
-        
 
       To delete the resource group:
-    steps: 
-      - |  
+    steps:
+      - |
         Go to your Resource Group in the Azure portal.
       - |
         Select **Delete resource group** from the top menu bar.
-      - |  
+      - |
         Confirm the deletion request by entering the resource group name and selecting **Delete**.
-  
+
 nextStep:
-  text: Get started with Translator
+  text: Get started with Translator.
   url: quickstart-text-rest-api.md
-  
+
 #  - text: Get started with Translator
 #    url: quickstart-text-rest-api.md
 #  - text: Microsoft Translator code samples

articles/ai-services/translator/document-translation/document-sdk-overview.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-translator
 ms.custom: devx-track-python
 ms.topic: conceptual
-ms.date: 02/12/2024
+ms.date: 05/21/2024
 ms.author: lajanuar
 recommendations: false
 ---
@@ -17,7 +17,7 @@ recommendations: false
 <!-- markdownlint-disable MD001 -->
 <!-- markdownlint-disable MD051 -->
 
-# Document Translation SDK
+# Document Translation SDKs
 
 Document Translation is a cloud-based REST API feature of the Azure AI Translator service. The Document Translation API enables quick and accurate source-to-target whole document translations, asynchronously, in supported languages and various file formats. The Document Translation software development kit (SDK) is a set of libraries and tools that enable you to easily integrate Document Translation REST API capabilities into your applications.
 
@@ -27,28 +27,28 @@ Document Translation SDK supports the following programming languages:
 
 | Language → SDK version | Package|Client library| Supported API version|
 |:----------------------:|:----------|:----------|:-------------|
-|[.NET/C# → 1.0.0](https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.AI.Translation.Document/1.0.0/index.html)| [NuGet](https://www.nuget.org/packages/Azure.AI.Translation.Document) | [Azure SDK for .NET](/dotnet/api/overview/azure/AI.Translation.Document-readme?view=azure-dotnet&preserve-view=true) | Document Translation v1.1|
-|[Python → 1.0.0](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-ai-translation-document/1.0.0/index.html)|[PyPi](https://pypi.org/project/azure-ai-translation-document/1.0.0/)|[Azure SDK for Python](/python/api/overview/azure/ai-translation-document-readme?view=azure-python&preserve-view=true)|Document Translation v1.1|
+|🆕 [.NET/C# → 2.0.0-beta.1](https://azuresdkdocs.blob.core.windows.net/$web/dotnet/Azure.AI.Translation.Document/2.0.0-beta.1/index.html)| [NuGet](https://www.nuget.org/packages/Azure.AI.Translation.Document/2.0.0-beta.1) | [Azure SDK for .NET](/dotnet/api/overview/azure/ai.translation.document-readme?branch=main&view=azure-dotnet-preview&preserve-view=true) | Document Translation `api-version=2024-05-01`|
+|🆕 [Python → 1.1.0b1](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-ai-translation-document/1.1.0b1/index.html)|[PyPi](https://pypi.org/project/azure-ai-translation-document/1.1.0b1/)|[Azure SDK for Python](/python/api/overview/azure/ai-translation-document-readme?view=azure-python&preserve-view=true)|Document Translation `api-version=2024-05-01`|
 
 ## Changelog and release history
 
 This section provides a version-based description of Document Translation feature and capability releases, changes, updates, and enhancements.
 
 ### [C#/.NET](#tab/csharp)
 
-**Version 1.0.0 (GA)** </br>
-**2022-06-07**
+**Version 2.0.0-beta.1** </br>
+**2024-05-07**
 
-##### [**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-net/blob/Azure.AI.Translation.Document_1.0.0/sdk/translation/Azure.AI.Translation.Document/CHANGELOG.md)
+##### [**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/translation/Azure.AI.Translation.Document/CHANGELOG.md#200-beta1-2024-05-07)
 
-##### [README](https://github.com/Azure/azure-sdk-for-net/blob/Azure.AI.Translation.Document_1.0.0/sdk/translation/Azure.AI.Translation.Document/README.md)
+##### [README](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/translation/Azure.AI.Translation.Document/README.md)
 
-##### [Samples](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Translation.Document_1.0.0/sdk/translation/Azure.AI.Translation.Document/samples)
+##### [Samples](https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/translation/Azure.AI.Translation.Document/samples)
 
 ### [Python](#tab/python)
 
-**Version 1.0.0 (GA)** </br>
-**2022-06-07**
+**Version 1.1.0b1** </br>
+**2024-05-07**
 
 ##### [**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-python/blob/azure-ai-translation-document_1.0.0/sdk/translation/azure-ai-translation-document/CHANGELOG.md)
 
@@ -67,11 +67,11 @@ The Document Translation SDK enables the use and management of the Translation s
 ### [C#/.NET](#tab/csharp)
 
 ```dotnetcli
-dotnet add package Azure.AI.Translation.Document --version 1.0.0
+dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta.1
 ```
 
 ```powershell
-Install-Package Azure.AI.Translation.Document -Version 1.0.0
+Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1
 ```
 
 ### [Python](#tab/python)
@@ -180,4 +180,4 @@ The [`Microsoft Q&A`](/answers/tags/132/azure-translator) and [Stack Overflow](h
 ## Next steps
 
 >[!div class="nextstepaction"]
-> [**Document Translation SDK quickstart**](quickstarts/asynchronous-sdk.md) [**Document Translation v1.1 REST API reference**](reference/rest-api-guide.md)
+> [**Document Translation SDK quickstart**](quickstarts/client-library-sdks.md) [**Document Translation v1.1 REST API reference**](reference/rest-api-guide.md)

articles/ai-services/translator/document-translation/how-to-guides/create-sas-tokens.md

@@ -184,5 +184,5 @@ That's it! You just learned how to create SAS tokens to authorize how clients ac
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Get Started with Document Translation](../quickstarts/asynchronous-rest-api.md)
+> [Get Started with Document Translation](../how-to-guides/use-rest-api-programmatically.md)
 >

articles/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities.md

@@ -251,7 +251,7 @@ Great! You just learned how to enable and use a system-assigned managed identity
 ## Next steps
 
 > [!div class="nextstepaction"]
-> [Quickstart: Get started with Document Translation](../quickstarts/asynchronous-rest-api.md)
+> [Quickstart: Get started with Document Translation](../how-to-guides/use-rest-api-programmatically.md)
 
 > [!div class="nextstepaction"]
 > [Tutorial: Access Azure Storage from a web app using managed identities](../../../../app-service/scenario-secure-app-access-storage.md?bc=%2fazure%2fcognitive-services%2ftranslator%2fbreadcrumb%2ftoc.json&toc=%2fazure%2fcognitive-services%2ftranslator%2ftoc.json)

articles/ai-services/translator/document-translation/how-to-guides/use-rest-api-programmatically.md

@@ -6,7 +6,7 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: quickstart
-ms.date: 02/12/2024
+ms.date: 05/15/2024
 ms.author: lajanuar
 recommendations: false
 ms.devlang: csharp
@@ -322,15 +322,13 @@ gradle init --type basic
 
 #### Locating  the `id` value
 
-* You find the job `id`  in the POST method response Header `Operation-Location`  URL value. The last parameter of the URL is the operation's job **`id`**:
+* You can find the job `id`  in the POST `start-batch-translation` method response Header `Operation-Location`  URL value. The alphanumeric string following the `/document/` parameter is the operation's job **`id`**:
 
-|**Response header**|**Result URL**|
+|**Response header**|**Response URL**|
 |-----------------------|----------------|
-Operation-Location   | https://<<span>NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec</span>
+|Operation-Location   | {document-translation-endpoint}/translator/document/`9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec`?api-version=2024-05-01|
 
-* You can also use a **GET Jobs** request to retrieve a Document Translation  job `id` .
-
->
+* You can also use a [get-translations-status](../reference/get-translations-status.md) request to retrieve a list of translation _**jobs**_ and their `id`s.
 
 ## Translate documents