始める前に
Cloud Translation API の使用を開始するには、Cloud Translation API が有効になっているプロジェクトと適切な認証情報が必要です。また、一般的なプログラミング言語のクライアント ライブラリをインストールして、API の呼び出しを行うこともできます。
詳細については、[設定] ページをご覧ください。
テキストの翻訳例
次の例は、Cloud Translation - Basic を使用して、テキストを指定のターゲット言語に翻訳する方法を示しています。詳細については、テキストの翻訳(Basic)入門ガイドをご覧ください。
REST とコマンドライン
Basictranslate
メソッドへの REST メソッド呼び出しを使用して、Cloud Translation - Basic リクエストを行います。ソース言語とターゲット言語は ISO-639-1 コードで指定できます。
以下は、curl
または PowerShell を使用した POST
リクエストの例です。
後述のリクエストのデータを使用する前に、次のように置き換えます。
HTTP メソッドと URL:
POST https://translation.googleapis.com/language/translate/v2
JSON 本文のリクエスト:
{ "q": "The Great Pyramid of Giza (also known as the Pyramid of Khufu or the Pyramid of Cheops) is the oldest and largest of the three pyramids in the Giza pyramid complex.", "source": "en", "target": "es", "format": "text" }
リクエストを送信するには、次のいずれかのオプションを選択します。
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
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 " | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
{ "data": { "translations": [{ "translatedText": "La Gran Pirámide de Giza (también conocida como la Pirámide de Khufu o la Pirámide de Keops) es la más antigua y más grande de las tres pirámides en el complejo de la pirámide de Giza." }] } }
C#
このサンプルを試す前に、Translation クイックスタート: クライアント ライブラリの使用にある C# の設定手順を行ってください。詳細については、Translation C# API のリファレンス ドキュメントをご覧ください。
Go
このサンプルを試す前に、Translation クイックスタート: クライアント ライブラリの使用にある Go の設定手順を行ってください。詳細については、Translation Go API のリファレンス ドキュメントをご覧ください。
Java
このサンプルを試す前に、Translation クイックスタート: クライアント ライブラリの使用にある Java の設定手順を行ってください。詳細については、Translation Java API のリファレンス ドキュメントをご覧ください。
Node.js
このサンプルを試す前に、Translation クイックスタート: クライアント ライブラリの使用にある Node.js の設定手順を行ってください。詳細については、Translation Node.js API のリファレンス ドキュメントをご覧ください。
PHP
このサンプルを試す前に、Translation クイックスタート: クライアント ライブラリの使用にある PHP の設定手順を行ってください。詳細については、Translation PHP API のリファレンス ドキュメントをご覧ください。
Python
このサンプルを試す前に、Translation クイックスタート: クライアント ライブラリの使用にある Python の設定手順を行ってください。詳細については、Translation Python API のリファレンス ドキュメントをご覧ください。
Ruby
このサンプルを試す前に、Translation クイックスタート: クライアント ライブラリの使用にある Ruby の設定手順を行ってください。詳細については、Translation Ruby API のリファレンス ドキュメントをご覧ください。