Skip to content

Commit 0a05703

Browse files
authored
Separate required and optional parameters
Data analysis shows increased number of 400s upon calling "translate" operation. Hence providing clarity on parameter differentiation to reduce the customer pain of making a successful call.
1 parent 5a60eb8 commit 0a05703

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)