# gt: General Translation CLI tool: gt enqueue
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/enqueue.mdx
---

title: gt enqueue
description: 結果をダウンロードせずに、アップロード済みファイルを General Translation のキューに追加します。`gt enqueue` コマンドの API リファレンス。

---

事前にアップロードしたファイルを翻訳用のキューに追加し、結果を待ったりダウンロードしたりせずにすぐ終了します。[`gt upload`](/docs/cli/reference/commands/upload) と [`gt download`](/docs/cli/reference/commands/download) を組み合わせると、翻訳処理を CI の各ステージに分割できます。詳しくは[翻訳の管理](/docs/cli/guides/managing-translations#split)を参照してください。

*注: 本番環境でのみ使用できます。本番環境用の `GT_API_KEY` と `GT_PROJECT_ID` が必要です。*

```bash
npx gt enqueue
```

## 仕組み [#how-it-works]

1. `gt.config.json` を読み取り、翻訳対象のファイルを判定します。
2. コンテンツハッシュを使って、以前にアップロードされたファイルを特定します。
3. それらを General Translation API に送信して翻訳します。
4. 翻訳の完了を待たずに、すぐ終了します。

結果の準備ができたら、[`gt download`](/docs/cli/reference/commands/download) を実行してダウンロードします。

## フラグ [#flags]

`enqueue` では [`gt translate`](/docs/cli/reference/commands/translate#flags) と同じフラグを使用できます。以下に、特によく使うものを示します。全項目については、上記リンク先のリファレンスを参照してください。

| パラメータ                       | 説明                                 | 型          | 任意 | デフォルト            |
| --------------------------- | ---------------------------------- | ---------- | -- | ---------------- |
| `--api-key <key>`           | 本番用の API キー。                       | `string`   | はい | `GT_API_KEY`     |
| `--project-id <id>`         | プロジェクト ID。                         | `string`   | はい | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | 設定ファイルへのパス。                        | `string`   | はい | `gt.config.json` |
| `--locales <locales...>`    | 追加の対象ロケール。設定ファイルの locales に追記されます。 | `string[]` | はい | —                |
| `--default-locale <locale>` | プロジェクトのソース ロケール。                   | `string`   | はい | `en`             |
| `--timeout <seconds>`       | 秒単位のリクエストタイムアウト。                   | `number`   | はい | `900`            |
| `--dry-run`                 | API を呼び出さずに、解析と検証のみを行います。          | `boolean`  | はい | `false`          |

## 例 [#example]

```bash
# ステージ1: ソースファイルをアップロードする
npx gt upload

# ステージ2: アップロードしたファイルを翻訳キューに追加する
npx gt enqueue

# ステージ3: 結果の準備ができたらダウンロードする
npx gt download
```

## その他の注意点 [#notes]

`upload`、`enqueue`、`download` を分けるのは、各ステップを別々のステージやジョブで実行する CI/CD パイプラインで便利です。`enqueue` はすぐに制御が返るため、ダウンロードのステップは翻訳完了後に後続のジョブで実行できます。