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#!/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.getTranslationOrderJobs(id=232))

返り値

 1{
 2  "opstat": "ok",
 3  "response": {
 4    "order": {
 5      "jobs_queued": 0,
 6      "jobs_reviewable": [
 7
 8      ],
 9      "jobs_available": [
10        "243646",
11        "243647",
12        "243645"
13      ],
14      "jobs_pending": [
15
16      ],
17      "jobs_approved": [
18
19      ],
20      "jobs_revising": [
21
22      ],
23      "jobs_cancelled": [
24
25      ],
26      "jobs_held": [
27
28      ],
29      "order_id": "232",
30      "total_credits": "0.30",
31      "total_units": 6,
32      "total_jobs": "3",
33      "currency": "USD"
34    }
35  }
36}

Order (DELETE)

概要 :

ご注文に含まれる翻訳者待ちの案件を全てキャンセルします。ご注文のキャンセルは、翻訳者がすでに着手している案件はキャンセルできませんのでご注意ください。 (例: 保留中, レビュー可, 等)

URL :

http://api.gengo.com/v2/translate/order/{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
13gengo.deleteTranslationOrder(id=42)

返り値

 1{
 2  "opstat": "ok",
 3  "response": {
 4    "order": {
 5      "jobs_queued": 0,
 6      "jobs_reviewable": [
 7          "243648"
 8      ],
 9      "jobs_available": [
10
11      ],
12      "jobs_cancelled": [
13          "243646",
14          "243647",
15          "243645"
16      ],
17      "jobs_pending": [
18
19      ],
20      "jobs_approved": [
21
22      ],
23      "order_id": "232",
24      "total_credits": "0.80",
25      "total_units": 10,
26      "total_jobs": "4",
27      "jobs_revising": [
28
29      ],
30      "currency": "USD"
31    }
32  }
33}

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#!/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.getOrderComments(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/order/{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.postOrderComment(
14    id=42,
15    comment={
16        'body': 'I love lamp!'
17    }
18)

返り値

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