Class LanguageApp
Stay organized with collections
Save and categorize content based on your preferences.
LanguageApp
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.
const spanish = LanguageApp.translate('This is a test', 'en', 'es');
Logger.log(spanish);
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.
const spanish = LanguageApp.translate('This is a test', 'en', 'es');
Logger.log(spanish);
A list of language codes is available
here.
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.
// The code below will write "Esta es una <strong>prueba</strong>" to the log.
const spanish = LanguageApp.translate(
'This is a <strong>test</strong>',
'en',
'es',
{contentType: 'html'},
);
Logger.log(spanish);
A list of language codes is available
here.
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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-02 UTC.
[null,null,["Last updated 2024-12-02 UTC."],[[["\u003cp\u003eThe Language service automatically translates text between languages using the \u003ccode\u003etranslate()\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the source and target languages using language codes, with auto-detection available for the source language.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etranslate()\u003c/code\u003e method supports optional advanced arguments for handling different content types like HTML.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive list of supported language codes can be found in the documentation.\u003c/p\u003e\n"]]],[],null,["# Class LanguageApp\n\nLanguageApp\n\nThe Language service provides scripts a way to compute automatic translations of text.\n\n```javascript\n// The code below will write \"Esta es una prueba\" to the log.\nconst spanish = LanguageApp.translate('This is a test', 'en', 'es');\nLogger.log(spanish);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|----------------------------------------------------------------------------------------------------------|-------------|--------------------------------------------------------------------------------------|\n| [translate(text, sourceLanguage, targetLanguage)](#translate(String,String,String)) | `String` | Automatically translates some text from a source language to a destination language. |\n| [translate(text, sourceLanguage, targetLanguage, advancedArgs)](#translate(String,String,String,Object)) | `String` | Automatically translates some text from a source language to a destination language. |\n\nDetailed documentation\n----------------------\n\n### `translate(text, sourceLanguage, targetLanguage)`\n\nAutomatically translates some text from a source language to a destination language.\n\n```javascript\n// The code below will write \"Esta es una prueba\" to the log.\nconst spanish = LanguageApp.translate('This is a test', 'en', 'es');\nLogger.log(spanish);\n```\nA list of language codes is available [here](/translate/docs/languages).\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|------------------------------------------------------------------------------------------------------------------------------|\n| `text` | `String` | the text to translate |\n| `source``Language` | `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 |\n| `target``Language` | `String` | the language code to which the text should be translated |\n\n#### Return\n\n\n`String` --- the translated text\n\n*** ** * ** ***\n\n### `translate(text, sourceLanguage, targetLanguage, advancedArgs)`\n\nAutomatically translates some text from a source language to a destination language.\n\n```javascript\n// The code below will write \"Esta es una \u003cstrong\u003eprueba\u003c/strong\u003e\" to the log.\nconst spanish = LanguageApp.translate(\n 'This is a <strong>test</strong>',\n 'en',\n 'es',\n {contentType: 'html'},\n);\nLogger.log(spanish);\n```\nA list of language codes is available [here](/translate/docs/languages).\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|------------------------------------------------------------------------------------------------------------------------------|\n| `text` | `String` | the text to translate |\n| `source``Language` | `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 |\n| `target``Language` | `String` | the language code to which the text should be translated |\n| `advanced``Args` | `Object` | optional JavaScript object fields |\n\n#### Advanced parameters\n\n| Name | Type | Description |\n|-----------------|----------|--------------------------------------------------------------------------------|\n| `content``Type` | `String` | the content type of the text; supported values are 'text' (default) and 'html' |\n\n#### Return\n\n\n`String` --- the translated text"]]
