このページは Cloud Translation API によって翻訳されました。

ABAP SDK for Google Cloud での Translation API の使用

1. はじめに

この Codelab では、ABAP SDK for Google Cloud を使用して Translation API V3（Advanced）のメソッドを呼び出す手順を説明します。この Codelab では、Translation API V3 を使用してテキストを翻訳する方法、テキストの言語を検出する方法、サポートされている言語を一覧表示する方法について学習します

この Codelab では、次の Google Cloud サービスを使用します。

Compute Engine
ネットワークサービス
Cloud Shell
Cloud Translation API V3

前提条件

ABAP SDK for Google Cloud がインストールされている SAP システムにアクセスできることを確認します。
詳しくは、Codelab「Install ABAP Platform Trial 1909 on Google Cloud Platform and Install ABAP SDK」必要ありません。

作成するアプリの概要

ABAP SDK for Google Cloud を使用して、SAP システムで次のプログラムを作成します。

Google の Cloud Translation API V3 を使用してテキストを複数の言語に翻訳する
Google Cloud Translation API V3 を使用して原文テキストの言語を検出する
Google Cloud Translation API V3 でサポートされている言語のリスト

2. 要件

ブラウザ（Chrome、Firefox など）
課金が有効になっている Google Cloud プロジェクト、または Google Cloud Platform の 90 日間無料トライアルアカウントを作成する。
システムにインストール済みの SAP GUI（Windows または Java）。マシンに SAP GUI がすでにインストールされている場合は、VM の外部 IP アドレスをアプリケーションサーバーの IP として使用して SAP に接続します。Mac を使用している場合は、こちらのリンクから入手できる SAP GUI for Java をインストールすることもできます。

3. 始める前に

ABAP SDK for Google Cloud がインストールされている SAP システムにアクセスできることを確認します。
詳しくは、Codelab「Install ABAP Platform Trial 1909 on Google Cloud Platform and Install ABAP SDK」必要ありません。
Google Cloud コンソールのプロジェクトセレクタページで、Google Cloud プロジェクト（例: abap-sdk-poc).）を選択または作成します。
Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。90 日間無料トライアルアカウントを使用している場合は、この手順をスキップしてください。
ここでは、Google Cloud で動作するコマンドライン環境である Cloud Shell を使用します。Cloud コンソールで、右上にある [Cloud Shell をアクティブにする] をクリックします。

次のコマンドを実行して、アカウントを認証し、デフォルトプロジェクトを abap-sdk-poc に設定します。ゾーン us-west4-b は例として使用されています。必要に応じて、次のコマンドでプロジェクトとゾーンを必要に応じて変更してください。

gcloud auth login
gcloud config set project abap-sdk-poc
gcloud config set compute/zone us-west4-b

ABAP SDK for Google Cloud がインストールされている SAP システムにアクセスできる必要があります。
この Codelab に進む前に、Codelab 1（ABAP Platform Trial 1909 を Google Cloud Platform にインストールして ABAP SDK for Google Cloud をインストールする）と Codelab 2（Compute Engine VM で SAP Hosted のトークンを使用して ABAP SDK 認証を構成する）を完了する必要があります。
Codelab 1 と Codelab 2 を完了している場合は、認証と接続に必要な設定とともに、Google Cloud 上の ABAP Platform Trial 1909 System がプロビジョニングされています。
Codelab 1 と Codelab 2 を完了していない場合、この Codelab で提供するステップを実行するために必要なインフラストラクチャと接続がすべて揃っているわけではありません。したがって、この Codelab を先に進める前に、Codelab 1 と Codelab 2 を完了する必要があります。

4. Google Cloud プロジェクトで Cloud Translation API V3 を有効にする

Cloud Shell で以下のコマンドを実行します。これにより、Google Cloud プロジェクトで Cloud Translation API が有効になります。

gcloud services enable translate.googleapis.com

正常に実行されると、次のようなメッセージが表示されます。

これで、Google Cloud プロジェクトで Cloud Translation API が有効になりました。

5. Cloud Translation ユーザーロールを持つサービスアカウントを作成する

必要なロールを持つサービスアカウントを作成するには、次の操作を行います。

Cloud Shell ターミナルで次のコマンドを実行します。

gcloud iam service-accounts create abap-sdk-translation-tester \
--display-name="Service Account for Translation"

上記の手順で作成したサービスアカウントに必要なロールを追加します。

gcloud projects add-iam-policy-binding abap-sdk-poc\
--member='serviceAccount:abap-sdk-translation-tester@abap-sdk-poc.iam.gserviceaccount.com' \
--role='roles/cloudtranslate.user'

上記のコマンドでは、Google Cloud プロジェクトのテンプレート名として abap-sdk-poc を使用しています。実際のプロジェクト ID に置き換えてください。

ロールが追加されたことを確認するには、[IAM] ページに移動します。以下のように、作成したサービスアカウントとそれに割り当てられたロールが表示されます。

