Service methods

ここでは、各種サービスをGengo API上で扱うエンドポイントについてご説明しています。

Language pairs (GET)

概要 :
翻訳対応している言語ペア、レベル、ポイント価格を返します。
URL :
http://api.gengo.com/v2/translate/service/language_pairs
認証 :
非必須
パラメータ :
  • api_key (必須) - お客様の API key
  • api_sig (必須) - お客様の API signature
  • ts (必須) - 現在のUNIX時間のInteger (整数型)
データ引数 :
lc_src (任意): ソース 言語コード。これを送信した場合、レスポンスを関連する言語ペアに限定します。

呼び出し例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

print(gengo.getServiceLanguagePairs(lc_src='de'))

返り値

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
  "opstat": "ok",
  "response": [
    {
      "unit_price": 0.0500,
      "lc_tgt": "en",
      "lc_src": "de",
      "tier": "standard",
      "currency": "USD"
    },
    {
      "unit_price": 0.1000,
      "lc_tgt": "en",
      "lc_src": "de",
      "tier": "pro",
      "currency": "USD"
    },
  ]
}

Languages (GET)

概要 :
翻訳対応している言語とその言語コードのリストを返します。
URL :
http://api.gengo.com/v2/translate/service/languages
認証 :
非必須
パラメータ :
  • api_key (必須) - お客様の API key

呼び出し例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

print(gengo.getServiceLanguages())

返り値

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "opstat": "ok",
  "response": [
    {
      "unit_type": "word",
      "lc": "en",
      "localized_name": "English",
      "language": "English"
    },
    {
      "unit_type": "character",
      "lc": "ja",
      "localized_name": "日本語",
      "language": "Japanese"
    },
    {
      "unit_type": "word",
      "lc": "es",
      "localized_name": "Español",
      "language": "Spanish (Spain)"
    }
  ]
}

Quote (POST)

概要 :
対象テキストのポイントお見積もりとユニット数を、提出された案件 (複数も可) のコンテンツ、レベル、および言語ペアにもとづいて返します。
URL :
http://api.gengo.com/v2/translate/service/quote
認証 :
必須
パラメータ :
  • api_key (必須) - お客様の API key
  • api_sig (必須) - お客様の API signature
  • ts (必須) - 現在のUNIX時間のInteger (整数型)
データ引数 :
jobs (必須): 案件のペイロードの配列の1つ。ただし、 “lc_src”、”lc_tgt”、 “tier”のパラメータと共にのみ使用されます。

呼び出し例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

jobs_data = {
        'job_1': {
            'type': 'text',
            'slug': 'Single :: English to Japanese',
            'body_src': 'Testing Gengo API library calls.',
            'lc_src': 'en',
            'lc_tgt': 'ja',
            'tier': 'standard',
            'auto_approve': 0,
            'comment': 'HEY THERE TRANSLATOR',
            'callback_url': 'http://...',
            'custom_data': 'your optional custom data, limited to 1kb.'
        },
        'job_2': {
            'type': 'text',
            'slug': 'Single :: English to Japanese',
            'body_src': 'Testing Gengo API library calls.',
            'lc_src': 'en',
            'lc_tgt': 'ja',
            'tier': 'standard',
            'auto_approve': 0,
            'comment': 'HEY THERE TRANSLATOR',
            'callback_url': 'http://...',
            'custom_data':'your optional custom data, limited to 1kb.'
        },
        ...
}

print(gengo.determineTranslationCost(jobs=jobs_data))

返り値

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "opstat": "ok",
  "response": {
    "jobs": {
      "job_2": {
        "custom_data": "your optional custom data, limited to 1kb.",
        "credits": 4.2,
        "eta": 25164,
        "unit_count": 42,
        "lc_src_detected": "en",
        "currency": "USD",
        "type": "text"
      },
      "job_1": {
        "custom_data": "your optional custom data, limited to 1kb.",
        "credits": 16.2,
        "eta": 45198,
        "unit_count": 324,
        "lc_src_detected": "en",
        "currency": "USD",
        "type": "text"
      }
    }
  }
}

Quote files (POST)

概要 :
ファイルをGengoにアップロードし、各ファイルのお見積もりを、実際のご注文時にお使いいただける識別子(identifier)とともに返します。お見積もりは、コンテンツ、レベル、および言語ペアにもとづいて算出されます。この呼び出しをされた後は、返された識別子を案件 (jobs) のPOSTメソッドのパラメータの1つとして実際の案件のご注文にご利用ください (案件の ペイロードをご参照ください)。
Note:
1回のシステムコールでアップロードできるファイル数は、最大50ファイルまでになっています。
URL :
http://api.gengo.com/v2/translate/service/quote/file
認証 :
必須
パラメータ :
  • api_key (必須) - お客様の API key
  • api_sig (必須) - お客様の API signature
  • ts (必須) - 現在のUNIX時間のInteger (整数型)
データ引数 :
  • jobs (必須): 案件のペイロードの配列の1つ。ただし、 “lc_src”、”lc_tgt”、 “tier”のパラメータと共にのみ使用されます。
  • files (必須) - ファイルのディクショナリ。それぞれのKey配下にはマルチパートのファイル情報がセットされます。

呼び出し例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
#!/usr/bin/python
# -*- coding: utf-8 -*-

from gengo import Gengo


gengo = Gengo(
    public_key='your_public_key',
    private_key='your_private_key',
    sandbox=False,
    debug=False)

jobs_data = {
    'job_1': {
        'type': 'file',
        'lc_src': 'en',
        'lc_tgt': 'ja',
        'tier': 'standard',
        'file_path': '/job_1/file_path.doc',
    },
    'job_2': {
        'type': 'file',
        'lc_src': 'en',
        'lc_tgt': 'ja',
        'tier': 'standard',
        'file_path': '/job_2/file_path.pdf',
    },
    'job_3': {
        'type': 'file',
        'lc_src': 'en',
        'lc_tgt': 'ja',
        'tier': 'standard',
        'file_path': '/job_3/file_path.foo',
    },
}

print(gengo.determineTranslationCost(jobs=jobs_data))

返り値

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "opstat": "ok",
  "response": {
    "jobs": {
      "job_3": {
        "err": {
          "filename": "file_path.foo",
          "code": 1802,
          "key": "job_3"
        }
      },
      "job_2": {
        "credits": 0.30,
        "eta": 25128,
        "identifier": "4fd1551c3a5628f795d645394bfcd0a5442e4e7ae60ad1f163424bdeb8420df4",
        "unit_count": 6,
        "lc_src": "en",
        "lc_src_detected": "en",
        "currency": "USD",
        "type": "file"
      },
      "job_1": {
        "credits": 0.30,
        "eta": 25128,
        "order_id": "54632",
        "identifier": "49427e41a1b6cefd7444b0d27ec165e7481658791885e71b7602c6babfc80b77",
        "unit_count": 6,
        "lc_src": "en",
        "lc_src_detected": "en",
        "currency": "USD",
        "type": "file"
      }
    }
  }
}