Class LanguageApp

AI-generated Key Takeaways

• The Language service automatically translates text between languages using the translate() method.

• You can specify the source and target languages using language codes, with auto-detection available for the source language.

• The translate() method supports optional advanced arguments for handling different content types like HTML.

• A comprehensive list of supported language codes can be found in the documentation.

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);

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.
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 &lt;strong&gt;test&lt;/strong&gt;',
    '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