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 リクエストを送信する手順は次のとおりです。
次のリクエストを行います。
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"]}'
次のように置き換えます。
TOKEN: 取得した認証トークン。ENDPOINT: 組織で使用する Vertex AI Translation エンドポイント。詳細については、サービス ステータスとエンドポイントを表示するをご覧ください。PROJECT_ID: プロジェクト ID。SOURCE_LANGUAGE: 入力テキストの言語コード。サポートされている言語とそれぞれの言語コードの一覧をご覧ください。TARGET_LANGUAGE: テキストの翻訳先の言語コード。サポートされている言語とそれぞれの言語コードの一覧をご覧ください。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 サービスを使用する手順は次のとおりです。
作成した 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)次のように置き換えます。
ENDPOINT: 組織で使用する Vertex AI Translation エンドポイント。詳細については、サービス ステータスとエンドポイントを表示するをご覧ください。PROJECT_ID: プロジェクト ID。SOURCE_LANGUAGE: 入力テキストの言語コード。サポートされている言語とそれぞれの言語コードの一覧をご覧ください。TARGET_LANGUAGE: テキストの翻訳先の言語コード。サポートされている言語とそれぞれの言語コードの一覧をご覧ください。INPUT_TEXT: ソース言語の入力テキスト。
mime_typeフィールドを使用して、ファイルの種類を指定します。mime_typeフィールドを次のいずれかの値に設定します。text/plain: 入力は書式なしテキストです。text/html: 入力は HTML テキストです。
mime_typeフィールドが空の場合、デフォルト値はtext/htmlです。Python スクリプトを保存します。
Python スクリプトを実行してテキストを翻訳します。
python SCRIPT_NAMESCRIPT_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 でサポートされている言語をご覧ください。