This code sample can be used to translate text in batch mode. Make sure that you have completed the following steps:
- Store your text file in a source Cloud Storage bucket.
- Create a target Cloud Storage bucket to store the translated text files.
- Grant the service accounts access to Cloud Storage buckets, in addition to Cloud Translation permissions.
For a comprehensive collection of code samples for the SAP BTP edition of ABAP SDK for Google Cloud, see the code sample repository on GitHub.
For a comprehensive collection of code samples for the on-premises or any cloud edition of ABAP SDK for Google Cloud, see the code samples repository on GitHub.
Code sample
SAP BTP edition
" --------------------------------------------------------------------
" Copyright 2024 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. -
" --------------------------------------------------------------------
CLASS zcl_cs_translate_batch_mode DEFINITION
PUBLIC FINAL
CREATE PUBLIC.
PUBLIC SECTION.
INTERFACES if_oo_adt_classrun.
ENDCLASS.
CLASS ZCL_CS_TRANSLATE_BATCH_MODE IMPLEMENTATION.
METHOD if_oo_adt_classrun~main.
" Data Declarations
DATA lv_p_projects_id TYPE string.
DATA lv_p_locations_id TYPE string.
DATA lv_input_uri TYPE string.
DATA lv_output_uri TYPE string.
DATA ls_input TYPE /goog/cl_translation_v3=>ty_004.
DATA ls_ip_cnf TYPE /goog/cl_translation_v3=>ty_029.
DATA lt_ip_cnf TYPE /goog/cl_translation_v3=>ty_t_029.
DATA ls_op_cnf TYPE /goog/cl_translation_v3=>ty_043.
DATA lv_folder TYPE string.
TRY.
" Open HTTP Connection
" Pass the configured client key, TRANSLATE_DEMO is used as example, replace it with actual value
DATA(lo_translate) = NEW /goog/cl_translation_v3( iv_key_name = 'TRANSLATE_DEMO' ).
" Populate the data that needs to be passed to the API
" Derive project id
lv_p_projects_id = lo_translate->gv_project_id.
" Pass location id, us-central1 is used as an example, repalce it with actual value
lv_p_locations_id = 'us-central1'.
"TODO: Provide storage bucket paths for uri values
"For source provide the complete file path including storage bucket, for target provide the storage bucket name
"lv_input_uri =
"lv_output_uri =
"The values passed below for mime_type, source and target language codes are as examples.
"Replace them with actual values
ls_input = VALUE #( input_configs = VALUE #(
( gcs_source = VALUE #( input_uri = lv_input_uri )
mime_type = 'text/plain' ) )
output_config = VALUE #(
gcs_destination = VALUE #( output_uri_prefix = lv_output_uri ) )
source_language_code = `en`
target_language_codes = VALUE #( ( `es` ) ) ).
" Call the API
lo_translate->batch_translate_text_locati( EXPORTING iv_p_projects_id = lv_p_projects_id
iv_p_locations_id = lv_p_locations_id
is_input = ls_input
IMPORTING es_output = DATA(ls_output)
ev_ret_code = DATA(lv_ret_code)
ev_err_text = DATA(lv_err_text)
es_err_resp = DATA(ls_err_resp) ).
IF /goog/cl_http_client=>is_success( lv_ret_code ).
" This returns a long running operation id as glossary creation is adhoc
" You can use the LRO ID to poll and check the status of the operation
out->write( |LRO ID: { ls_output-name }| ).
ELSE.
out->write( | Error occurred: { lv_err_text }| ).
ENDIF.
" Close HTTP Connection
lo_translate->close( ).
CATCH /goog/cx_sdk INTO DATA(lo_sdk_excp).
lv_err_text = lo_sdk_excp->get_text( ).
out->write( |Exception occurred: { lv_err_text } | ).
ENDTRY.
ENDMETHOD.
ENDCLASS.
On-premises or any cloud edition
**********************************************************************
* 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_batch_translate_text_locati.
"Data Declarations
DATA:
lv_p_projects_id TYPE string,
lv_p_locations_id TYPE string,
lv_input_uri TYPE string,
lv_output_uri TYPE string,
lv_folder TYPE string,
ls_input TYPE /goog/cl_translation_v3=>ty_004,
ls_op_cnf TYPE /goog/cl_translation_v3=>ty_043,
ls_ip_cnf TYPE /goog/cl_translation_v3=>ty_029,
lt_ip_cnf TYPE /goog/cl_translation_v3=>ty_t_029,
lo_exception TYPE REF TO /goog/cx_sdk.
TRY.
"Open HTTP Connection
"Pass the configured client key - TRANSLATE_DEMO is used an example, replace it with actual value.
DATA(lo_translate) = NEW /goog/cl_translation_v3( iv_key_name = 'TRANSLATE_DEMO' ).
"Populate the data that needs to be passed to the api
"Derive project id
lv_p_projects_id = lo_translate->gv_project_id.
"Pass location id, us-central1 is used as an example, replace it with actual value.
lv_p_locations_id = 'us-central1'.
"TODO: Provide storage bucket paths for uri values
"For source provide the complete file path including storage bucket, for target provide the storage bucket name
"lv_input_uri =
"lv_output_uri =
ls_input = VALUE #( input_configs =
VALUE #( ( gcs_source = VALUE #( input_uri = lv_input_uri )
mime_type = 'text/plain' ) )
output_config =
VALUE #( gcs_destination = VALUE #( output_uri_prefix = lv_output_uri ) )
source_language_code = `en`
target_language_codes =
VALUE #( ( `es` ) )
).
"Call the API
CALL METHOD lo_translate->batch_translate_text_locati
EXPORTING
iv_p_projects_id = lv_p_projects_id
iv_p_locations_id = lv_p_locations_id
is_input = ls_input
IMPORTING
es_output = DATA(ls_output)
ev_ret_code = DATA(lv_ret_code)
ev_err_text = DATA(lv_err_text)
es_err_resp = DATA(ls_err_resp).
IF /goog/cl_http_client=>is_success( lv_ret_code ).
"This returns a long running operation id for the job that is scheduled for glossary creation
"You can use the LRO ID to poll and check the status of the operation
WRITE: 'LRO ID:', ls_output-name.
ELSE.
MESSAGE lv_err_text TYPE 'E'.
ENDIF.
"Close HTTP Connection
lo_translate->close( ).
CATCH /goog/cx_sdk INTO lo_exception.
lv_err_text = lo_exception->get_text( ).
ENDTRY.