# GCP Translation APIでGoogle Cloud CLIから翻訳実行する方法

## 目次

1. 1-1 GCP Translation APIとは

2. 1-2 Google Cloud CLIの準備

3. 1-3 Translation APIの有効化

4. 1-4 サービスアカウントの設定

5. 1-5 APIキーの取得

6. 1-6 翻訳のリクエストを作成する

7. 1-7 CLIから翻訳を実行

8. 1-8 成功確認とエラーハンドリング

9. まとめ

---

## 1-1 GCP Translation APIとは

Google Cloud Translation APIは、多言語間でテキストを翻訳するための非常に効率的なツールです。クラウドベースであるため、スケーラブルであり、リアルタイムでの翻訳をサポートします。機械学習を活用して精度の高い翻訳を提供し、多数の言語への対応が可能です。

## 1-2 Google Cloud CLIの準備

始める前に、Google Cloud CLI（gcloud CLI）がインストールされている必要があります。以下のコマンドでセットアップを確認します。

```bash

gcloud --version

```

コマンドでバージョンが表示されればOKです。表示されない場合は、[Google Cloud CLIのインストール](https://cloud.google.com/sdk/docs/install)手順に従ってください。

## 1-3 Translation APIの有効化

次に、プロジェクトでTranslation APIを有効にする必要があります。以下のコマンドで有効化が可能です。

```bash

gcloud services enable translate.googleapis.com

```

これにより、APIがプロジェクトで利用可能になるとともに、リクエストを受け付ける準備が整います。

## 1-4 サービスアカウントの設定

安全にAPIにアクセスするために、サービスアカウントを作成します。

1. Google Cloud Consoleで、[IAM & 管理 > サービスアカウント](https://console.cloud.google.com/iam-admin/serviceaccounts)を開きます。

2. `サービスアカウントを作成`をクリック。

3. サービスアカウントIDと、その目的について記載します。

4. 必要なロールを割り当て、アカウントを作成します。

次に、JSON形式のキーをダウンロードして、環境変数`GOOGLE_APPLICATION_CREDENTIALS`にパスを設定します。

```bash

export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/service-account-file.json"

```

## 1-5 APIキーの取得

また、より簡易的に使用したい場合は、APIキーを利用するオプションもあります。

1. Google Cloud Consoleの[APIとサービス > 認証情報](https://console.cloud.google.com/apis/credentials)ページで、`認証情報を作成`をクリック。

2. `APIキー`を選択し、生成されたキーをコピーします。

このキーはAPIを呼び出す際に使用されます。

## 1-6 翻訳のリクエストを作成する

翻訳を実行するには、翻訳にかけたいテキストとターゲット言語を指定する必要があります。JSON形式で次のようにリクエストを構成します。

```json

{

  "q": ["Hello, world!"],

  "target": "ja"

}

```

これは、「Hello, world!」を日本語に翻訳するためのリクエストです。

## 1-7 CLIから翻訳を実行

Google Cloud CLIを使って直接APIにアクセスし、翻訳を実行します。以下のコマンドでjsonデータを翻訳APIに送信します。

```bash

gcloud curl \

  "https://translation.googleapis.com/language/translate/v2" \

  -d '{"q": ["Hello, world!"], "target": "ja"}' \

  --header "Authorization: Bearer $(gcloud auth application-default print-access-token)"

```

または、APIキーを使ったリクエストの場合、URLパラメータに`key`を追加します。

```bash

gcloud curl \

  "https://translation.googleapis.com/language/translate/v2?key=YOUR_API_KEY" \

  -d '{"q": ["Hello, world!"], "target": "ja"}'

```

## 1-8 成功確認とエラーハンドリング

成功すると、以下のような結果が返ってくるはずです。

```json

{

  "data": {

    "translations": [

      {

        "translatedText": "こんにちは、世界！"

      }

    ]

  }

}

```

エラーが発生した場合、エラーメッセージが表示されます。例えば、認証エラーの場合は以下のようなメッセージが表示されます。

```json

{

  "error": {

    "code": 401,

    "message": "Request had invalid authentication credentials."

  }

}

```

## まとめ

GCP Translation APIをGoogle Cloud CLIから実行する方法を詳しく説明しました。手順に沿って設定を行い、実際の翻訳を試すことで、クラウド上で簡単に多言語対応が可能になることを実感できるでしょう。組織のグローバル展開や多文化対応において、Translation APIは強力なツールとなります。

GCP Translation APIでGoogle Cloud CLIから翻訳実行する方法

目次

続きを読むには単価診断を受けてください（30秒）