設定

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 つ以上のプロジェクトにリンクできます。プロジェクトの利用料金は、リンクされた請求先アカウントに請求されます。ほとんどの場合、プロジェクトの作成時に請求情報を構成します。詳細については、お支払いとご請求に関するドキュメントをご覧ください。

Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

API の有効化

プロジェクトで Cloud Translation API を有効にする必要があります。API の有効化の詳細については、Service Usage のドキュメントをご覧ください。

Cloud Translation API を有効にします。

API を有効にする

使用量の割り当ての設定

Cloud Translation には使用量の割り当て管理システムがあり、ユーザーと Google がサービスの使用量を管理しやすくなっています。デフォルトでは、1 日あたりに送信できる文字数に上限はありません。予算を設定している場合は、毎日の使用量をモニタリングし、計画された費用に基づいて割り当てを調整することをおすすめします。

割り当ての詳細については、割り当てと上限をご覧ください。

認証を設定する

Cloud Translation API を使用する場合は、認証を設定する必要があります。API を使用するクライアント アプリケーションはすべて、認証の対象であり、リクエストされるリソースへのアクセス権が付与されている必要があります。このセクションでは、認証の重要なコンセプトと設定手順について説明します。詳細については、Google Cloud 認証の概要をご覧ください。

サービス アカウントと秘密鍵

認証には複数のオプションがありますが、認証とアクセス制御にサービス アカウントを使用することをおすすめします。サービス アカウントでは、エンドユーザーではなく、アプリケーションの資格情報が提供されます。サービス アカウントはプロジェクトで所有されます。1 つのプロジェクトに対して多数のサービス アカウントを作成できます。詳細は、サービス アカウントについてをご覧ください。

サービス アカウントは、1 つまたは複数の公開鍵と秘密鍵のペアに関連付けられます。新しい鍵ペアを作成すると、秘密鍵がダウンロードされます。秘密鍵は、API の呼び出し時に認証情報の生成に使用されます。秘密鍵のセキュリティと、鍵のローテーションなどの他の管理操作は、ユーザーの責任になります。詳細については、サービス アカウント キーを管理するためのベスト プラクティスをご覧ください。

Identity and Access Management のロール

Google Cloud では、プリンシパル（ユーザー アカウント、サービス アカウントなど）が API を呼び出す場合、プリンシパルに適切な権限が割り当てられている必要があります。権限を付与するには、プリンシパルにロールを付与します。詳細については、ロールの概要をご覧ください。

ユーザー アカウントを使用してプロジェクトを作成した場合は、ユーザー アカウントにプロジェクトのオーナーの基本ロールが付与されています。このロールは、プロジェクトの API を呼び出すためのアクセス権を付与します。ただし、別のアカウントでプロジェクトを作成した場合、API を呼び出す前にユーザー アカウントにロールを付与する必要があります。

注: ロールの権限は Cloud Translation - Advanced にのみ適用されます。どちらのエディションでもサービス アカウントを使用できますが、特定の権限を設定できるのは Cloud Translation - Advanced のみです。Cloud Translation - Basic については、サービス アカウントの権限に関係なくリクエストできます。

サービス アカウントとキーの作成

サービス アカウントを作成します。

1. Google Cloud コンソールで [サービス アカウントの作成] ページに移動します。

   [サービス アカウントの作成] に移動
2. プロジェクトを選択します。

3. [サービス アカウント名] フィールドに名前を入力します。Google Cloud コンソールでは、この名前に基づいて [サービス アカウント ID] フィールドに値が設定されます。

   [サービス アカウントの説明] フィールドに説明を入力します。例: Service account for quickstart

4. [作成して続行] をクリックします。

5. プロジェクトへのアクセス権限を付与するには、サービス アカウントに次のロールを付与します。Cloud Translation > Cloud Translation API Admin

   [ロールを選択] リストでロールを選択します。

   ロールを追加するには、[別のロールを追加] をクリックして各ロールを追加します。

   注: [ロール] フィールドは、サービス アカウントがプロジェクト内のどのリソースにアクセスできるかに影響します。これらのロールは後で取り消すことも、追加のロールを付与することもできます。本番環境では、オーナー、編集者、閲覧者のロールを付与しないでください。代わりに、ニーズに合わせて事前定義ロールまたはカスタムロールを付与します。