6. クライアントキー構成の作成

Google Cloud 側で前提条件を設定したので、SAP 側で構成を進めることができます。

認証と接続に関連する構成の場合、ABAP SDK for Google Cloud はテーブル /GOOG/CLIENT_KEY を使用します。

テーブル /GOOG/CLIENT_KEY テーブルの構成を維持するには、次の操作を行います。

SAP GUI で、トランザクションコード SPRO を入力します。
[SAP 参照 IMG] をクリックします。
[ABAP SDK for Google Cloud] >基本設定 >クライアントキーを構成する。
各フィールドの以下の値を維持します。

項目	値
Google Cloud キー名	TEST_TRANSLATION
Google Cloud サービスアカウント名	`abap-sdk-translation-tester@abap-sdk-poc.iam.gserviceaccount.com`
Google Cloud のスコープ	`https://www.googleapis.com/auth/cloud-platform`
プロジェクト ID	abap-sdk-poc
認可クラス	`/GOOG/CL_AUTH_GOOGLE`

その他の項目はすべて空白のままにする

7. Cloud Translation API V3 を呼び出してテキストを翻訳する Z-Report を作成する

SAP システムにログインします。
トランザクションコード SE38 に移動し、ZDEMO_TRANSLATE_TEXT. という名前のレポートプログラムを作成します。
表示されたポップアップで、以下のように詳細を入力して [Save] をクリックします。

次のポップアップで、[Local Object] または [パッケージ名を指定] を選択します。

ABAP エディタで、次のコードを追加します。

DATA lo_translate TYPE REF TO /goog/cl_translation_v3.
DATA ls_input TYPE /goog/cl_translation_v3=>ty_050.

TRY.
    lo_translate = NEW #( iv_key_name = 'TEST_TRANSLATION').

    ls_input = VALUE #(  mime_type = 'text/plain'
                         source_language_code = 'en-US'
                         target_language_code = 'es-ES'
                         contents =  VALUE #( ( |Sun is our nearest star| ) ) ).

    lo_translate->translate_text_projects(
      EXPORTING
        iv_p_projects_id = CONV #( lo_translate->gv_project_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(lv_err_resp)
    ).
    IF lo_translate->is_success( lv_ret_code ) = abap_true.
      cl_demo_output=>new(
      )->begin_section( 'API Call Successful:'
      )->write_text( 'Translated Text:'
      )->write_data( ls_output-translations[ 1 ]-translated_text
      )->display( ).
    ELSE.
      cl_demo_output=>new(
      )->begin_section( 'API Call Unsuccessful:'
      )->write_text( 'Error Message:'
      )->write_text( lv_err_text
      )->display( ).
    ENDIF.
  CATCH /goog/cx_sdk INTO DATA(lo_sdk_excp).
    DATA(lv_error) = lo_sdk_excp->get_text( ).
    cl_demo_output=>new(
     )->begin_section( 'Exception Occured:'
     )->write_text( lv_error
     )->display( ).
ENDTRY.

レポートを保存して有効にします。
レポートを実行します（F8）。

正常に実行されると、次のようなレポート出力が表示されます。

8. Cloud Translation API V3 を呼び出して言語を検出する Z-Report を作成する

SAP システムにログインします。
トランザクションコード SE38 に移動し、ZDEMO_DETECT_LANGUAGE. という名前のレポートプログラムを作成します。
表示されたポップアップで、以下のように詳細を入力して [Save] をクリックします。

次のポップアップで、[Local Object] または [パッケージ名を指定] を選択します。

ABAP エディタで、次のコードを追加します。

DATA lo_translate TYPE REF TO /goog/cl_translation_v3.
DATA ls_input TYPE /goog/cl_translation_v3=>ty_009.

TRY.
    lo_translate = NEW #( iv_key_name = 'TEST_TRANSLATION').

    ls_input = VALUE #(  mime_type = |text/plain|
                         content =  |La luce viaggia più veloce del suono| ).

    lo_translate->detect_language_projects(
      EXPORTING
        iv_p_projects_id = CONV #( lo_translate->gv_project_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(lv_err_resp)
    ).
    IF lo_translate->is_success( lv_ret_code ) = abap_true.
      cl_demo_output=>new(
      )->begin_section( 'API Call Successful:'
      )->write_text( 'Detected Language:'
      )->write_data( ls_output-languages[ 1 ]-language_code
      )->display( ).
    ELSE.
      cl_demo_output=>new(
      )->begin_section( 'API Call Unsuccessful:'
      )->write_text( 'Error Message:'
      )->write_text( lv_err_text
      )->display( ).
    ENDIF.
  CATCH /goog/cx_sdk INTO DATA(lo_sdk_excp).
    DATA(lv_error) = lo_sdk_excp->get_text( ).
    cl_demo_output=>new(
     )->begin_section( 'Exception Occured:'
     )->write_text( lv_error
     )->display( ).
