LanguageApp

The Language service provides scripts a way to compute automatic translations of text.

```javascript
// The code below will write "Esta es una prueba" to the log.
const spanish = LanguageApp.translate('This is a test', 'en', 'es');
Logger.log(spanish);
```

### Methods

| Method | Return type | Brief description |
|---|---|---|
| `https://developers.google.com/apps-script/reference/language/language-app#translate(String,String,String)` | `String` | Automatically translates some text from a source language to a destination language. |
| `https://developers.google.com/apps-script/reference/language/language-app#translate(String,String,String,Object)` | `String` | Automatically translates some text from a source language to a destination language. |

## Detailed documentation

### `translate(text, sourceLanguage, targetLanguage)`

Automatically translates some text from a source language to a destination language.

```javascript
// The code below will write "Esta es una prueba" to the log.
const spanish = LanguageApp.translate('This is a test', 'en', 'es');
Logger.log(spanish);
```
A list of language codes is available [here](https://developers.google.com/translate/docs/languages).

#### Parameters

| Name | Type | Description |
|---|---|---|
| `text` | `String` | the text to translate |
| `sourceLanguage` | `String` | the language code in which text is written. If it is set to the empty string, the source language code will be auto-detected |
| `targetLanguage` | `String` | the language code to which the text should be translated |

#### Return


`String` --- the translated text

*** ** * ** ***

### `translate(text, sourceLanguage, targetLanguage, advancedArgs)`

Automatically translates some text from a source language to a destination language.

```javascript
// The code below will write "Esta es una <strong>prueba</strong>" to the log.
const spanish = LanguageApp.translate(
    'This is a &lt;strong&gt;test&lt;/strong&gt;',
    'en',
    'es',
    {contentType: 'html'},
);
Logger.log(spanish);
```
A list of language codes is available [here](https://developers.google.com/translate/docs/languages).

#### Parameters

| Name | Type | Description |
|---|---|---|
| `text` | `String` | the text to translate |
| `sourceLanguage` | `String` | the language code in which text is written. If it is set to the empty string, the source language code will be auto-detected |
| `targetLanguage` | `String` | the language code to which the text should be translated |
| `advancedArgs` | `Object` | optional JavaScript object fields |

#### Advanced parameters

| Name | Type | Description |
|---|---|---|
| `contentType` | `String` | the content type of the text; supported values are 'text' (default) and 'html' |

#### Return


`String` --- the translated text