6. [続行] をクリックします。

7. [完了] をクリックして、サービス アカウントの作成を完了します。

   ブラウザ ウィンドウは閉じないでください。次のステップでこれを使用します。

サービス アカウント キーを作成します。

1. Google Cloud コンソールで、作成したサービス アカウントのメールアドレスをクリックします。
2. [キー] をクリックします。
3. [鍵を追加]、[新しい鍵を作成] の順にクリックします。
4. [作成] をクリックします。JSON キーファイルがパソコンにダウンロードされます。
5. [閉じる] をクリックします。

各種ロールの詳細については、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

注: Java クライアント ライブラリは Android をサポートしていません。

Maven を使用している場合は、次のものを pom.xml ファイルに追加します。BOM の詳細については、Google Cloud Platform ライブラリ BOM をご覧ください。

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.1.3</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Gradle を使用している場合は、次のものを依存関係に追加します。

implementation platform('com.google.cloud:libraries-bom:26.1.3')

implementation 'com.google.cloud:google-cloud-translate'

sbt を使用している場合は、次のものを依存関係に追加します。

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.3.5"

Visual Studio Code、IntelliJ または Eclipse を使用している場合は、次の IDE プラグインでプロジェクトにクライアント ライブラリを追加できます。

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

プラグインでは、サービス アカウントのキー管理などの追加機能も提供されます。詳細は各プラグインのドキュメントをご覧ください。

注: Cloud Java クライアント ライブラリは現在 Android をサポートしていません。

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

注: Java クライアント ライブラリは Android をサポートしていません。

Maven を使用している場合は、次のものを pom.xml ファイルに追加します。BOM の詳細については、Google Cloud Platform ライブラリ BOM をご覧ください。

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.1.3</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>
</dependencies>

Gradle を使用している場合は、次のものを依存関係に追加します。

implementation platform('com.google.cloud:libraries-bom:26.1.3')

implementation 'com.google.cloud:google-cloud-translate'

sbt を使用している場合は、次のものを依存関係に追加します。

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.3.5"

Visual Studio Code、IntelliJ または Eclipse を使用している場合は、次の IDE プラグインでプロジェクトにクライアント ライブラリを追加できます。

• Cloud Code for VS Code
• Cloud Code for IntelliJ
• Cloud Tools for Eclipse

プラグインでは、サービス アカウントのキー管理などの追加機能も提供されます。詳細は各プラグインのドキュメントをご覧ください。

注: Cloud Java クライアント ライブラリは現在 Android をサポートしていません。

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 をインストールする

注: コマンドラインを使用して認証された API 呼び出しを行わない場合は、この手順をスキップできます。

コマンドラインから（curl コマンドなどを使用して）Cloud Translation リクエストを送信する場合は、gcloud CLI をインストールして初期化します。これは Google Cloud CLI に含まれています。詳細については、次のリンク先をご覧ください。

Google Cloud CLI をインストールして初期化します。

SDK と認証をテストする

GOOGLE_APPLICATION_CREDENTIALS 環境変数を設定した場合は、gcloud を使用して認証環境をテストできます。次のコマンドを実行し、エラーが発生せず、認証情報が返されることを確認します。

gcloud auth application-default print-access-token

上記のコマンドは、すべての Cloud Translation のコマンドライン REST サンプルで API 呼び出しの認証に使用されます。

次のステップ

• クイックスタートを使用して簡単な translation 呼び出しを行ってみる。

  • Cloud Translation - Basic のクイックスタート
  • Cloud Translation - Advanced のクイックスタート

• 入門ガイドで、Cloud Translation のさまざまな機能について確認する。

使ってみる

Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Cloud Translation のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

Cloud Translation の無料トライアル