This code sample can be used to translate one or more files of supported types in a Cloud Storage bucket and store the translated file into a target Cloud Storage bucket. For batch translations, the service account must have additional permissions to access Cloud Storage buckets along with the permissions to perform translation. For more information, see Translate documents.
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_doc_in_batch DEFINITION
PUBLIC FINAL
CREATE PUBLIC.
PUBLIC SECTION.
INTERFACES if_oo_adt_classrun.
ENDCLASS.
CLASS ZCL_CS_TRANSLATE_DOC_IN_BATCH 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_003.
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, replace it with actual value.
lv_p_locations_id = 'us-central1'.
" TODO: Provide values for source and target cloud storage buckets
"lv_input_uri =
"lv_output_uri =
"Values passed for source language code and target language codes are examples.
"Replace them with actual values.
ls_input = VALUE #(
source_language_code = 'en-US'
target_language_codes = VALUE #( ( `es-ES` )
( `fr-FR` ) )
input_configs = VALUE #( ( gcs_source = VALUE #( input_uri = lv_input_uri ) ) )
output_config = VALUE #(
gcs_destination = VALUE #( output_uri_prefix = lv_output_uri ) ) ).
" Call the API
lo_translate->batch_translate_document_lo( 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_document_lo.
"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,
ls_input TYPE /goog/cl_translation_v3=>ty_003,
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'.
"Passing two target language codes (BCP-47 codes)
"TODO: Provide source and target cloud storage buckets, these follow the pattern: gs://<bucket_name>
"lv_input_uri =
"lv_output_uri =
"Values passed for source language code and target language codes are example, replace them with actual values.
ls_input = VALUE #( source_language_code = 'en-US'
target_language_codes = VALUE #( ( `es-ES` )
( `fr-FR` ) )
input_configs = VALUE #( ( gcs_source =
VALUE #( input_uri = lv_input_uri ) ) )
output_config = VALUE #( gcs_destination =
VALUE #( output_uri_prefix = lv_output_uri ) )
).
"Call the API
CALL METHOD lo_translate->batch_translate_document_lo
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.