設定
Cloud Translation の使用を開始するには、Cloud Translation API が有効になっているプロジェクトと、認証済みの呼び出しを行うための認証情報が必要です。以下のセクションでは、Cloud Translation API への最初の呼び出しを行う前に設定を行う方法について説明します。
設定プロセスには、Google Cloud コンソールが含まれています。これは、Google Cloud でシステムのプロビジョニング、構成、管理、モニタリングに使用できるウェブ インターフェースです。Google Cloud コンソールを初めて使用する場合は、Cloud コンソールページで詳細をご確認ください。
始める前に
Cloud Translation には 2 つのエディション(Basic と Advanced)があります。どちらのエディションを使用するかを決めてください。使用するエディションにより、インストールするクライアント ライブラリのバージョンが決まります。
プロジェクトを作成または選択する
Google Cloud が提供するサービスを使用するには、プロジェクトを作成する必要があります。プロジェクトを使用して、すべての Google Cloud のリソースがまとめられます。プロジェクトは、共同編集者、有効化された API などのリソース、モニタリング ツール、お支払い情報、認証とアクセス制御で構成されます。1 つのプロジェクトを作成できるほか、複数のプロジェクトを作成してリソース階層内で Google Cloud リソースを構成することもできます。プロジェクトを作成する際は、プロジェクト ID をメモしてください。API 呼び出しを行うには、この ID が必要です。プロジェクトの詳細については、Resource Manager ドキュメントをご覧ください。
実験、テスト、本番環境のそれぞれに個別のプロジェクトを作成することをおすすめします。プロジェクトを作成したら、プロジェクト番号または ID を記録します。Cloud Translation API を呼び出すときは、プロジェクト番号(または ID)を指定する必要があります。
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
課金を有効にする
Cloud Translation を使用するには、課金を有効にする必要があります。Cloud Translation の料金の詳細については、料金ページをご覧ください。
請求先アカウントは、特定のリソースセットに対する支払いをだれが行うかの定義に使用され、1 つ以上のプロジェクトにリンクできます。プロジェクトの利用料金は、リンクされた請求先アカウントに請求されます。ほとんどの場合、プロジェクトの作成時に請求情報を構成します。詳細については、お支払いとご請求に関するドキュメントをご覧ください。
Google Cloud プロジェクトの課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
API の有効化
プロジェクトで Cloud Translation API を有効にする必要があります。API の有効化の詳細については、Service Usage のドキュメントをご覧ください。
Cloud Translation API を有効にします。
使用量の割り当ての設定
Cloud Translation には使用量の割り当て管理システムがあり、ユーザーと Google がサービスの使用量を管理しやすくなっています。デフォルトでは、1 日あたりに送信できる文字数に上限はありません。予算を設定している場合は、毎日の使用量をモニタリングし、計画された費用に基づいて割り当てを調整することをおすすめします。
割り当ての詳細については、割り当てと上限をご覧ください。
認証を設定する
Cloud Translation API を使用する場合は、認証を設定する必要があります。API を使用するクライアント アプリケーションはすべて、認証の対象であり、リクエストされるリソースへのアクセス権が付与されている必要があります。このセクションでは、認証の重要なコンセプトと設定手順について説明します。詳細については、Google Cloud 認証の概要をご覧ください。
サービス アカウントと秘密鍵
認証には複数のオプションがありますが、認証とアクセス制御にサービス アカウントを使用することをおすすめします。サービス アカウントでは、エンドユーザーではなく、アプリケーションの資格情報が提供されます。サービス アカウントはプロジェクトで所有されます。1 つのプロジェクトに対して多数のサービス アカウントを作成できます。詳細は、サービス アカウントについてをご覧ください。
サービス アカウントは、1 つまたは複数の公開鍵/秘密鍵のペアに関連付けられます。新しい鍵ペアを作成すると、秘密鍵がダウンロードされます。秘密鍵は、API の呼び出し時に認証情報の生成に使用されます。秘密鍵のセキュリティと、鍵のローテーションなどの他の管理操作は、ユーザーの責任になります。詳細については、サービス アカウント キーを管理するためのベスト プラクティスをご覧ください。
Identity and Access Management のロール
Google Cloud では、プリンシパル(ユーザー アカウント、サービス アカウントなど)が API を呼び出す場合、プリンシパルに適切な権限が割り当てられている必要があります。権限を付与するには、プリンシパルにロールを付与します。詳細については、ロールの概要をご覧ください。
ユーザー アカウントを使用してプロジェクトを作成した場合は、ユーザー アカウントにプロジェクトのオーナーの基本ロールが付与されています。このロールは、プロジェクトの API を呼び出すためのアクセス権を付与します。ただし、別のアカウントでプロジェクトを作成した場合、API を呼び出す前にユーザー アカウントにロールを付与する必要があります。
サービス アカウントとキーの作成
サービス アカウントを作成します。
-
Google Cloud コンソールで [サービス アカウントの作成] ページに移動します。
[サービス アカウントの作成] に移動 - プロジェクトを選択します。
-
[サービス アカウント名] フィールドに名前を入力します。Google Cloud コンソールでは、この名前に基づいて [サービス アカウント ID] フィールドに値が設定されます。
[サービス アカウントの説明] フィールドに説明を入力します。例:
Service account for quickstart
- [作成して続行] をクリックします。
-
プロジェクトへのアクセス権を付与するには、サービス アカウントに Cloud Translation > Cloud Translation API Admin ロールを付与します。
ロールを付与するには、[ロールを選択] リストで [Cloud Translation > Cloud Translation API Admin] を選択します。
- [続行] をクリックします。
-
[完了] をクリックして、サービス アカウントの作成を完了します。
ブラウザ ウィンドウは閉じないでください。次のステップでこれを使用します。
サービス アカウント キーを作成します。
- Google Cloud コンソールで、作成したサービス アカウントのメールアドレスをクリックします。
- [キー] をクリックします。
- [鍵を追加]、[新しい鍵を作成] の順にクリックします。
- [作成] をクリックします。JSON キーファイルがパソコンにダウンロードされます。
- [閉じる] をクリックします。
各種ロールの詳細については、Cloud Translation - Advanced のロールをご覧ください。たとえば、サービス アカウントにテキストの翻訳を許可する場合は、roles/cloudtranslate.user
ロールを割り当てます。そのサービス アカウントに関連付けられたすべての鍵に、同じ権限が付与されます。
環境でのサービス アカウント キー ファイルの使用
環境変数 GOOGLE_APPLICATION_CREDENTIALS
を設定して、アプリケーション コードに認証情報を指定します。この変数は、現在のシェル セッションにのみ適用されます。この変数を新しいシェル セッションに適用する場合は、シェル起動ファイル(~/.bashrc
ファイルや ~/.profile
ファイルなど)で変数を設定します。
Linux または macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
KEY_PATH
をサービス アカウント キーが含まれる JSON ファイルのパスに置き換えます。
例:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
PowerShell の場合:
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH
"
KEY_PATH
をサービス アカウント キーが含まれる JSON ファイルのパスに置き換えます。
例:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
コマンド プロンプトの場合:
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
KEY_PATH
をサービス アカウント キーが含まれる JSON ファイルのパスに置き換えます。
また、コード内の JSON ファイルを参照することもできます。詳細については、コードを使用して認証情報を提供するをご覧ください。
クライアント ライブラリのインストール
クライアント ライブラリは、よく使われている複数の言語で利用できます。こうしたクライアント ライブラリを使用して Cloud Translation を呼び出すと、API へのアクセスが容易になるため、ライブラリの使用をおすすめします。クライアント ライブラリでニーズを満たせない場合や、ご使用の言語でクライアント ライブラリを利用できない場合は、独自のカスタムコードを作成してください。詳細については、独自のクライアント コードの使用をご覧ください。
たとえば、クライアント ライブラリを使用する際に、GOOGLE_APPLICATION_CREDENTIALS
環境変数によって認証情報が暗黙的に判別されます。コードで認証情報を明示的に指定する必要はありません。詳細については、Cloud APIs ドキュメントのクライアント ライブラリの説明をご覧ください。
Cloud Translation - Basic クライアント ライブラリ
開発に使用しているプログラミング言語を選択し、関連するコマンドを実行します。詳細については、Cloud Translation - Basic のクライアント ライブラリの概要をご覧ください。
C#
nuget install Google.Cloud.Translation.V2
Go
go get cloud.google.com/go/translate
Java
Maven を使用している場合は、次のものを pom.xml
ファイルに追加します。BOM の詳細については、Google Cloud Platform ライブラリ BOM をご覧ください。
Gradle を使用している場合は、次のものを依存関係に追加します。
sbt を使用している場合は、次のものを依存関係に追加します。
Visual Studio Code、IntelliJ または Eclipse を使用している場合は、次の IDE プラグインでプロジェクトにクライアント ライブラリを追加できます。
プラグインでは、サービス アカウントのキー管理などの追加機能も提供されます。詳細は各プラグインのドキュメントをご覧ください。
Node.js
Node.js 開発環境の設定の詳細については、Node.js 開発環境設定ガイドをご覧ください。
npm install --save @google-cloud/translate
PHP
composer require google/cloud-translate
Python
Python 開発環境の設定の詳細については、Python 開発環境設定ガイドをご覧ください。
pip install google-cloud-translate==2.0.1
Ruby
Ruby 開発環境の設定の詳細については、Ruby 開発環境設定ガイドをご覧ください。
gem install google-cloud-translate-v2
Cloud Translation - Advanced クライアント ライブラリ
開発に使用しているプログラミング言語を選択し、関連するコマンドを実行します。詳細については、Cloud Translation - Advanced のクライアント ライブラリの概要をご覧ください。
C#
nuget install Google.Cloud.Translate.V3 -Pre
Go
go get cloud.google.com/go/translate/apiv3
Java
Maven を使用している場合は、次のものを pom.xml
ファイルに追加します。BOM の詳細については、Google Cloud Platform ライブラリ BOM をご覧ください。
Gradle を使用している場合は、次のものを依存関係に追加します。
sbt を使用している場合は、次のものを依存関係に追加します。
Visual Studio Code、IntelliJ または Eclipse を使用している場合は、次の IDE プラグインでプロジェクトにクライアント ライブラリを追加できます。
プラグインでは、サービス アカウントのキー管理などの追加機能も提供されます。詳細は各プラグインのドキュメントをご覧ください。
Node.js
Node.js 開発環境の設定の詳細については、Node.js 開発環境設定ガイドをご覧ください。
npm install --save @google-cloud/translate
PHP
composer require google/cloud-translate
Python
Python 開発環境の設定の詳細については、Python 開発環境設定ガイドをご覧ください。
pip install --upgrade google-cloud-translate
Ruby
Ruby 開発環境の設定の詳細については、Ruby 開発環境設定ガイドをご覧ください。
gem install google-cloud-translate
Google Cloud CLI をインストールする
コマンドラインから(curl コマンドなどを使用して)Cloud Translation リクエストを送信する場合は、gcloud CLI をインストールして初期化します。これは Google Cloud CLI に含まれています。詳細については、次のリンク先をご覧ください。
Google Cloud CLI をインストールし、次のコマンドを実行して初期化します。
gcloud init
SDK と認証をテストする
GOOGLE_APPLICATION_CREDENTIALS
環境変数を設定した場合は、gcloud
を使用して認証環境をテストできます。次のコマンドを実行し、エラーが発生せず、認証情報が返されることを確認します。
gcloud auth application-default print-access-token
上記のコマンドは、すべての Cloud Translation のコマンドライン REST サンプルで API 呼び出しの認証に使用されます。
次のステップ
クイックスタートを使用して簡単な translation 呼び出しを行ってみる。
入門ガイドで、Cloud Translation のさまざまな機能について確認する。
使ってみる
Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Cloud Translation のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
Cloud Translation の無料トライアル