テキスト翻訳

Google Distributed Cloud(GDC)エアギャップ アプライアンスの Vertex AI Translation サービスを使用すると、サポートされている言語間で書式なしテキストと HTML を翻訳できます。Vertex AI Translation API にリクエストを送信するには、curl または Python クライアント ライブラリを使用します。この API には、ソース言語を検出して、サポートされている言語を一覧表示するメソッドも用意されています。

始める前に

Vertex AI Translation API を使用するには、Vertex AI Translation API が有効になっているプロジェクトと適切な認証情報が必要です。また、この API の呼び出しを支援するクライアント ライブラリをインストールすることもできます。詳細については、変換プロジェクトを設定するをご覧ください。

テキストを翻訳する

translateText メソッドは、特定の言語の入力テキストを受け取り、別の言語に翻訳されたテキストを返します。入力としてプレーン テキストまたは HTML テキストを入力できます。

HTML テキストを入力すると、translateText メソッドは HTML タグを翻訳せずに、HTML タグ間のテキストのみを翻訳します。ただし、alt 属性などの HTML5 タグの属性は翻訳されます。HTML5 のタグと属性を使用する例は、テキストを翻訳から除外する構文で使用されています。出力では、未翻訳の HTML タグが保持され、タグの間に翻訳されたテキストが含まれます。

Vertex AI Translation の事前トレーニング済み API に curl リクエストを送信します。それ以外の場合は、Python スクリプトから Vertex AI Translation の事前トレーニング済み API を操作して、テキストをある言語から別の言語に翻訳します。

次の例は、入力テキストをある言語から別の言語に翻訳する方法を示しています。

curl

curl リクエストを送信する手順は次のとおりです。

  1. 認証トークンを取得します。

  2. 次のリクエストを行います。

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"parent": "projects/PROJECT_ID", "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": ["INPUT_TEXT"]}'

次のように置き換えます。

mime_type フィールドを使用して、ファイルの種類を指定します。mime_type フィールドを次のいずれかの値に設定します。

  • text/plain: 入力は書式なしテキストです。
  • text/html: 入力は HTML テキストです。

mime_type フィールドが空の場合、デフォルト値は text/html です。

次の例では、mime_type フィールドを使用します。

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"mime_type": "text/html", "parent": "projects/PROJECT_ID", "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": ["INPUT_TEXT"]}'

出力では、翻訳されたテキストが返されます。

Python

Python スクリプトから Vertex AI Translation サービスを使用する手順は次のとおりです。

  1. 最新バージョンの Vertex AI Translation クライアント ライブラリをインストールします。

  2. Python スクリプトで必要な環境変数を設定する。

  3. API リクエストを認証する。

  4. 作成した Python スクリプトに次のコードを追加します。

    from google.cloud import translate
    import google.auth
    from google.auth.transport import requests
    from google.api_core.client_options import ClientOptions
    
    audience = "https://ENDPOINT:443"
    api_endpoint="ENDPOINT:443"
    
    def translate_client(creds):
      opts = ClientOptions(api_endpoint=api_endpoint)
      return translate.TranslationServiceClient(credentials=creds, client_options=opts)
    
    def main():
      creds = None
      try:
        creds, project_id = google.auth.default()
        creds = creds.with_gdch_audience(audience)
        req = requests.Request()
        creds.refresh(req)
      except Exception as e:
        print("Caught exception" + str(e))
        raise e
      return creds
    
    def translate_func(creds):
      tc = translate_client(creds)
      req = {
        "parent": "projects/PROJECT_ID",
        "source_language_code": "SOURCE_LANGUAGE",
        "target_language_code": "TARGET_LANGUAGE",
        "mime_type": "text/plain",
        "contents": ["INPUT_TEXT"]
      }
    
      resp = tc.translate_text(req)
      print(resp)
    
    if __name__=="__main__":
      creds = main()
      translate_func(creds)
    

    次のように置き換えます。

    mime_type フィールドを使用して、ファイルの種類を指定します。mime_type フィールドを次のいずれかの値に設定します。

    • text/plain: 入力は書式なしテキストです。
    • text/html: 入力は HTML テキストです。

    mime_type フィールドが空の場合、デフォルト値は text/html です。

  5. Python スクリプトを保存します。

  6. Python スクリプトを実行してテキストを翻訳します。

    python SCRIPT_NAME
    

    SCRIPT_NAME は、Python スクリプトに付けた名前(translation.py など)に置き換えます。

翻訳からテキストを除外する

リクエストの contents フィールドで次のいずれかの HTML タグを使用して、テキストの一部を翻訳から除外します。

  • <span translate="no">"TEXT"</span>
  • <span class="notranslate">"TEXT"</span>

TEXT は、翻訳から除外するテキスト部分に置き換えます。

たとえば、フランス語で次の入力テキストがあるとします。

Bonjour, c'est un test.

このテキストを英語に翻訳すると、次のようになります。

Hello, this is a test.

入力テキストから Bonjour, を除外し、テキストの次の部分のみを翻訳するとします。

c'est un test.

この部分のテキストは、英語では次のように翻訳されます。

this is a test.

HTML タグを使用して、テキストを翻訳から除外します。たとえば、次の curl リクエストでは、<span class="notranslate">"TEXT"</span> タグを使用して、テキストを英語に翻訳するときに、フランス語の前の入力テキストから Bonjour, を除外します。

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:translateText -d '{"parent": "projects/PROJECT_ID", "source_language_code": "fr", "target_language_code": "en", "contents": ["<span class=\"notranslate\">\"Bonjour,\"</span>\"c'est un test.\""]}'

言語を検出する

detectLanguage メソッドは、HTTP リクエストを送信してテキスト文字列の言語を返します。

たとえば、次のリクエストでは、入力テキスト Hello, this is a test から言語として英語を検出します。

curl

curl -vv -X POST -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID:detectLanguage -d '{"parent": "projects/PROJECT_ID", "content": "Hello, this is a test"}'

サポートされている言語を取得する

supportedLanguages メソッドは、Vertex AI Translation API でサポートされている言語のリストを返します。

たとえば、次のリクエストは、Vertex AI Translation エンドポイントを指定して、サポートされている言語を返します。

curl

curl -vv -X GET -H "Content-Type: application/json" -H "Authorization: Bearer TOKEN" https://ENDPOINT/v3/projects/PROJECT_ID/locations/PROJECT_ID/supportedLanguages

サポートされている言語の全一覧については、Vertex AI Translation でサポートされている言語をご覧ください。