Class LanguageApp
Page Summary
The Language service in Apps Script provides a way to compute automatic translations of text.
The
translate()method is used to automatically translate text from a source language to a destination language.The
translate()method has overloaded versions, one of which accepts an optionaladvancedArgsobject for specifying options like content type.A list of supported language codes is available via a provided link.
The Language service provides scripts a way to compute automatic translations of text.
// The code below will write "Esta es una prueba" to the log.constspanish=LanguageApp.translate('This is a test','en','es');Logger.log(spanish);
Methods
| Method | Return type | Brief description |
|---|---|---|
translate(text, sourceLanguage, targetLanguage) | String | Automatically translates some text from a source language to a destination language. |
translate(text, sourceLanguage, targetLanguage, advancedArgs) | 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.
// The code below will write "Esta es una prueba" to the log.constspanish=LanguageApp.translate('This is a test','en','es');Logger.log(spanish);
Parameters
| Name | Type | Description |
|---|---|---|
text | String | the text to translate |
source | 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 |
target | 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.
// The code below will write "Esta es una <strong>prueba</strong>" to the log.constspanish=LanguageApp.translate('This is a <strong>test</strong>','en','es',{contentType:'html'},);Logger.log(spanish);
Parameters
| Name | Type | Description |
|---|---|---|
text | String | the text to translate |
source | 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 |
target | String | the language code to which the text should be translated |
advanced | Object | optional JavaScript object fields |
Advanced parameters
| Name | Type | Description |
|---|---|---|
content | String | the content type of the text; supported values are 'text' (default) and 'html' |
Return
String — the translated text
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-11 UTC.