Google Translate APIが有料化され、v1は停止されます。
そこで、有料で利用可能なv2の使い方について、
ドキュメントを翻訳してみます。
翻訳元は
こちら。
その1は
こちらです。
Calling styles - 呼び出し方
APIを呼び出すには、複数の方法があります:
・RESTを直接使用する
・JavaScriptからRESTを使う(サーバーサイドのコードは必要ありません)
REST
REST(
Representational State Transfer)は、Google Translate APIの中では、伝統的なRESTとは多少異なります。リソースへのアクセスを提供する代わりに、APIはサービスへのアクセスを提供します。結果として、APIはサービスのエンドポイントとして働く単一のURIを提供します。
API操作に記述された方法で、Google Translate APIサービスのエンドポイントにRESTのHTTPメソッドのGETを使ってアクセスを行います。全てのサービスへのリクエストの内容は、クエリパラメータとして渡します。
Translate - 翻訳
単一のGoogle Translate APIのURIへアクセスする指定された形式は以下の通りです:
https://www.googleapis.com/language/translate/v2?parameters
parametersの部分は、クエリに適用されるパラメータです。詳細については、Using RESTドキュメントの
Working with resultsと
Query parameter referenceを御一読下さい。
ここに示すのは、Translate APIがどのように機能するかを示す一例です。
https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&q=hello%20world&source=en&target=de
Discover supported languages - サポートされる言語を見つける
言語コードのリストを返す指定の形式は:
https://www.googleapis.com/language/translate/v2/languages?parameters
parametersの部分は、クエリに適用されるパラメータです。詳細については、Using RESTドキュメントの
Working with resultsと
Query parameter referenceを御一読下さい。
Translate APIで言語メソッドを機能させる方法の例を示します:
https://www.googleapis.com/language/translate/v2/languages?key=INSERT-YOUR-KEY&target=zh-TW
Detect source language - 翻訳元言語の判別
テキストの言語を判別する指定の形式は以下の通りです:
https://www.googleapis.com/language/translate/v2/detect?parameters
parametersの部分は、クエリに適用されるパラメータです。詳細については、Using RESTドキュメントの
Working with resultsと
Query parameter referenceを御一読下さい。
Translate APIで判別のメソッドを動作させる方法の一例を示します。
https://www.googleapis.com/language/translate/v2/detect?key=INSERT-YOUR-KEY&q=google+translate+is+fast
REST from JavaScript - RESTのJavaScriptからの利用
Translate APIを、コールバックされたクエリパラメータとコールバック関数を利用して、JavaScriptからRESTを使って呼び出すことができます。これによってサーバーサイドのコードを記述することなく翻訳されたデータを表示するリッチなアプリケーションを記述することができます。
以下のサンプルでは、この方法を使ってテキストを翻訳し、source textの下に表示します:
<title>Translate API Example</title>
<div id="sourceText">
Hello world
</div>
<div id="translation">
</div>
<script>
function translateText(response) {
document.getElementById("translation").innerHTML += ""+ response.data.translations[0].translatedText;
}
</script>
<script>
var newScript = document.createElement('script');
newScript.type = 'text/javascript';
var sourceText = escape(document.getElementById("sourceText").innerHTML);
var source = 'https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&source=en&target=de&callback=translateText&q=' + sourceText;
newScript.src = source;
// When we add this script to the head, the request is sent off.
document.getElementsByTagName('head')[0].appendChild(newScript);
</script>
Data format
JSON
JSON(JavaScript Object Notation)は、任意のデータ構造を表すシンプルなメソッドを提供する共通のインターネット上のフォーマットです。
json.orgによると、JSONは完全に言語に依存したテキストフォーマットですが、C、C++、C#、Java、JavaScript、Perl、Pythonその他のC言語系統の言語のプログラマーには慣れ親しんだ規則を使用しています。
インストール不要･無料のKaede翻訳ツール：
http://kaedetrans.appspot.com/
