Skip to content

Commit 4ba711e

Browse files
authored
Merge pull request #96339 from swmachan/swmachan-parameterClarity
Separate required and optional parameters
2 parents 3628413 + 0a05703 commit 4ba711e

File tree

1 file changed

+14
-5
lines changed

1 file changed

+14
-5
lines changed

articles/cognitive-services/Translator/reference/v3-0-translate.md

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ manager: nitinme
99
ms.service: cognitive-services
1010
ms.subservice: translator-text
1111
ms.topic: reference
12-
ms.date: 10/16/2019
12+
ms.date: 11/12/2019
1313
ms.author: swmachan
1414
---
1515

@@ -29,21 +29,30 @@ https://api.cognitive.microsofttranslator.com/translate?api-version=3.0
2929

3030
Request parameters passed on the query string are:
3131

32+
### Required parameters
33+
3234
<table width="100%">
3335
<th width="20%">Query parameter</th>
3436
<th>Description</th>
3537
<tr>
3638
<td>api-version</td>
3739
<td><em>Required parameter</em>.<br/>Version of the API requested by the client. Value must be <code>3.0</code>.</td>
3840
</tr>
39-
<tr>
40-
<td>from</td>
41-
<td><em>Optional parameter</em>.<br/>Specifies the language of the input text. Find which languages are available to translate from by looking up <a href="./v3-0-languages.md">supported languages</a> using the <code>translation</code> scope. If the <code>from</code> parameter is not specified, automatic language detection is applied to determine the source language. <br/><br/>You must use the <code>from</code> parameter rather than autodetection when using the <a href="https://docs.microsoft.com/azure/cognitive-services/translator/dynamic-dictionary">dynamic dictionary</a> feature.</td>
42-
</tr>
4341
<tr>
4442
<td>to</td>
4543
<td><em>Required parameter</em>.<br/>Specifies the language of the output text. The target language must be one of the <a href="./v3-0-languages.md">supported languages</a> included in the <code>translation</code> scope. For example, use <code>to=de</code> to translate to German.<br/>It's possible to translate to multiple languages simultaneously by repeating the parameter in the query string. For example, use <code>to=de&to=it</code> to translate to German and Italian.</td>
4644
</tr>
45+
</table>
46+
47+
### Optional parameters
48+
49+
<table width="100%">
50+
<th width="20%">Query parameter</th>
51+
<th>Description</th>
52+
<tr>
53+
<td>from</td>
54+
<td><em>Optional parameter</em>.<br/>Specifies the language of the input text. Find which languages are available to translate from by looking up <a href="./v3-0-languages.md">supported languages</a> using the <code>translation</code> scope. If the <code>from</code> parameter is not specified, automatic language detection is applied to determine the source language. <br/><br/>You must use the <code>from</code> parameter rather than autodetection when using the <a href="https://docs.microsoft.com/azure/cognitive-services/translator/dynamic-dictionary">dynamic dictionary</a> feature.</td>
55+
</tr>
4756
<tr>
4857
<td>textType</td>
4958
<td><em>Optional parameter</em>.<br/>Defines whether the text being translated is plain text or HTML text. Any HTML needs to be a well-formed, complete element. Possible values are: <code>plain</code> (default) or <code>html</code>.</td>

0 commit comments

Comments
 (0)