Job methods

ここでは、特定の案件 (1件) に関するタスクや情報をGengo API上で扱うエンドポイントをご説明しています。

Job (GET)

概要 :

特定の案件を検索します。

URL :

http://api.gengo.com/v2/translate/job/{id}

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

データ引数 :

  • id (必須) - 案件ID

Note

  • 案件がファイルの場合、レスポンスに``file_url_src``と``file_url_tgt``が含まれます。

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13gengo.getTranslationJob(id=42)

返り値

 1{
 2  "opstat": "ok",
 3  "response": {
 4    "job": {
 5      "job_id": 384985,
 6      "credits": 0.05,
 7      "auto_approve": 0,
 8      "eta": 25056,
 9      "file_download_ready": false,
10      "order_id": 54632,
11      "lc_tgt": "ja",
12      "unit_count": 1,
13      "lc_src": "en",
14      "slug": "APIJobtest",
15      "callback_url": "http://gengo.callback/",
16      "currency": "USD",
17      "tier": "standard",
18      "body_src": "This is text.",
19      "body_tgt": "これはテキストです。",
20      "ctime": 1313475693,
21      "status": "available"
22    }
23  }
24}

Job (PUT)

概要 :

翻訳対象の案件を更新します。リクエストは100MB以下に収める必要があります。コメントは25,000文字以下で入力してください。

URL :

http://api.gengo.com/v2/translate/job/{id}

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

データ引数 :
action (必須) :
"revise" - 案件を翻訳者に戻して修正を依頼します。

その他のパラメータ

  • comment (必須) - 翻訳者に案件を戻して修正を求める理由。

"approve" - 案件を承認します。

その他のパラメータ

  • rating (任意) 評価に関するガイドラインを含む ― 1(悪い)から5(非常に良い)まで

  • for_translator (任意) 翻訳者へのコメント

  • for_mygengo (任意) Gengoスタッフへのコメント (非公開)

  • public (任意) 1 (true) か 0 (false - デフォルト)。このフィードバックをGengoが公開してよいか

"reject" - 翻訳を拒否します。案件拒否プロセスの詳細については、弊社のFAQをご覧ください。

その他のパラメータ

  • reason (必須) - "quality", "incomplete", "other"

  • comment (必須)

  • follow_up (任意) "requeue" (デフォルト) か "cancel" のいずれかになります。"requeue" を選択した場合、案件は拒否され、別の翻訳者に再依頼されます。"cancel" を選択した場合、案件は拒否した時点で完全にキャンセルとなります。

"“archive“" - 案件をアーカイブします。

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13gengo.updateTranslationJob(
14    id=42,
15    action={
16        'action': 'reject',
17        'reason': 'quality',
18        'comment': 'My grandmother does better.',
19    }
20)

返り値

1{
2  "opstat": "ok",
3  "response": {
4
5  }
6}

Job (DELETE)

概要 :

案件をキャンセルします。案件のキャンセルは、翻訳者がまだ案件に着手していない場合のみご利用いただけます。

URL :

http://api.gengo.com/v2/translate/job/{id}

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

データ引数 :

  • id (必須) - 案件ID

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13gengo.deleteTranslationJob(id=42)

返り値

1{
2  "opstat": "ok",
3  "response": {
4
5  }
6}

Revisions (GET)

概要 :

特定の案件について、修正リソースのリストを入手します。修正は、翻訳者またはシニア翻訳者がテキストをアップデートするつど作成されます。

URL :

http://api.gengo.com/v2/translate/job/{id}/revisions

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13print(gengo.getTranslationJobRevisions(id=42))

返り値

 1{
 2  "opstat": "ok",
 3  "response": {
 4    "job_id": 42,
 5    "revisions": [
 6      {
 7        "rev_id": 1234,
 8        "ctime": "..."
 9      },
10      {
11        "rev_id": 1235,
12        "ctime": "..."
13      },
14      {
15        "rev_id": 1236,
16        "ctime": "..."
17      },
18      "..."
19    ]
20  }
21}

Revision (GET)

概要 :

修正リソースのIDを指定して特定の修正リソースを取得します。

URL :

http://api.gengo.com/v2/translate/job/{id}/revision/{rev_id}

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13print(gengo.getTranslationJobRevision(id=42, revision_id=1))

返り値

1{
2  "opstat": "ok",
3  "response": {
4    "revision": {
5      "body_tgt": "...",
6      "ctime": "..."
7    }
8  }
9}

Feedback (GET)

概要 :

特定の案件についてご提出いただいたフィードバックを取得します。

URL :

http://api.gengo.com/v2/translate/job/{id}/feedback

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

データ引数 :

  • id (必須) - 案件ID

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13print(gengo.getTranslationJobFeedback(id=42))

返り値

1{
2  "opstat": "ok",
3  "response": {
4    "feedback": {
5      "for_translator": "...",
6      "rating": 8
7    }
8  }
9}

Comments (GET)

概要 :

特定案件のコメント内容を取得します。

URL :

http://api.gengo.com/v2/translate/job/{id}/comments

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

データ引数 :

  • id (必須) - 案件ID

注意 : "author"として可能な値は、"customer" または "worker" になります。

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13print(gengo.getTranslationJobComments(id=42))

返り値

 1{
 2  "opstat": "ok",
 3  "response": {
 4    "thread": [
 5      {
 6        "body": "....",
 7        "author": "translator",
 8        "ctime": 1266322028
 9      },
10      {
11        "body": "....",
12        "author": "customer",
13        "ctime": 1266324432
14      }
15    ]
16  }
17}

Comment (POST)

概要 :

案件に新規コメントを追加します。

URL :

http://api.gengo.com/v2/translate/job/{id}/comment

認証 :

必須

パラメータ :

  • api_key (必須) - お客様の API key

  • api_sig (必須) - お客様の API signature

  • ts (必須) - 現在のUNIX時間のInteger (整数型)

データ引数 :

  • id (必須) - 案件ID

  • body (必須) - コメント本文

呼び出し例

 1#!/usr/bin/python
 2# -*- coding: utf-8 -*-
 3
 4from gengo import Gengo
 5
 6
 7gengo = Gengo(
 8    public_key='your_public_key',
 9    private_key='your_private_key',
10    sandbox=False,
11    debug=False)
12
13gengo.postTranslationJobComment(
14    id=42,
15    comment={
16        'body': 'I love lamp!'
17    }
18)

返り値

1{
2  "opstat": "ok",
3  "response": {
4
5  }
6}