此代码示例可用于使用 Google Cloud Cloud Translation API (v3) 创建术语表。
术语表是一种自定义字典,用于确保 Cloud Translation API (v3) 以一致的方式对业务特定领域的术语进行翻译。
确保术语表文件已就绪并上传到同一 Google Cloud 项目中的 Cloud Storage 存储桶。如需详细了解如何准备术语表文件,请参阅创建和使用术语表(高级版)。
如需查看 SAP BTP 版本的 ABAP SDK for Google Cloud 代码示例的全面集合,请参阅 GitHub 上的代码示例代码库。
如需查看本地或任何云版本的 ABAP SDK for Google Cloud 代码示例的全面集合,请参阅 GitHub 上的代码示例代码库。
代码示例
SAP BTP 版本
" --------------------------------------------------------------------
" 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_create_glossary DEFINITION
PUBLIC FINAL
CREATE PUBLIC.
PUBLIC SECTION.
INTERFACES if_oo_adt_classrun.
ENDCLASS.
CLASS zcl_cs_create_glossary IMPLEMENTATION.
METHOD if_oo_adt_classrun~main.
DATA lv_p_projects_id TYPE string.
DATA lv_p_locations_id TYPE string.
DATA ls_input TYPE /goog/cl_translation_v3=>ty_022.
TRY.
" Open HTTP Connection
" Pass the configured client key
DATA(lo_translate) = NEW /goog/cl_translation_v3( iv_key_name = 'TRANSLATE_DEMO' ).
" Derive project id from the object
lv_p_projects_id = lo_translate->gv_project_id.
" Set a location id, 'us-central1' is used as example
lv_p_locations_id = 'us-central1'.
" Pass a display name
ls_input-display_name = 'Finance Term Glossary EN to ES'.
" Source language in BCP-47 format
ls_input-language_pair-source_language_code = 'en-US'.
" Target language in BCP-47 format
ls_input-language_pair-target_language_code = 'es-ES'.
" Complete name of glossary has following format:
" projects/<PROJECT_ID>/locations/<LOCATION_ID>/glossaries/<GLOSSARY_ID>
CONCATENATE 'projects/'
lo_translate->gv_project_id
'/locations/us-central1/glossaries/'
'FI_GLOSSARY_EN_ES'
INTO ls_input-name.
" Pass the complete path of glossary file which is stored in GCS bucket
" Below example shows a file named: fi_glossary_data.tsv is stored in a GCS bucket named: glossary_repo
ls_input-input_config-gcs_source-input_uri = 'gs://glossary_repo/fi_glossary_data.tsv'.
" Call API method
lo_translate->create_glossaries( 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 to check the status of the operation (SUCCESS Or FAILURE)
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.
本地或任何云版本
**********************************************************************
* 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_create_glossaries.
DATA: lv_p_projects_id TYPE string,
lv_p_locations_id TYPE string,
ls_input TYPE /goog/cl_translation_v3=>ty_022.
TRY.
* Open HTTP Connection
DATA(lo_translate) = NEW /goog/cl_translation_v3( iv_key_name = 'TRANSLATE_DEMO' ). "Pass the configured client key
* Populate required parameters
lv_p_projects_id = lo_translate->gv_project_id. " Derive project id from the object
lv_p_locations_id = 'us-central1'. "Set a location id, 'us-central1' is used as example
ls_input-display_name = 'Finance Term Glossary EN to ES'. "Pass a display name
ls_input-language_pair-source_language_code = 'en-US'. "Source language in BCP-47 format
ls_input-language_pair-target_language_code = 'es-ES'. "Target language in BCP-47 format
* Complete name of glossary has following format:
* projects/<PROJECT_ID>/locations/<LOCATION_ID>/glossaries/<GLOSSARY_ID>
CONCATENATE 'projects/'
lo_translate->gv_project_id
'/locations/us-central1/glossaries/'
'FI_GLOSSARY_EN_ES'
INTO ls_input-name.
* Pass the complete path of glossary file which is stored in GCS bucket
* Below example shows a file named: fi_glossary_data.tsv is stored in a GCS bucket named: glossary_repo
ls_input-input_config-gcs_source-input_uri = 'gs://glossary_repo/fi_glossary_data.tsv'.
* Call API method
CALL METHOD lo_translate->create_glossaries
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 to check the status of the operation (SUCCESS Or FAILURE)
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 DATA(lo_exception).
MESSAGE lo_exception->get_text( ) TYPE 'E'.
ENDTRY.