Class LanguageApp
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
App Linguagem
O serviço de linguagem oferece aos scripts uma maneira de calcular traduções automáticas de texto.
// 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);
Documentação detalhada
translate(text, sourceLanguage, targetLanguage)
Traduz automaticamente um texto de um idioma de origem para um idioma de destino.
// 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);
Confira uma lista de códigos de idioma
aqui.
Parâmetros
Nome | Tipo | Descrição |
text | String | o texto a ser traduzido |
sourceLanguage | String | o código do idioma em que o texto é escrito. Se ele for definido como a string vazia, o código do idioma de origem será detectado automaticamente. |
targetLanguage | String | o código do idioma para o qual o texto será traduzido |
Retornar
String
: o texto traduzido
translate(text, sourceLanguage, targetLanguage, advancedArgs)
Traduz automaticamente um texto de um idioma de origem para um idioma de destino.
// 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);
Confira uma lista de códigos de idioma
aqui.
Parâmetros
Nome | Tipo | Descrição |
text | String | o texto a ser traduzido |
sourceLanguage | String | o código do idioma em que o texto é escrito. Se ele for definido como a string vazia, o código do idioma de origem será detectado automaticamente. |
targetLanguage | String | o código do idioma para o qual o texto será traduzido |
advancedArgs | Object | campos de objeto JavaScript opcionais |
Parâmetros avançados
Nome | Tipo | Descrição |
contentType | String | o tipo de conteúdo do texto. Os valores aceitos são "text" (padrão) e "html". |
Retornar
String
: o texto traduzido
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 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"]]