Google Translate API の有料版 - 開発者ガイド RESTの使用 その7

Google Translate APIは有料化され、
v1のJavaScriptによるアクセスはできなくなります。

有料版はAPIが変更され、
RESTによるアクセスを必要とします。

Googleのドキュメントでは、RESTによるアクセスを
HTTP GETメソッドによるものと、JavaScriptによるものを説明しています。

Developer's Guide (v2) Using REST
を翻訳してみます。

第1回はこちら、第2回はこちら、第3回はこちら、第4回はこちら、第5回はこちら、
第6回はこちらです。

---

Detect Language - 言語の判別

Working with results - 結果の取得
HTTP GETリクエストを該当するURIに送ることで、テキスト文字列の言語の判別を行うことができます。リクエストのURIは以下のフォーマットとなります:

https://www.googleapis.com/language/translate/v2/detect?parameters

翻訳のリクエストそれぞれについて、2つのクエリパラメータが必要です:
・API key - アプリケーションの識別のためにkeyクエリパラメータを使用します。
・Source text string - 言語の種類の判別を行いたい文字列を表すためにqクエリパラメータを使用します。
その他の全てのクエリパラメータはオプションです。GETリクエストのためのURIは、パラメータ込みで2K文字以内でなければなりません。
Note:単一のリクエストでより多くのデータを送信したい場合、APIを呼び出すためにPOSTメソッドを使用することもできます。POSTメソッドのbody内の｢q｣パラメータは、5K文字未満出なければなりません。POSTメソッドを使用するには、X-HTTP-Method-Overrideヘッダを使って、リクエストをGETメソッドとして扱い(X-HTTP-Method-Override: GETを使用)、Translate APIに送信しなければなりません。
このサンプルでは、qクエリパラメータを使って"Google Translate Rocks"をテキストとして指定しています:

GET https://www.googleapis.com/language/translate/v2/detect?key=INSERT-YOUR-KEY&q=Google%20Translate%20Rocks

リクエストが成功すると、サーバーは200 OKのHTTPステータスコードとデータプロパティを返します:
JSON

200 OK

{
    "data": {
        "detections": [
            [
                {
                    "language": "en",
                    "isReliable": false,
                    "confidence": 0.18397073
                }
            ]
        ]
    }
}

ここに挙げるもう1つのサンプルでは、言語判別に複数の翻訳対象文字列を渡しています:

GET https://www.googleapis.com/language/translate/v2/detect?key=INSERT-YOUR-KEY&q=Hello%20world&q=%E6%88%91%E5%A7%93%E8%AD%9A

リクエストが成功すると、サーバーは200 OKのHTTPステータスコードとデータプロパティを返します。
JSON

200 OK

{
    "data": {
        "detections": [
            [
                {
                    "language": "en",
                    "isReliable": false,
                    "confidence": 0.114892714
                }
            ]
        ]
    },
    "data": {
        "detections": [
            [
                {
                    "language": "zh-TW",
                    "isReliable": false,
                    "confidence": 0.7392313
                }
            ]
        ]
    }
}

---

インストール不要･無料のKaede翻訳ツール：
http://kaedetrans.appspot.com/