<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">On-premises or any cloud edition v1.15</button>

- [SAP BTP edition v1.1](https://docs.cloud.google.com/sap/docs/abap-sdk/btp/latest/quickstart-translation.md.txt)
- [On-premises or any cloud edition v1.15](https://docs.cloud.google.com/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/quickstart-translation.md.txt)

<br />

This quickstart shows you how
to create a program that translates text from English to German by using the
[Cloud Translation API v2](https://docs.cloud.google.com/translate/docs/basic/translating-text).

## Before you begin


Before you run this quickstart, make sure that you or your administrators have
completed the following prerequisites:

- You have a Google Cloud account and project.

- Billing is enabled for your project. [See how to confirm that billing is enabled for your project](https://docs.cloud.google.com/billing/docs/how-to/verify-billing-enabled.md.txt).

- 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](https://docs.cloud.google.com/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/install-config.md.txt).

<br />

- Authentication to access Google Cloud APIs is set up. [See how to set up authentication](https://docs.cloud.google.com/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/authentication.md.txt).

- Make sure the Cloud Translation API is enabled in your Google Cloud project.

  [Go to API library](https://console.cloud.google.com/project/_/apis/library/translate.googleapis.com)

## Create a program to translate text

1. In the SAP system, create an executable program in your
   custom namespace (for example, Z or Y) by using transaction `SE38`.

   1. In the SAP GUI, enter transaction code `SE38`.

   2. In the **Program** field, enter a name of your program,
      for example, `ZDEMO_TRANSLATE`.

   3. Click **Create**.

   4. Specify the program attributes:

      1. In the **Title** field, enter a title of your program,
         for example, `Translate from English to German`.

      2. In the **Type** field, choose `Executable Program`.

      3. Click **Save**.

   5. Save the program as a **Local Object**.

   6. 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.
2. 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'
   ```

   <br />

## What's next


- Explore other quickstarts available on the GitHub repository, [GoogleCloudPlatform/google-cloud-abap/abap-sdk
  /ZGOOG_SDK_QUICKSTART/](https://github.com/GoogleCloudPlatform/google-cloud-abap/tree/main/abap-sdk/ZGOOG_SDK_QUICKSTART).
- Read the guide [Application development with the on-premises or any cloud edition of ABAP SDK for Google Cloud](https://docs.cloud.google.com/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/developer.md.txt).
- View the [code samples](https://docs.cloud.google.com/sap/docs/abap-sdk/samples/all-samples.md.txt#on-premises-or-any-cloud-edition).
- 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).

<br />