<DOCTYPE HTML>
<html lang="en-x-mtfrom-fr">
<head>
<title>The Bee</title>
...
ページ全体について、オリジナルのドキュメントがオンライン上で利用可能な場合、<link>要素をHTML文書の<head>部分に記述して、rel=""属性にalternate machine-translated-from"をセットして、hreflang=""属性に翻訳元言語のコードを、href=""属性にオリジナルのページをセットします。以下の様に記述します:<DOCTYPE HTML>
<html lang="en-x-mtfrom-fr">
<head>
<title>The Bee</title>
<link href="http://fr.example.com/abeille.html" hreflang="fr" rel="alternate machine-translated-from">
</head>
<body>
...
上記のHTMLコードは、このページがフランス語から英語の機械翻訳され、オリジナルのフランス語のドキュメントはhttp://fr.example.com/abeille.htmlに存在することを表しています。| パラメータ名 | 意味 | ノート |
|---|---|---|
| callback | レスポンスを受け取った時点で実行されるJavaScript関数 | ・このオプションのパラメータは、純粋にクライアントサイドで実装されたコードでクエリの結果を扱うJavaScript関数を指定することを可能にします。 ・<script>タグの内部にAPIのクエリを組み込みます。 ・コールバック関数を<script>タグの内部で定義します。 ・Getting Startedドキュメント内のREST from JavaScriptの項のサンプルを参照してください。 |
| key | あなたのAPIキー | ・このAPIは、全てのリクエストについて、認証されたキーを必要とします。 ・Google APIs consoleからキーを取得してください。 |
| prettyprint | インデントや改行込みでレスポンスを返します。 | ・prettyprint=trueの場合、サーバーから返される結果は人間に読みやすいもの(pretty printed)となります。 ・デフォルトはprettyprint=falseです。 |
| q | 翻訳元のテキスト | ・判別の対象となるテキスト ・複数のテキストの判別を行うために、単一のリクエストに1つ以上のパラメータを繰り返すことができます。 |
https://www.googleapis.com/language/translate/v2/detect?parameters翻訳のリクエストそれぞれについて、2つのクエリパラメータが必要です:
GET https://www.googleapis.com/language/translate/v2/detect?key=INSERT-YOUR-KEY&q=Google%20Translate%20Rocksリクエストが成功すると、サーバーは200 OKのHTTPステータスコードとデータプロパティを返します:
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ステータスコードとデータプロパティを返します。
200 OK
{
"data": {
"detections": [
[
{
"language": "en",
"isReliable": false,
"confidence": 0.114892714
}
]
]
},
"data": {
"detections": [
[
{
"language": "zh-TW",
"isReliable": false,
"confidence": 0.7392313
}
]
]
}
}
| パラメータ | 意味 | ノート |
|---|---|---|
| callback | レスポンスをうけっとた時点で実行されるJavaScript関数 | ・このオプションのパラメータは、純粋にクライアントサイドで実装されたコードでクエリの結果を扱うJavaScript関数を指定することを可能にします。 ・<script>タグの内部にAPIのクエリを組み込みます。 ・コールバック関数を<script>タグの内部で定義します。 ・Getting Startedドキュメント内のREST from JavaScriptの項のサンプルを参照してください。 |
| key | あなたのAPIキー | ・このAPIは、全てのリクエストについて、認証されたキーを必要とします。 ・Google APIs consoleからキーを取得してください。 |
| prettyprint | インデントや改行込みでレスポンスを返します。 | ・prettyprint=trueの場合、サーバーから返される結果は人間に読みやすいもの(pretty printed)となります。 ・デフォルトはprettyprint=falseです。 |
| target | 目的となる言語 | ・言語名にあたる言語とソート順 ・言語が指定されていない場合、システムは言語名と言語コードに基づいてソートされる順番を返しません。 |
https://www.googleapis.com/language/translate/v2/languages?parametersリクエストあたりに、一つのクエリパラメータが必要です:
GET https://www.googleapis.com/language/translate/v2/languages?key=INSERT-YOUR-KEYリクエストが成功した場合、サーバは200 OK HTTPステータスコードとデータのプロパティを使用して応答します。
200 OK
{
"data": {
"languages": [
{
"language": "en"
},
{
"language": "fr"
},
...
{
"language": "zh-CN"
}
]
}
}
上記のレスポンスの内容は、translate APIによってサポートされる言語コードのリストです。リストは、言語コードをアルファベット順でソートしています。GET https://www.googleapis.com/language/translate/v2/languages?key=INSERT-YOUR-KEY&target=zh-TWリクエストが成功した場合、サーバは200 OK HTTPステータスコードとデータのプロパティを使用して応答します。
200 OK
{
"data": {
"languages": [
{
"language": "zh-CN",
"name": "中文(簡體)"
},
{
"language": "fr",
"name": "法文"
},
...
{
"language": "en",
"name": "英文"
}
]
}
}
| 言語 | 言語コード |
|---|---|
| アフリカーンス語 | af |
| アルバニア語 | sq |
| アラビア語 | ar |
| ベラルーシ語 | be |
| ブルガリア語 | bg |
| カタロニア語 | ca |
| 簡体中国語 | zh-CN |
| 繁体中国語 | zh-TW |
| クロアチア語 | hr |
| チェコ語 | cs |
| デンマーク語 | da |
| オランダ語 | nl |
| 英語 | en |
| エストニア語 | et |
| フィリピン語 | tl |
| フィンランド語 | fi |
| フランス語 | fr |
| ガリシア語 | gl |
| ドイツ語 | de |
| ギリシャ語 | el |
| ヘブライ語 | iw |
| ヒンディ語 | hi |
| ハンガリー語 | hu |
| アイスランド語 | is |
| インドネシア語 | id |
| アイルランド語 | ga |
| イタリア語 | it |
| 日本語 | ja |
| 朝鮮語 | ko |
| ラトビア語 | lv |
| リトアニア語 | lt |
| マケドニア語 | mk |
| マレー語 | ms |
| マルタ語 | mt |
| ノルウェー語 | no |
| ペルシャ語 | fa |
| ポーランド語 | pl |
| ポルトガル語 | pt |
| ルーマニア語 | ro |
| ロシア語 | ru |
| セルビア語 | sr |
| スロバキア語 | sk |
| スロベニア語 | sl |
| スペイン語 | es |
| スワヒリ語 | sw |
| スウェーデン語 | wv |
| タイ語 | th |
| トルコ語 | tr |
| ウクライナ語 | uk |
| ベトナム語 | vi |
| ウェールズ語 | cy |
| ヨルバ語 | yi |
| Parameter パラメータ | Meaning 意味 | Notes 注釈 |
|---|---|---|
| callback | レスポンスを受け取った後に実行されるJavaScript関数 | ・このオプションのパラメータにより、純粋なクライアントサイドの実装でクエリの結果を扱うJavaScript関数を指定することが可能になります。 ・<script>タグ内にAPIクエリを組み込みます。 ・<script>タグ内にコールバック関数を指定します。 ・Getting StartedドキュメントのREST from JavaScriptの例を参照してください。 |
| format | フォーマット | ・このオプションのパラメータは、翻訳元のテキストがプレーンテキストとHTMLのどちらなのかを識別する値となります。htmlを値とすればHTMLを表し、textを値とすればプレーンテキストを表します。 ・デフォルトの値:format=text |
| key | あなたのAPI key | ・このAPIは、全てのリクエストについて、有効なキーを必要とします。 ・Google APIs consoleからキーを取得してください。 |
| prettyprint | インデントや改行を入れてレスポンスを返します。 | ・prettyprint=trueの場合、サーバーからの結果は人間に読みやすい形で返されます(pretty printed)。 ・デフォルト値:prettyprint=false |
| q | 翻訳元のテキスト | ・翻訳されるテキストです。 ・このパラメータは、単一のリクエスト内に1回以上繰り返しができ、複数のテキストを翻訳することができます。 |
| source | 翻訳元言語 | ・翻訳元テキストの言語を表します。Language reference内に挙げられている言語コードの中の一つである必要があります。 ・言語が特定されていない場合、システムは翻訳元言語の自動判定を試みます。 |
| target | 翻訳先言語 | ・元となるテキストの翻訳先となる言語を表します。Language reference内に挙げられている言語コードの中の一つである必要があります。 |
https://www.googleapis.com/language/translate/v2?parametersそれぞれの翻訳のリクエストには3つのパラメータが必要です。
GET https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&source=en&target=de&q=Hello%20worldリクエストが成功すると、サーバーは200 OKのHTTPステータスコードとデータプロパティを返します。
200 OK
{
"data": {
"translations": [
{
"translatedText": "Hallo Welt"
}
]
}
}
以下のサンプルは、複数の翻訳元テキストを翻訳するために送信します:GET https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&source=en&target=de&q=Hello%20world&q=My%20name%20is%20Jeffリクエストが成功すると、サーバーは200 OKのHTTPステータスコードとデータプロパティを返します。
200 OK
{
"data": {
"translations": [
{
"translatedText": "Hallo Welt"
},
{
"translatedText": "Mein Name ist Jeff"
}
]
}
}
以下のサンプルは、翻訳元言語を自動判別します:GET https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&target=de&q=Hello%20worldリクエストが成功すると、サーバーは200 OKのHTTPステータスコードとデータプロパティを返します。
200 OK
{
"data": {
"translations": [
{
"translatedText": "Hallo Welt",
"detectedSourceLanguage": "en"
}
]
}
}
https://www.googleapis.com/language/translate/v2?parametersparametersの部分は、クエリに適用されるパラメータです。詳細については、Using RESTドキュメントのWorking with resultsとQuery parameter referenceを御一読下さい。
https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&q=hello%20world&source=en&target=de
https://www.googleapis.com/language/translate/v2/languages?parametersparametersの部分は、クエリに適用されるパラメータです。詳細については、Using RESTドキュメントのWorking with resultsとQuery parameter referenceを御一読下さい。
https://www.googleapis.com/language/translate/v2/languages?key=INSERT-YOUR-KEY&target=zh-TWDetect source language - 翻訳元言語の判別
https://www.googleapis.com/language/translate/v2/detect?parametersparametersの部分は、クエリに適用されるパラメータです。詳細については、Using RESTドキュメントのWorking with resultsとQuery parameter referenceを御一読下さい。
https://www.googleapis.com/language/translate/v2/detect?key=INSERT-YOUR-KEY&q=google+translate+is+fast
<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>
| Operation 操作 | Description 説明 | REST HTTP mapping REST HTTPでのマッピング |
|---|---|---|
| translate | source textをsource languageからtarget languageに翻訳する | GET |
| languages | 翻訳メソッドにサポートされている翻訳元・翻訳先言語の一覧 | GET |
| detect | source textの言語を判別する | GET |