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 ドル。課金は実際に提供された文字数に比例して調整されます。

対応言語

いろいろな言語用ライブラリが提供されています。

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
                }
            ]
        ]
    }
}

使うための事前準備

  1. APIキーを有効する
  2. APIキーを取得する

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"
   }
  ]
 }
}

関連情報