Class LanguageApp
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اللغةالتطبيق
توفّر خدمة "اللغة" للنصوص البرمجية طريقةً لاحتساب الترجمات التلقائية للنص.
// 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);
مستندات تفصيلية
translate(text, sourceLanguage, targetLanguage)
لترجمة بعض النصوص تلقائيًا من لغة مصدر إلى لغة وجهة
// 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);
تتوفّر قائمة برموز اللغات
هنا.
المعلمات
الاسم | النوع | الوصف |
text | String | النص المطلوب ترجمته |
sourceLanguage | String | رمز اللغة التي كُتب بها النص في حال ضبطه على السلسلة الفارغة
، سيتم رصد رمز اللغة المصدر تلقائيًا. |
targetLanguage | String | رمز اللغة التي يجب ترجمة النص إليها |
الإرجاع
String
— النص المترجَم
translate(text, sourceLanguage, targetLanguage, advancedArgs)
لترجمة بعض النصوص تلقائيًا من لغة مصدر إلى لغة وجهة
// 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);
تتوفّر قائمة برموز اللغات
هنا.
المعلمات
الاسم | النوع | الوصف |
text | String | النص المطلوب ترجمته |
sourceLanguage | String | رمز اللغة التي كُتب بها النص في حال ضبطه على السلسلة الفارغة
، سيتم رصد رمز اللغة المصدر تلقائيًا. |
targetLanguage | String | رمز اللغة التي يجب ترجمة النص إليها |
advancedArgs | Object | حقول كائن JavaScript الاختيارية |
المعلمات المتقدمة
الاسم | النوع | الوصف |
contentType | String | نوع محتوى النص، والقيم المسموح بها هي 'text'
(التلقائية) و 'html' |
الإرجاع
String
— النص المترجَم
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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"]]