翻訳プロジェクトを設定する

Google Distributed Cloud(GDC)エアギャップ アプライアンスの Vertex AI Translation を使用すると、アプリケーションでサポートされている言語間でテキストとドキュメントを翻訳できます。プロジェクトを作成してデベロッパー ロールをリクエストしたら、GDC コンソールで Vertex AI Translation API を有効にして、ステータスとエンドポイントを表示します。その後、Python クライアント ライブラリをインストールし、環境変数を定義して、gdcloud CLI を使用してサービス アカウントを構成し、リクエストを認証できます。Vertex AI を初めて使用する場合は、翻訳機能についてをご覧ください。

プロジェクトを作成する

翻訳プロジェクトを作成すると、共同編集者、有効な API、認証情報、アクセス制御などの Vertex AI Translation リソースが整理されます。

プロジェクトを作成するには、Vertex AI 用にプロジェクトを設定するをご覧ください。API 呼び出しを行うには、プロジェクト ID が必要です。

デベロッパー権限をリクエストする

翻訳サービスにアクセスし、リクエストの認証と認可用の API トークンを生成するには、プロジェクトに AI Translation デベロッパーのロールが必要です。

プロジェクトの IAM 管理者に、プロジェクトの名前空間内のユーザーまたはサービス アカウントに AI Translation デベロッパー(ai-translation-developer)ロールを付与するよう依頼します。このロールの詳細については、IAM 権限を準備するをご覧ください。

Vertex AI Translation API を有効にする

プロジェクトで Vertex AI Translation の事前トレーニング済み API を有効にする必要があります。有効にすると、Vertex AI Translation 事前トレーニング済み API のサービス ステータスとエンドポイントを表示できます。

クライアント ライブラリのインストール

クライアント ライブラリは、Python プログラミング言語で利用できます。こうしたクライアント ライブラリを使用して Vertex AI Translation API を呼び出すと、API へのアクセスが容易になるため、ライブラリの使用をおすすめします。

Vertex AI Translation クライアント ライブラリをインストールし、次の手順に沿って正しいバージョンがインストールされていることを確認します。

  1. Vertex AI Translation クライアント ライブラリがインストールされているかどうかを確認し、バージョン番号を取得します。

    pip freeze | grep translation
    

    クライアント ライブラリがすでにインストールされている場合は、次のような出力が表示されます。

    google-cloud-translation==3.8.0
    

    取得したバージョン番号は、次のエンドポイントのクライアント ライブラリと一致している必要があります。

    https://GDC_URL/.well-known/static/client-libraries
    

    GDC_URL は、GDC の組織の URL に置き換えます。

  2. バージョン番号が一致しない場合は、クライアント ライブラリをアンインストールします。

    pip uninstall google-cloud-translation
    
  3. Vertex AI Translation クライアント ライブラリをアンインストールした場合は、オペレーティング システムに対応するファイル名を指定して再インストールする必要があります。

環境変数を設定する

Vertex AI Translation クライアント ライブラリをインストールすると、Python スクリプトから API を操作できます。

プロジェクトでサービス アカウントを設定して、承認済みの API 呼び出しをプログラムで行う場合は、Python スクリプトで環境変数を定義して、実行時にサービス アカウント キーなどの値にアクセスできます。

Python スクリプトで必要な環境変数を設定する手順は次のとおりです。

  1. Python スクリプトを作成します。

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

    import os
    
    os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
    

    APPLICATION_DEFAULT_CREDENTIALS_FILENAME は、プロジェクトで作成したサービス アカウント キーを含む JSON ファイルの名前(my-service-key.json など)に置き換えます。

  3. Python スクリプトを translation.py などの名前で保存します。

  4. Python スクリプトを実行して環境変数を設定します。

    python SCRIPT_NAME
    

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

認証を設定する

Vertex AI Translation API の使用を開始する前に、クライアント認証情報を認証し、プロジェクト リソースへのアカウント アクセスをリクエストする必要があります。詳細については、API リクエストを認証するをご覧ください。