ペイロード

翻訳APIで行う処理の大半は、案件のペイロードに関連しています。案件のペイロードは、その翻訳案件のインスタンスを示すシンプルなコンテナです。

レスポンスのペイロード

パラメータ 必須 タイプ 説明
job_id YES Integer 案件ID
order_id YES Integer ご注文ID
body_src YES String 原文テキスト (翻訳したいテキスト)。
body_tgt YES String 訳文テキスト (存在する場合)。
lc_src YES String ソース言語コード。GengoではIETFコードを使って言語と言語ペアを定義します
lc_tgt YES String ターゲット言語コード
unit_count YES Integer ソース言語のユニット数(ソース言語によってワード数または文字数のいずれか)
tier YES String 品質レベル(「スタンダード」または「プロ」)
credits YES Float 言語ペアとレベルに応じたクレジット額。
status YES String 案件の現在のステータス。「新着案件」、「保留中」、「レビュー可」、「修正中」、「承認済み」、または「キャンセル済み」。
captcha_url YES String キャプチャ画像へのフルURL。案件が「レビュー可」状態にあり、その案件を拒否したい場合のみ使用されます。
eta YES Integer 完了までの予測残り時間(秒)。
callback_url YES String システム更新情報(完了した案件、新しいコメント等)を送信する先のフルURL。
auto_approve YES Bool(1/0) 案件が翻訳完了後に自動的に承認されるかどうか。
ctime YES String この案件が(トランスレーターではなく、お客様によって)提出された時のUNIXタイムスタンプ。
custom_data YES String この案件にマップすることで役立つ可能性のある、クライアント特有データの最大1Kのストレージ
file_url_src   String ソースファイルのフルURL(コールバックと共に返されます)。
file_url_tgt   String 翻訳済みファイルのフルURL(コールバックと共に返されます)。

リクエストのペイロード

パラメータ 必須 タイプ 説明
body_src YES String 原文テキスト (翻訳したいテキスト)。
lc_src YES String ソース言語コード。GengoではIETFコードを使って言語と言語ペアを定義します
lc_tgt YES String ターゲット言語コード
tier YES String 品質レベル(「スタンダード」または「プロ」)
type YES String type : 文字列 案件の種類。’text’ (デフォルト) か ‘file’ のいずれかになります。’file’ を選んでファイル案件をご注文になるときは file quote 機能から生成したjob identifierを別途指定してください。
slug YES String 案件タイトル。内部保管目的。一般的なものでも可。
identifier もし``type``がfileの場合 String ファイルクォートメソッドからのレスポンスとして返される識別子(例: 識別子= 「2ea3a2dbea3be97375ceaf03200fb184」)
glossary_id   Integer 使用したい用語集のID
position   Integer 案件グループ内の案件の位置。1から始まるこの値により、案件グループがトランスレーターに表示される際、表示順序が維持されます。
force   Bool(1/0) 重複検出をオーバーライドし新しい翻訳を強制するかしないか。(その用語が以前に翻訳されたものであっても常に新しい翻訳が返されます)
comment   String 翻訳者が翻訳する際に考慮すべき指示やコメント。翻訳者にできるだけ詳細なコメントを提供されることを強くお勧めします
attachments   Array それぞれの attachment は Dictionary として以下の 必須 項目を全て含み、 Dictonaries に含まれます。
パラメータ タイプ 説明
url String 案件への追加コンテンツを提供する外部ファイルへのリンク。 http(s)スキームの公開URLのみ対応。
filename String 添付したい外部ファイルの名前 ex| ‘image.jpg’/’video.mp4’/’audio.mpeg’/...
mime_type String 以下のMIMEタイプによりトランスレーターにプレビューが表示されます: image/bmp|jpg|jpeg|png|gif、video/mp4、audio/mpeg。その他のMIMEタイプはトランスレーターにダウンロードリンクを表示します。
purpose   String 翻訳の目的を説明 ex|“個人使用/ビジネス/オンラインコンテンツ/ウェブまたはアプリローカリゼーション/その他...
tone   String 翻訳のトーンを説明 ex| “堅苦しくない/フレンドリー/ビジネス/フォーマル/その他...
use_preferred   Bool(1/0) そのアカウントと関連のある、お気に入りトランスレーターリストからのトランスレーターを使うかどうか
callback_url   String システム更新情報(完了した案件、新しいコメント等)を送信する先のフルURL。
auto_approve   Bool(1/0) 案件が翻訳された後に自動的に承認されるかどうか。デフォルトはFalseに設定されています。Falseの場合、完了した案件はその後72時間お客様によるレビューおよび承認待ちとなります。
custom_data   String この案件にマップすることで役立つ可能性のある、クライアント特有データの最大1Kのストレージ
max_chars   Integer 翻訳の文字数制限を表示。常に0を超える数字である必要があります
as_group   Bool(1/0) デフォルトで、同じ言語ペアとレベルの案件は一つのグループとして一人のトランスレーターにアサインされます。もし as_group0 としてセットすろと、それぞれの案件は違うトランスレーターに割当られます。