設定

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 を有効にします。

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 のクライアント ライブラリの概要をご覧ください。

C#

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

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

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

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

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

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

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

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

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 をご覧ください。

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

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

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

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

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

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

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 呼び出しの認証に使用されます。

次のステップ

使ってみる

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

Cloud Translation の無料トライアル