Merge pull request #210462 from laujan/1982056-update-text-translation-char-count-charge

update char count charge and date

Author: prmerger-automator[bot]

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

@@ -9,7 +9,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: reference
-ms.date: 08/15/2022
+ms.date: 09/07/2022
 ms.author: lajanuar
 ---
 
@@ -120,8 +120,9 @@ Examples of JSON responses are provided in the [examples](#examples) section.
 
 | Headers | Description |
 | --- | --- |
-| X-RequestId | Value generated by the service to identify the request. It's used for troubleshooting purposes. |
-| X-MT-System | Specifies the system type that was used for translation for each 'to' language requested for translation. The value is a comma-separated list of strings. Each string indicates a type:  <br><br>* Custom - Request includes a custom system and at least one custom system was used during translation.<br>* Team - All other requests |
+| X-requestid | Value generated by the service to identify the request. It's used for troubleshooting purposes. |
+| X-mt-system | Specifies the system type that was used for translation for each 'to' language requested for translation. The value is a comma-separated list of strings. Each string indicates a type:  <br><br>* Custom - Request includes a custom system and at least one custom system was used during translation.<br>* Team - All other requests |
+| X-metered-usage |Specifies consumption (the number of characters for which the user will be charged) for the translation job request. For example, if the word "Hello" is translated from English (en) to French (fr), this field will return the value '5'.|
 
 ## Response status codes
 
@@ -371,14 +372,15 @@ The response is:
 The alignment information starts with `0:2-0:1`, which means that the first three characters in the source text (`The`) map to the first two characters in the translated text (`La`).
 
 #### Limitations
+
 Obtaining alignment information is an experimental feature that we've enabled for prototyping research and experiences with potential phrase mappings. We may choose to stop supporting this feature in the future. Here are some of the notable restrictions where alignments aren't supported:
 
 * Alignment isn't available for text in HTML format that is, textType=html
 * Alignment is only returned for a subset of the language pairs:
-  - English to/from any other language except Chinese Traditional, Cantonese (Traditional) or Serbian (Cyrillic).
-  - from Japanese to Korean or from Korean to Japanese.
-  - from Japanese to Chinese Simplified and Chinese Simplified to Japanese.
-  - from Chinese Simplified to Chinese Traditional and Chinese Traditional to Chinese Simplified.
+  * English to/from any other language except Chinese Traditional, Cantonese (Traditional) or Serbian (Cyrillic).
+  * from Japanese to Korean or from Korean to Japanese.
+  * from Japanese to Chinese Simplified and Chinese Simplified to Japanese.
+  * from Chinese Simplified to Chinese Traditional and Chinese Traditional to Chinese Simplified.
 * You won't receive alignment if the sentence is a canned translation. Example of a canned translation is "This is a test", "I love you" and other high frequency sentences.
 * Alignment isn't available when you apply any of the approaches to prevent translation as described [here](../prevent-translation.md)
 
@@ -392,7 +394,7 @@ curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-versio
 
 The response is:
 
-```
+```json
 [
     {
         "translations":[

articles/cognitive-services/Translator/translator-text-apis.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: how-to
-ms.date: 06/20/2022
+ms.date: 09/07/2022
 ms.author: lajanuar
 ms.devlang: csharp, golang, java, javascript, python
 ms.custom: cog-serv-seo-aug-2020, mode-other
@@ -60,7 +60,7 @@ To call the Translator service via the [REST API](reference/rest-api-guide.md),
 |**X-ClientTraceId**|A client-generated GUID to uniquely identify the request. You can omit this header if you include the trace ID in the query string using a query parameter named ClientTraceId.|<ul><li>***Optional***</li></ul>
 |||
 
-## Setup your application
+## Set up your application
 
 ### [C#](#tab/csharp)
 
@@ -113,7 +113,7 @@ To call the Translator service via the [REST API](reference/rest-api-guide.md),
 
 1. Open the **Program.cs** file.
 
-1. Delete the pre-existing code, including the line `Console.Writeline("Hello World!")`. You will copy and paste the code samples into your application's Program.cs file. For each code sample, make sure you update the key and endpoint variables with values from your Azure portal Translator instance.
+1. Delete the pre-existing code, including the line `Console.Writeline("Hello World!")`. You'll copy and paste the code samples into your application's Program.cs file. For each code sample, make sure you update the key and endpoint variables with values from your Azure portal Translator instance.
 
 1. Once you've added a desired code sample to your application, choose the green **start button** next to formRecognizer_quickstart to build and run your program, or press **F5**.
 
@@ -141,7 +141,7 @@ You can use any text editor to write Go applications. We recommend using the lat
 
 1. Create a new GO file named **text-translator.go** from the **translator-text-app** directory.
 
-1. You will copy and paste the code samples into your **text-translator.go** file. Make sure you update the key variable with the value from your Azure portal Translator instance.
+1. You'll copy and paste the code samples into your **text-translator.go** file. Make sure you update the key variable with the value from your Azure portal Translator instance.
 
 1. Once you've added a code sample to your application, your Go program can be executed in a command or terminal prompt. Make sure your prompt's path is set to the **translator-text-app** folder and use the following command:
 
@@ -227,7 +227,7 @@ You can use any text editor to write Go applications. We recommend using the lat
     >
     > * You can also create a new file in your IDE named `TranslatorText.java`  and save it to the `java` directory.
 
-1. You will copy and paste the code samples `TranslatorText.java` file. **Make sure you update the key with one of the key values from your Azure portal Translator instance**.
+1. You'll copy and paste the code samples `TranslatorText.java` file. **Make sure you update the key with one of the key values from your Azure portal Translator instance**.
 
 1. Once you've added a code sample to your application, navigate back to your main project directory—**translator-text-app**, open a console window, and enter the following commands:
 
@@ -290,7 +290,7 @@ You can use any text editor to write Go applications. We recommend using the lat
     >
     > * You can also create a new file named `index.js` in your IDE and save it to the `translator-text-app` directory.
 
-1. You will copy and paste the code samples into your `index.js` file. **Make sure you update the key variable with the value from your Azure portal Translator instance**.
+1. You'll copy and paste the code samples into your `index.js` file. **Make sure you update the key variable with the value from your Azure portal Translator instance**.
 
 1. Once you've added the code sample to your application, run your program:
 
@@ -611,6 +611,8 @@ After a successful call, you should see the following response:
 ]
 ```
 
+You can check the consumption (the number of characters for which you'll be charged) for each request in the [**response headers: x-metered-usage**](reference/v3-0-translate.md#response-headers) field.
+
 ## Detect language
 
 If you need translation, but don't know the language of the text, you can use the language detection operation. There's more than one way to identify the source text language. In this section, you'll learn how to use language detection using the `translate` endpoint, and the `detect` endpoint.