ENDTRY.

レポートを保存して有効にします。
レポートを実行します（F8）。

正常に実行されると、次のようなレポート出力が表示されます。

9. GET_SUPPORTED_LANGUAGES メソッドを呼び出す Z レポートを作成する

SAP システムにログインする
トランザクションコード SE38 に移動し、ZDEMO_GET_LANGUAGES. という名前のレポートプログラムを作成します。
表示されたポップアップで、下記のように詳細情報を入力して [Save] をクリックします。

次のポップアップで、[Local Object] または [パッケージ名を指定] を選択します。

ABAP エディタで、次のコードを追加します。

DATA lo_translate TYPE REF TO /goog/cl_translation_v3.

TRY.
    lo_translate = NEW #( iv_key_name = 'TEST_TRANSLATION').

    lo_translate->get_supported_languages_pro(
      EXPORTING
        iv_q_displaylanguagecode = 'en-US'
        iv_p_projects_id         =  CONV #( lo_translate->gv_project_id )
      IMPORTING
        es_output        =  DATA(ls_output)
        ev_ret_code      =  DATA(lv_ret_code)
        ev_err_text      =  DATA(lv_err_text)
        es_err_resp      =  DATA(lv_err_resp)
    ).

    IF lo_translate->is_success( lv_ret_code ) = abap_true.
      cl_demo_output=>new(
      )->begin_section( 'API Call Successful:'
      )->write_text( 'Supported Languages:'
      )->write_data( ls_output-languages
      )->display( ).
    ELSE.
      cl_demo_output=>new(
      )->begin_section( 'API Call Unsuccessful:'
      )->write_text( 'Error Message:'
      )->write_text( lv_err_text
      )->display( ).
    ENDIF.
  CATCH /goog/cx_sdk INTO DATA(lo_sdk_excp).
    DATA(lv_error) = lo_sdk_excp->get_text( ).
    cl_demo_output=>new(
     )->begin_section( 'Exception Occured:'
     )->write_text( lv_error
     )->display( ).
ENDTRY.

レポートを保存して有効にします。
レポートを実行します（F8）。

正常に実行されると、次のようなレポート出力が表示されます。

10.完了

これで、「ABAP SDK for Google Cloud で Translation API を使用する」を完了しました説明します

Cloud Translation API V3（別名 Cloud Translation API Advanced）には、次のような多くの機能があります。

カスタムモデルを使用した翻訳
用語集を使用して翻訳する
文字変換のサポート
Document Translation

次の Codelab に進み、ABAP SDK for Google Cloud を使用してさまざまな Google Cloud サービスにアクセスする方法を学習します。

Pub/Sub にイベントを送信する
Cloud Pub/Sub からイベントを受信する
チャンクを使用して Cloud Storage バケットに大きなオブジェクトをアップロードする
DLP API を使用して個人情報（PII）の秘匿化を行う
ABAP から BigQuery ML を呼び出す

11. クリーンアップ

ABAP SDK for Google Cloud に関連する追加の Codelab の続行を希望されない場合は、クリーンアップに進んでください。

プロジェクトの削除

注意: プロジェクトを削除すると、次のような影響があります。

プロジェクト内のすべてのものが削除されます。このドキュメントのタスクで既存のプロジェクトを使用した場合、それを削除すると、そのプロジェクトで行った他の作業もすべて削除されます。
カスタムプロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタムプロジェクト ID を作成した可能性があります。appspot.com URL など、プロジェクト ID を使用する URL を保持するには、プロジェクト全体を削除するのではなく、プロジェクト内の選択したリソースを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て上限を超えないようにすることができます。

Google Cloud プロジェクトを削除します。

gcloud projects delete abap-sdk-poc

リソースを個別に削除する

Compute インスタンスを削除します。

gcloud compute instances delete abap-trial-docker

ファイアウォールルールを削除します。

gcloud compute firewall-rules delete sapmachine

サービスアカウントを削除します。

gcloud iam service-accounts delete \
    abap-sdk-dev@abap-sdk-poc.iam.gserviceaccount.com

ABAP SDK for Google Cloud での Translation API の使用

1. はじめに

前提条件

作成するアプリの概要

2. 要件

3. 始める前に

4. Google Cloud プロジェクトで Cloud Translation API V3 を有効にする

5. Cloud Translation ユーザーロールを持つサービス アカウントを作成する

6. クライアント キー構成の作成

7. Cloud Translation API V3 を呼び出してテキストを翻訳する Z-Report を作成する

8. Cloud Translation API V3 を呼び出して言語を検出する Z-Report を作成する

9. GET_SUPPORTED_LANGUAGES メソッドを呼び出す Z レポートを作成する

10.完了

11. クリーンアップ

プロジェクトの削除

リソースを個別に削除する

5. Cloud Translation ユーザーロールを持つサービスアカウントを作成する

6. クライアントキー構成の作成