このドキュメントでは、Cloud Translation API(v2)を使用して、サポートされている言語を一覧表示する方法について説明します。
始める前に
Cloud Translation API を使用するには、Cloud Translation API が有効になっているプロジェクトと適切な認証情報を持つ秘密鍵が必要です。また、この API の呼び出しを支援する一般的なプログラミング言語のクライアント ライブラリをインストールすることもできます。詳細については、設定ページをご覧ください。
サポートされている言語リクエストの送信
次の形式の URL を使用して HTTP リクエストを送信することで、この API のサポートされている言語を検索できます。
https://translation.googleapis.com/language/translate/v2/languages
サポートされている言語のリストの取得
REST とコマンドライン
サポートされているすべての言語のリストを取得するには、https://translation.googleapis.com/language/translate/v2/languages
エンドポイントに GET
リクエストを行います。次の例は、curl
と PowerShell を使用した GET
リクエストを示しています。この例では、Google Cloud CLI を使用するプロジェクト用に設定されたサービス アカウントのアクセス トークンを使用します。gcloud CLI のインストール、サービス アカウントでのプロジェクトの設定、アクセス トークンの取得を行う手順については、設定ページをご覧ください。
HTTP メソッドと URL:
GET https://translation.googleapis.com/language/translate/v2/languages
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://translation.googleapis.com/language/translate/v2/languages "
PowerShell
次のコマンドを実行します。
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://translation.googleapis.com/language/translate/v2/languages " | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
{ "languages": [ { "language": "en" }, { "language": "fr" }, { "language": "zh-CN" } ] }
このクエリは、サポートされている言語の ISO-639-1 言語コードを返します。一部の言語コードには zh-CN や zh-TW のような国コードも含まれます。リストは言語コード別にアルファベット順になります。上記の例は、スペースの都合上省略されています。
Go
Java
Node.js
Python
その他の言語
C#: クライアント ライブラリ ページの C# の設定手順を行ってから、.NET 用の Translation リファレンス ドキュメントをご覧ください。
PHP: クライアント ライブラリ ページの PHP の設定手順を行ってから、PHP 用の Translation リファレンス ドキュメントをご覧ください。
Ruby: クライアント ライブラリ ページの Ruby の設定手順を実行してから、Ruby 用の Translation リファレンス ドキュメントをご覧ください。
ターゲット言語でサポートされている言語の一覧表示
REST とコマンドライン
次に、サポートされている言語のリストを返す別の例を示します。返される言語名は、指定されたターゲット言語で書き込まれます。返されるリストは、そのターゲット言語のアルファベット順になります。
サポートされている言語をターゲット言語で一覧表示するには、POST
リクエストを作成し、リクエスト本文でターゲット言語を識別する JSON を指定します。以下は、curl
または PowerShell を使用した POST
リクエストの例です。
HTTP メソッドと URL:
POST https://translation.googleapis.com/language/translate/v2/languages
JSON 本文のリクエスト:
{ "target": "zh-TW" }
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/language/translate/v2/languages "
PowerShell
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/language/translate/v2/languages " | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
{ "data": { "languages": [ { "language": "zh-CN", "name": "中文(簡體)" }, { "language": "fr", "name": "法文" }, { "language": "en", "name": "英文" } ] } }
この場合、上記と同じ言語コードと、ターゲット言語(zh-TW)の言語名が入った文字列 name
がクエリから返されます。上記の例は、スペースの都合上省略されています。
Go
Java
Node.js
Python
その他の言語
C#: クライアント ライブラリ ページの C# の設定手順を行ってから、.NET 用の Translation リファレンス ドキュメントをご覧ください。
PHP: クライアント ライブラリ ページの PHP の設定手順を行ってから、PHP 用の Translation リファレンス ドキュメントをご覧ください。
Ruby: クライアント ライブラリ ページの Ruby の設定手順を行ってから、Ruby 用の Translation リファレンス ドキュメントをご覧ください。
参考情報
- 一般的な問題またはエラーの解決に関するヘルプについては、トラブルシューティングページをご覧ください。