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
 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)

gengo.getTranslationJob(id=42)

返り値

 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": {
    "job": {
      "job_id": 384985,
      "credits": 0.05,
      "auto_approve": 0,
      "eta": 25056,
      "order_id": 54632,
      "lc_tgt": "ja",
      "unit_count": 1,
      "lc_src": "en",
      "slug": "APIJobtest",
      "callback_url": "http://gengo.callback/",
      "currency": "USD",
      "tier": "standard",
      "body_src": "This is text.",
      "body_tgt": "これはテキストです。",
      "ctime": 1313475693,
      "status": "available"
    }
  }
}

Job (PUT)

概要 :
Updates a job to translate. Request should be no larger than 100MB. Comments should not exceed more than 25,000 characters.
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 (必須)
  • captcha (必須) CAPTCHAイメージで表示するテキスト 。
  • captcha_url - それぞれ ``captcha_url``値 (CAPTCHAイメージのURL) が与えられます。 この値が必要になるのは、案件を拒否する場合だけです。CAPTCHAを間違えてしまった場合には、新しいCAPTCHAのURL がエラーメッセージに含まれます。
  • follow_up (任意) “requeue” (デフォルト) か “cancel” のいずれかになります。”requeue” を選択した場合、案件は拒否され、別の翻訳者に再依頼されます。”cancel” を選択した場合、案件は拒否した時点で完全にキャンセルとなります。

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

呼び出し例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
#!/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)

gengo.updateTranslationJob(
    id=42,
    action={
        'action': 'reject',
        'reason': 'quality',
        'comment': 'My grandmother does better.',
        'captcha': 'BERT'
    }
)

返り値

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

  }
}

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
 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)

gengo.deleteTranslationJob(id=42)

返り値

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

  }
}

Revisions (GET)

概要 :
特定の案件について、修正リソースのリストを入手します。修正は、翻訳者またはシニア翻訳者がテキストをアップデートするつど作成されます。
URL :
http://api.gengo.com/v2/translate/job/{id}/revisions
認証 :
必須
パラメータ :
  • api_key (必須) - お客様の API key
  • api_sig (必須) - お客様の API signature
  • ts (必須) - 現在のUNIX時間のInteger (整数型)

呼び出し例

 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.getTranslationJobRevisions(id=42))

返り値

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

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
 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.getTranslationJobRevision(id=42, rev_id=1))

返り値

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

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
 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.getTranslationJobFeedback(id=42))

返り値

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

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
 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.getTranslationJobComments(id=42))

返り値

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

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
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
#!/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)

gengo.postTranslationJobComment(
    id=42,
    comment={
        'body': 'I love lamp!'
    }
)

返り値

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

  }
}