Google Translate API入門 概要編
概要
Google Traslate APIを使うと、テキストの翻訳と言語検知ができます。
Translate APIは有料のサービスのため、サービスを使用開始する前に支払い情報を入力する必要あります。
Google Translate API はデフォルトで 1 日 2,000,000 文字に制限されています。この上限は、Cloud Console で下記の手順を行うことで 1 日 50,000,000 文字までに増やすことができます。 1 日 50,000,000 文字以上翻訳する必要がある場合は、お問い合わせをする必要があります。
料金
- 使用料(翻訳)
- テキスト 1,000,000 文字につき 20 ドル。課金は実際に提供された文字数に比例して調整されます。たとえば、翻訳する文字数が 500,000 文字だった場合は、10 ドルが課金されます。
- 使用料(言語の検知)
- テキスト 1,000,000 文字につき 20 ドル。課金は実際に提供された文字数に比例して調整されます。
対応言語
いろいろな言語用ライブラリが提供されています。
- Google APIs Client Library for Java (rc)
- Google APIs Client Library for JavaScript (beta)
- Google APIs Client Library for .NET
- Google APIs Client Library for Objective-C
- Google APIs Client Library for PHP (beta)
- Google APIs Client Library for Python
- Google APIs Client Library for Go (alpha)
- Google APIs Client Library for Node.js (alpha)
- Google APIs Client Library for Ruby (alpha)
REST API
メソッドのURLにパラメータを設定してHTTP呼び出しするとjson形式で結果を取得出来ます。
メソッド
- translate
- ソーステキストをある言語から別の言語に翻訳する。
- languages
- traxlateメソッドでサポートされているソース/ターゲット言語の一覧を返す。
- detect
- ソーステキストの言語を検知する。
Translate
書式
https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&q=hello%20world&source=en&target=de
パラメータ
- callback
- コールバック関数を設定できる。javascript用。
- key
- APIキー
- q
- ソーステキスト
- source
- 翻訳元言語
- target
- 翻訳先言語
結果
{ "data": { "translations": [ { "translatedText": "Hallo Welt", "detectedSourceLanguage": "en" } ] } }
Discover supported languages
書式
https://www.googleapis.com/language/translate/v2/languages?key=INSERT-YOUR-KEY&target=zh-TW
結果
{ "data": { "languages": [ { "language": "en" }, { "language": "fr" }, ... { "language": "zh-CN" } ] } }
Detect source language
書式
https://www.googleapis.com/language/translate/v2/detect?key=INSERT-YOUR-KEY&q=google+translate+is+fast
結果
{ "data": { "detections": [ [ { "language": "en", "isReliable": false, "confidence": 0.18397073 } ] ] } }
使うための事前準備
APIキーを有効にする
Developer consoleにおいて、プロジェクトを選択する。APIと認証/APIで、Translate APIをクリックして、APIを有効にする。
APIキーを取得する
認証情報画面/公開 API へのアクセスで「新しいキーを作成」を選択して、サーバー アプリケーションのキーを作成する。キーにはIPアドレス制限をかけることができる(リリース時)。
実行する
REST APIを実行する一番簡単な方法は、curlを使う方法です。
$ curl 'https://www.googleapis.com/language/translate/v2?key=取得したキー&target=ja&q=Hello' { "data": { "translations": [ { "translatedText": "こんにちは", "detectedSourceLanguage": "en" } ] } }