Contents
Google Cloud Translation API 使い方ガイド：初心者向けの導入から実装まで
Google Cloud Translation API を初めて利用する開発者は、プロジェクト作成からコード実装までの手順に悩むことが多いです。本記事では Google Cloud Translation API の導入・設定・実装のポイントを体系的に解説し、Web開発者や個人事業主でも即戦力となる知識を提供します。特に認証情報生成や言語検出機能など、実務でよく使われる技術を重点的に紹介します。
Google Cloudプロジェクトの作成手順
Google Cloud Translation API を使用するには、まず GCPプロジェクト の作成が必須です。アカウント登録からプロジェクト管理までの一連の流れを解説します。
アカウント登録と初期設定
GCPにアクセスするためにはアカウントが必要です。既存のGoogleアカウントがあれば、以下の手順で進みます：
- Google Cloud Console にアクセス
- 右上にある 「プロジェクト」 メニューから 「新規プロジェクト作成」 を選択
- プロジェクト名を入力し、所在地を選択（※日本国内は支払い通貨の選択に影響する）
- 「作成」ボタンをクリックして初期化
注意: 会社や個人事業主の場合、課金アカウントの登録が必要になります。無料枠を超えると自動的に請求されるため、事前に利用目的を明確にしてください。
プロジェクトの新規作成と管理
プロジェクト作成後は、サービスの有効化や認証情報管理が重要です。以下が主な手順：
- プロジェクトダッシュボード から「APIとサービス」をクリック
- 「ライブラリ」で検索バーに
Translation APIを入力し、「有効化」を選択 - プロジェクト管理画面で「IAMとアディショナルサービス」から「サービスアカウント」を作成（後述）
API有効化と課金設定の流れ
Translation APIの有効化手順
プロジェクト作成後に、Translation APIを有効にする必要があります。以下が具体的な手順：
- Google Cloud Console にログインし、対象プロジェクトを選択
- 左サイドバーから「APIとサービス」→「ライブラリ」を開く
- 検索バーに
Cloud Translation APIを入力 - リストから「有効化」をクリック
APIの有効化後、利用料金が発生する可能性があります。無料枠は月ごとにリセットされるため、テスト用には適しています。
バジェット設定と請求書管理
課金設定はプロジェクトレベルで行います：
- Google Cloud Console →「billing」を選択
- 「請求書アカウントの追加」から支払い方法を登録（クレジットカードなど）
- バジェット設定画面で月額上限を入力
| オプション | 説明 |
|---|---|
| 無料枠 | 初回利用者は月10,000文字まで無料（※最新情報は公式ドキュメントを参照） |
| 課金通知 | 予算超過時にメールアラートが送信される |
認証情報（JSONキー）の生成方法
サービスアカウント作成
API呼び出し時に認証情報を用いるため、サービスアカウントを作成する必要があります。
- Google Cloud Console →「IAMとアディショナルサービス」→「サービスアカウント」
- 「作成」ボタンをクリックし、名前（例:
translation-api-service）を入力 - ロールに「Cloud Translation API 使用者」を選択
- 「作成」をクリック
秘密鍵ファイルのダウンロード
サービスアカウントを作成後、秘密鍵ファイル（JSON形式）を取得します。
- 作成したサービスアカウント選択 →「キー」タブへ移動
- 「Create key」→「JSON」を選択
- ダウンロードされた
.jsonファイルを安全な場所に保存
注意点：このファイルはプロジェクトの認証情報を含むため、漏洩しないように管理してください。
REST APIでの翻訳リクエストサンプルコード
Pythonでのcurlコマンド例
以下のようにcurlを使用して、テキストを英語から日本語へ変換できます：
|
1 2 3 4 5 6 7 8 9 10 |
curl -X POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --header "Content-Type: application/json; charset=utf-8" \ --data '{ "q": "Hello, world!", "source": "en", "target": "ja" }' \ "https://translation.googleapis.com/language/translate/v2" |
RESULT：
{"translations":[{"translatedText":"こんにちは、世界！"}]}
Node.js向けのコードテンプレート
Node.jsでは axios ライブラリを使用すると簡潔に実装できます：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
const axios = require('axios'); async function translate(text) { const response = await axios.post( 'https://translation.googleapis.com/language/translate/v2', { q: text, source: 'en', target: 'ja' }, { headers: { 'Authorization': `Bearer ${await getAccessToken()}`, 'Content-Type': 'application/json; charset=utf-8' } } ); return response.data.translations[0].translatedText; } function getAccessToken() { // gcloud CLIからトークンを取得するロジック（gcloud auth print-access-tokenコマンド使用） } |
サポートされている言語一覧と検出機能の活用
100以上の言語リスト
Google Cloud Translation APIでは、100を超える言語がサポートされています。主な言語は以下の通りです：
| 言語名 | コード |
|---|---|
| 日本語 | ja |
| 英語 | en |
| 中国語（繁体字） | zh-TW |
| フランス語 | fr |
TIP：言語コードはAPIリクエスト時に必須です。サポート言語一覧は公式ドキュメントで確認してください（URLエンコード済み）。
自動言語検出APIの使い方
テキストから自動的に言語を検出する機能もあります：
|
1 2 3 4 5 6 7 |
curl -X POST \ --header "Authorization: Bearer $(gcloud auth print-access-token)" \ --data '{ "q": ["こんにちは", "Hello"] }' \ "https://translation.googleapis.com/language/translate/v2/detect" |
RESULT：
|
1 2 3 4 5 6 7 |
{ "languages": [ {"language": "ja", "confidence": 0.97}, {"language": "en", "confidence": 0.95} ] } |
まとめ
- Google Cloudプロジェクトの作成は、API利用の前提条件です。アカウント登録とプロジェクト管理に注意。
- API有効化後はバジェット設定を忘れずに、無料枠を超えないように管理。
- 認証情報（JSONキー）の生成はサービスアカウント作成から進める必要があります。
- REST APIでの翻訳リクエストはPythonやNode.jsでも実装可能。curlコマンドとライブラリの両方を活用。
- 100以上の言語サポートがあり、自動言語検出機能も利用可能です。
Google Cloud Translation API を早速試してみましょう！プロジェクト作成からAPI呼び出しまでの一連の流れを理解することで、実務でも即戦力となるスキルを身に付けることができます。
注意：無料枠や技術的詳細については、最新情報が公式ドキュメントと一致しているか確認してください（公式サイト）。