You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cognitive-services/Translator/document-translation/how-to-guides/use-client-sdks.md
+7-8Lines changed: 7 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,11 +15,11 @@ ms.author: lajanuar
15
15
# Document Translation client-library SDKs
16
16
<!-- markdownlint-disable MD024 -->
17
17
<!-- markdownlint-disable MD001 -->
18
-
[Document Translation](../overview.md) is a cloud-based feature of the [Azure Translator](../../translator-overview.md) service. You can translate entire documents or process batch document translations in various file formats while preserving original document structure and format. In this article, you'll learn how to use the Document Translation service C#/.NET and Python client libraries. For the REST API, see our [Quickstart](../quickstarts/get-started-with-rest-api.md) guide.
18
+
[Document Translation](../overview.md) is a cloud-based feature of the [Azure Translator](../../translator-overview.md) service. You can translate entire documents or process batch document translations in various file formats while preserving original document structure and format. In this article, you learn how to use the Document Translation service C#/.NET and Python client libraries. For the REST API, see our [Quickstart](../quickstarts/get-started-with-rest-api.md) guide.
19
19
20
20
## Prerequisites
21
21
22
-
To get started, you'll need:
22
+
To get started, you need:
23
23
24
24
* An active [**Azure account**](https://azure.microsoft.com/free/cognitive-services/). If you don't have one, you can [**create a free account**](https://azure.microsoft.com/free/).
25
25
@@ -28,7 +28,7 @@ To get started, you'll need:
28
28
* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You'll [**create containers**](../../../../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container) in your Azure blob storage account for your source and target files:
29
29
30
30
***Source container**. This container is where you upload your files for translation (required).
31
-
***Target container**. This container is where your translated files will be stored (required).
31
+
***Target container**. This container is where your translated files are stored (required).
32
32
33
33
* You also need to create Shared Access Signature (SAS) tokens for your source and target containers. The `sourceUrl` and `targetUrl` , must include a Shared Access Signature (SAS) token, appended as a query string. The token can be assigned to your container or specific blobs. *See*[**Create SAS tokens for Document Translation process**](create-sas-tokens.md).
34
34
@@ -103,7 +103,7 @@ using System;
103
103
usingSystem.Threading;
104
104
```
105
105
106
-
In the application's **Program** class, create variables for your key and custom endpoint. For details, *see*[Custom domain name and key](../quickstarts/get-started-with-rest-api.md#your-custom-domain-name-and-key)
106
+
In the application's **Program** class, create variables for your key and custom endpoint. For more information, *see*[Retrieve your key and custom domain endpoint](../quickstarts/get-started-with-rest-api.md#retrieve-your-key-and-document-translation-endpoint).
* To Start a translation operation for one or more documents in a single blob container, you'll call the `StartTranslationAsync` method.
115
+
* To Start a translation operation for one or more documents in a single blob container, you call the `StartTranslationAsync` method.
116
116
117
117
* To call `StartTranslationAsync`, you need to initialize a `DocumentTranslationInput` object that contains the following parameters:
118
118
119
119
***sourceUri**. The SAS URI for the source container containing documents to be translated.
120
-
***targetUri** The SAS URI for the target container to which the translated documents will be written.
120
+
***targetUri** The SAS URI for the target container to which the translated documents are written.
121
121
***targetLanguageCode**. The language code for the translated documents. You can find language codes on our [Language support](../../language-support.md) page.
122
122
123
123
```csharp
@@ -185,8 +185,7 @@ from azure.core.credentials import AzureKeyCredential
185
185
from azure.ai.translation.document import DocumentTranslationClient
186
186
```
187
187
188
-
Create variables for your resource key, custom endpoint, sourceUrl, and targetUrl. For
189
-
more information, *see*[Custom domain name and key](../quickstarts/get-started-with-rest-api.md#your-custom-domain-name-and-key)
188
+
Create variables for your resource key, custom endpoint, sourceUrl, and targetUrl. For more information, *see*[Retrieve your key and custom domain endpoint](../quickstarts/get-started-with-rest-api.md#retrieve-your-key-and-document-translation-endpoint).
Copy file name to clipboardExpand all lines: articles/cognitive-services/Translator/document-translation/how-to-guides/use-rest-api-programmatically.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ To get started, you need:
34
34
* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You also need to [create containers](#create-azure-blob-storage-containers) in your Azure blob storage account for your source and target files:
35
35
36
36
***Source container**. This container is where you upload your files for translation (required).
37
-
***Target container**. This container is where your translated files will be stored (required).
37
+
***Target container**. This container is where your translated files are stored (required).
38
38
39
39
* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
Copy file name to clipboardExpand all lines: articles/cognitive-services/Translator/document-translation/quickstarts/get-started-with-rest-api.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,7 +35,7 @@ To get started, you need:
35
35
* An [**Azure blob storage account**](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). You also need to [create containers](#create-azure-blob-storage-containers) in your Azure blob storage account for your source and target files:
36
36
37
37
***Source container**. This container is where you upload your files for translation (required).
38
-
***Target container**. This container is where your translated files will be stored (required).
38
+
***Target container**. This container is where your translated files are stored (required).
39
39
40
40
* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
41
41
@@ -63,7 +63,7 @@ To get started, you need:
63
63
> [!div class="nextstepaction"]
64
64
> [I ran into an issue with the prerequisites.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?Pillar=Language&Product=Document-translation&Page=quickstart&Section=Prerequisites)
65
65
66
-
### Retrieve your key and custom domain endpoint
66
+
### Retrieve your key and document translation endpoint
67
67
68
68
*Requests to the Translator service require a read-only key and custom endpoint to authenticate access. The custom domain endpoint is a URL formatted with your resource name, hostname, and Translator subdirectories and is available in the Azure portal.
69
69
@@ -73,7 +73,7 @@ To get started, you need:
73
73
74
74
1. Copy and paste your **`key`** and **`document translation endpoint`** in a convenient location, such as *Microsoft Notepad*. Only one key is necessary to make an API call.
75
75
76
-
1. You **`key`** and **`document translation endpoint`** into the code samples to authenticate your request to the Document Translation service.
76
+
1. You paste your **`key`** and **`document translation endpoint`** into the code samples to authenticate your request to the Document Translation service.
77
77
78
78
:::image type="content" source="../media/document-translation-key-endpoint.png" alt-text="Screenshot showing the get your key field in Azure portal.":::
0 commit comments