Google Translate APIの有料化(開発者ガイド) その2

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/