設定

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）を指定する必要があります。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

課金を有効にする

Cloud Translation を使用するには、課金を有効にする必要があります。Cloud Translation の料金の詳細については、料金ページをご覧ください。

請求先アカウントは、特定のリソースセットに対する支払いをだれが行うかの定義に使用され、1 つ以上のプロジェクトにリンクできます。プロジェクトの利用料金は、リンクされた請求先アカウントに請求されます。ほとんどの場合、プロジェクトの作成時に請求情報を構成します。詳細については、お支払いとご請求に関するドキュメントをご覧ください。

Make sure that billing is enabled for your Google Cloud project.

API の有効化

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

Enable the Cloud Translation API.

Enable the API

使用量の割り当ての設定

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

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

認証を設定する

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

Identity and Access Management のロール

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

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

クライアント ライブラリは、よく使われている複数の言語で利用できます。こうしたクライアント ライブラリを使用して Cloud Translation を呼び出すと、API へのアクセスが容易になるため、ライブラリの使用をおすすめします。クライアント ライブラリでニーズを満たせない場合や、ご使用の言語でクライアント ライブラリを利用できない場合は、独自のカスタムコードを作成してください。詳細については、独自のクライアント コードの使用をご覧ください。

たとえば、クライアント ライブラリを使用する際に、GOOGLE_APPLICATION_CREDENTIALS 環境変数によって認証情報が暗黙的に判別されます。コードで認証情報を明示的に指定する必要はありません。詳細については、Cloud APIs ドキュメントのクライアント ライブラリの説明をご覧ください。

Cloud Translation - Basic クライアント ライブラリ

開発に使用しているプログラミング言語を選択し、関連するコマンドを実行します。詳細については、Cloud Translation - Basic のクライアント ライブラリの概要をご覧ください。

nuget install Google.Cloud.Translation.V2

go get cloud.google.com/go/translate

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

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

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

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

npm install --save @google-cloud/translate

composer require google/cloud-translate

pip install google-cloud-translate==2.0.1

gem install google-cloud-translate-v2

Cloud Translation - Advanced クライアント ライブラリ

開発に使用しているプログラミング言語を選択し、関連するコマンドを実行します。詳細については、Cloud Translation - Advanced のクライアント ライブラリの概要をご覧ください。

nuget install Google.Cloud.Translate.V3 -Pre

go get cloud.google.com/go/translate/apiv3

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

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

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

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

npm install --save @google-cloud/translate

composer require google/cloud-translate

pip install --upgrade google-cloud-translate

gem install google-cloud-translate

Google Cloud CLI をインストールする

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

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

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 のさまざまな機能について確認する。