In the SAP system, create an executable program in your
custom namespace (for example, Z or Y) by using transaction SE38.
In the SAP GUI, enter transaction code SE38.
In the Program field, enter a name of your program,
for example, ZDEMO_TRANSLATE.
Click Create.
Specify the program attributes:
In the Title field, enter a title of your program,
for example, Translate from English to German.
In the Type field, choose Executable Program.
Click Save.
Save the program as a Local Object.
In the ABAP Editor, add the following code:
**********************************************************************
* Copyright 2023 Google LLC *
* *
* Licensed under the Apache License, Version 2.0 (the "License"); *
* you may not use this file except in compliance with the License. *
* You may obtain a copy of the License at *
* https://www.apache.org/licenses/LICENSE-2.0 *
* Unless required by applicable law or agreed to in writing, *
* software distributed under the License is distributed on an *
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, *
* either express or implied. *
* See the License for the specific language governing permissions *
* and limitations under the License. *
**********************************************************************
REPORT zr_qs_translate_texts.
* data declarations
data: lv_text type string,
lv_msg type string,
lv_ret_code type i,
lv_err_text type string,
ls_err_resp type /goog/err_resp,
ls_input type /goog/cl_translation_v2=>ty_006,
ls_output type /goog/cl_translation_v2=>ty_007,
lt_translations type /goog/cl_translation_v2=>ty_translations,
ls_texts type /goog/cl_translation_v2=>ty_008,
lo_translate type ref to /goog/cl_translation_v2,
lo_exception type ref to /goog/cx_sdk.
TRY.
* instantiate api client stub
create object lo_translate
exporting
iv_key_name = 'DEMO_TRANSLATE'.
* pass the text to be translated to the required parameter
lv_text = 'The Earth is the third planet from the Sun'.
APPEND lv_text TO ls_input-q.
ls_input-format = 'text'.
ls_input-source = 'en'.
ls_input-target = 'de'.
* call the api method to translate text
call method lo_translate->translate_translations
exporting
is_input = ls_input
importing
es_output = ls_output
ev_ret_code = lv_ret_code
ev_err_text = lv_err_text
es_err_resp = ls_err_resp.
IF lo_translate->is_success( lv_ret_code ) = abap_true.
lt_translations = ls_output-data.
READ TABLE lt_translations-translations INTO ls_texts INDEX 1.
WRITE: / 'Translation Successful'.
WRITE: / 'Translated Text is: ', ls_texts-translated_text.
ENDIF.
* close the http connection
lo_translate->close( ).
CATCH /goog/cx_sdk INTO lo_exception.
* write code here to handle exceptions
endtry.
Replace DEMO_TRANSLATE with the client key name.
Run your application in SE38. If successful, the following output displays:
'Translation Successful'
'Translated Text is: Die Erde ist der dritte Planet von der Sonne'
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# Translate text\n\n\u003cbr /\u003e\n\nThis quickstart shows you how\nto create a program that translates text from English to German by using the\n[Cloud Translation API v2](/translate/docs/basic/translating-text).\n\nBefore you begin\n----------------\n\n\nBefore you run this quickstart, make sure that you or your administrators have\ncompleted the following prerequisites:\n\n- You have a Google Cloud account and project.\n\n- Billing is enabled for your project. [See how to confirm that billing is enabled for your project](/billing/docs/how-to/verify-billing-enabled).\n\n- The on-premises or any cloud edition of ABAP SDK for Google Cloud is installed and configured. [See how to install and configure the on-premises or any cloud edition of ABAP SDK for Google Cloud](/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/install-config).\n\n\u003cbr /\u003e\n\n- Authentication to access Google Cloud APIs is set up. [See how to set up authentication](/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/authentication).\n\n- Make sure the Cloud Translation API is enabled in your Google Cloud project.\n\n [Go to API library](https://console.cloud.google.com/project/_/apis/library/translate.googleapis.com)\n\nCreate a program to translate text\n----------------------------------\n\n1. In the SAP system, create an executable program in your\n custom namespace (for example, Z or Y) by using transaction `SE38`.\n\n 1. In the SAP GUI, enter transaction code `SE38`.\n\n 2. In the **Program** field, enter a name of your program,\n for example, `ZDEMO_TRANSLATE`.\n\n 3. Click **Create**.\n\n 4. Specify the program attributes:\n\n 1. In the **Title** field, enter a title of your program,\n for example, `Translate from English to German`.\n\n 2. In the **Type** field, choose `Executable Program`.\n\n 3. Click **Save**.\n\n 5. Save the program as a **Local Object**.\n\n 6. In the **ABAP Editor**, add the following code:\n\n **********************************************************************\n * Copyright 2023 Google LLC *\n * *\n * Licensed under the Apache License, Version 2.0 (the \"License\"); *\n * you may not use this file except in compliance with the License. *\n * You may obtain a copy of the License at *\n * https://www.apache.org/licenses/LICENSE-2.0 *\n * Unless required by applicable law or agreed to in writing, *\n * software distributed under the License is distributed on an *\n * \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, *\n * either express or implied. *\n * See the License for the specific language governing permissions *\n * and limitations under the License. *\n **********************************************************************\n\n REPORT zr_qs_translate_texts.\n\n * data declarations\n data: lv_text type string,\n lv_msg type string,\n lv_ret_code type i,\n lv_err_text type string,\n ls_err_resp type /goog/err_resp,\n ls_input type /goog/cl_translation_v2=\u003ety_006,\n ls_output type /goog/cl_translation_v2=\u003ety_007,\n lt_translations type /goog/cl_translation_v2=\u003ety_translations,\n ls_texts type /goog/cl_translation_v2=\u003ety_008,\n lo_translate type ref to /goog/cl_translation_v2,\n lo_exception type ref to /goog/cx_sdk.\n\n TRY.\n * instantiate api client stub\n create object lo_translate\n exporting\n iv_key_name = '\u003cvar translate=\"no\"\u003eDEMO_TRANSLATE\u003c/var\u003e'.\n\n * pass the text to be translated to the required parameter\n lv_text = 'The Earth is the third planet from the Sun'.\n APPEND lv_text TO ls_input-q.\n\n ls_input-format = 'text'.\n ls_input-source = 'en'.\n ls_input-target = 'de'.\n\n * call the api method to translate text\n call method lo_translate-\u003etranslate_translations\n exporting\n is_input = ls_input\n importing\n es_output = ls_output\n ev_ret_code = lv_ret_code\n ev_err_text = lv_err_text\n es_err_resp = ls_err_resp.\n IF lo_translate-\u003eis_success( lv_ret_code ) = abap_true.\n lt_translations = ls_output-data.\n READ TABLE lt_translations-translations INTO ls_texts INDEX 1.\n WRITE: / 'Translation Successful'.\n WRITE: / 'Translated Text is: ', ls_texts-translated_text.\n ENDIF.\n\n * close the http connection\n lo_translate-\u003eclose( ).\n\n CATCH /goog/cx_sdk INTO lo_exception.\n * write code here to handle exceptions\n endtry.\n\n Replace \u003cvar translate=\"no\"\u003eDEMO_TRANSLATE\u003c/var\u003e with the client key name.\n2. Run your application in `SE38`. If successful, the following output displays:\n\n ```\n 'Translation Successful'\n 'Translated Text is: Die Erde ist der dritte Planet von der Sonne'\n ```\n\n \u003cbr /\u003e\n\nWhat's next\n-----------\n\n\n- Explore other quickstarts available on the GitHub repository, [GoogleCloudPlatform/google-cloud-abap/abap-sdk\n /ZGOOG_SDK_QUICKSTART/](https://github.com/GoogleCloudPlatform/google-cloud-abap/tree/main/abap-sdk/ZGOOG_SDK_QUICKSTART).\n- Read the guide [Application development with the on-premises or any cloud edition of ABAP SDK for Google Cloud](/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/developer).\n- View the [code samples](/sap/docs/abap-sdk/samples/all-samples#on-premises-or-any-cloud-edition).\n- Ask your questions and discuss ABAP SDK for Google Cloud with the community on [Cloud Forums](https://discuss.google.dev/tags/c/google-cloud/14/abap-sdk).\n\n\u003cbr /\u003e"]]