Order methods

ここでは、ご注文をGengo API上で扱うエンドポイントをご説明しています。

Order (GET)

概要 :
ご注文IDを指定し、以前に一緒にご注文いただいた案件のセットを取得します。
URL :
http://api.gengo.com/v2/translate/order/{order_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.getTranslationOrderJobs(id=232))

返り値

 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
{
  "opstat": "ok",
  "response": {
    "order": {
      "jobs_queued": 0,
      "jobs_reviewable": [

      ],
      "jobs_available": [
        "243646",
        "243647",
        "243645"
      ],
      "jobs_pending": [

      ],
      "jobs_approved": [

      ],
      "order_id": "232",
      "total_credits": "0.30",
      "total_units": 6,
      "total_jobs": "3",
      "jobs_revising": [

      ],
      "currency": "USD"
    }
  }
}

Order (DELETE)

概要 :
ご注文に含まれる翻訳者待ちの案件を全てキャンセルします。案件のキャンセルは、翻訳者がまだ案件に着手していない場合のみご利用いただけますのでご注意ください。これを実行すると、ご注文自体もキャンセルします。
URL :
http://api.gengo.com/v2/translate/order/{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)

gengo.deleteTranslationOrder(id=42)

返り値

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

  }
}

Comments (GET)

概要 :
特定案件のコメント内容を取得します。
URL :
http://api.gengo.com/v2/translate/order/{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.getTranslationOrderComments(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/order/{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.postOrderComment(
    id=42,
    comment={
        'body': 'I love lamp!'
    }
)

返り値

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

  }
}