Skip to content

Commit 237bda2

Browse files
committed
update screenshot and container
1 parent 119f263 commit 237bda2

File tree

3 files changed

+11
-12
lines changed

3 files changed

+11
-12
lines changed

articles/cognitive-services/Translator/document-translation/how-to-guides/use-client-sdks.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ ms.author: lajanuar
1515
# Document Translation client-library SDKs
1616
<!-- markdownlint-disable MD024 -->
1717
<!-- 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.
1919

2020
## Prerequisites
2121

22-
To get started, you'll need:
22+
To get started, you need:
2323

2424
* 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/).
2525

@@ -28,7 +28,7 @@ To get started, you'll need:
2828
* 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:
2929

3030
* **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).
3232

3333
* 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).
3434

@@ -103,7 +103,7 @@ using System;
103103
using System.Threading;
104104
```
105105

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).
107107

108108
```csharp
109109
private static readonly string endpoint = "<your custom endpoint>";
@@ -112,12 +112,12 @@ private static readonly string key = "<your key>";
112112

113113
### Translate a document or batch files
114114

115-
* 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.
116116

117117
* To call `StartTranslationAsync`, you need to initialize a `DocumentTranslationInput` object that contains the following parameters:
118118

119119
* **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.
121121
* **targetLanguageCode**. The language code for the translated documents. You can find language codes on our [Language support](../../language-support.md) page.
122122

123123
```csharp
@@ -185,8 +185,7 @@ from azure.core.credentials import AzureKeyCredential
185185
from azure.ai.translation.document import DocumentTranslationClient
186186
```
187187

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).
190189

191190
```python
192191
key = "<your-key>"

articles/cognitive-services/Translator/document-translation/how-to-guides/use-rest-api-programmatically.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ To get started, you need:
3434
* 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:
3535

3636
* **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).
3838

3939
* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
4040

articles/cognitive-services/Translator/document-translation/quickstarts/get-started-with-rest-api.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ To get started, you need:
3535
* 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:
3636

3737
* **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).
3939

4040
* A [**single-service Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Cognitive Services resource):
4141

@@ -63,7 +63,7 @@ To get started, you need:
6363
> [!div class="nextstepaction"]
6464
> [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)
6565
66-
### Retrieve your key and custom domain endpoint
66+
### Retrieve your key and document translation endpoint
6767

6868
*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.
6969

@@ -73,7 +73,7 @@ To get started, you need:
7373

7474
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.
7575

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.
7777

7878
:::image type="content" source="../media/document-translation-key-endpoint.png" alt-text="Screenshot showing the get your key field in Azure portal.":::
7979

0 commit comments

Comments
 (0)