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

title: gt download
description: General Translation から完了した翻訳をダウンロードします。gt download コマンドの API リファレンス。

---

[`gt enqueue`](/docs/cli/reference/commands/enqueue) または [`gt stage`](/docs/cli/reference/commands/stage) で以前翻訳に送信した完了済みの翻訳をダウンロードし、設定ファイルで指定した出力パスに保存します。詳細は [翻訳を管理する](/docs/cli/guides/managing-translations#split) を参照してください。

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

```bash
npx gt download
```

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

1. `gt.config.json` を読み込み、ファイル設定を特定します。
2. `stageTranslations` が有効な場合はステージ済みバージョンのデータを読み込み、無効な場合はダウンロード対象を特定するためにファイルを収集してハッシュ化します。
3. 完了した翻訳がないか General Translation API をポーリングします。
4. 翻訳ファイルを設定内の出力パスに保存します。

## フラグ [#flags]

`download` では、ソースコードのスキャン時にのみ使用されるソーススキャン用フラグ (`--src`, `--dictionary`, `--tsconfig`/`--jsconfig`, `--inline`, `--ignore-errors`) を除き、[`gt translate`](/docs/cli/reference/commands/translate#flags) のすべてのフラグを使用できます。以下のフラグはすべて指定可能ですが、`download` のみの実行に影響するのは API、設定、タイムアウト、ダウンロード、branch 関連のフラグです。

| パラメータ                        | 説明                                          | Type       | 任意 | デフォルト            |
| ---------------------------- | ------------------------------------------- | ---------- | -- | ---------------- |
| `--api-key <key>`            | 本番用の API キー。                                | `string`   | はい | `GT_API_KEY`     |
| `--project-id <id>`          | プロジェクト ID。                                  | `string`   | はい | `GT_PROJECT_ID`  |
| `--version-id <id>`          | ダウンロードするバージョン ID。                           | `string`   | はい | Content hash     |
| `-c, --config <path>`        | config file のパス。                            | `string`   | はい | `gt.config.json` |
| `--default-locale <locale>`  | プロジェクトの source ロケール。                        | `string`   | はい | `en`             |
| `--locales <locales...>`     | 追加の対象ロケール。config の locales に追加されます。         | `string[]` | はい | —                |
| `--timeout <seconds>`        | 待機タイムアウト (秒) 。                              | `number`   | はい | `900`            |
| `--dry-run`                  | API を呼び出さずに、解析と検証のみを行います。                   | `boolean`  | はい | `false`          |
| `--force`                    | キャッシュ済みの翻訳を無効化し、再翻訳します。                     | `boolean`  | はい | `false`          |
| `--force-download`           | `gt-lock.json` のチェックをスキップしてローカルファイルを上書きします。 | `boolean`  | はい | `false`          |
| `--save-local`               | ダウンロード前に local edits を検出して保存します。            | `boolean`  | はい | `false`          |
| `--publish`                  | 翻訳を CDN に公開します。                             | `boolean`  | はい | `false`          |
| `--enable-branching`         | branch ベースの追跡を有効にします。                       | `boolean`  | はい | —                |
| `--branch <branch>`          | 自動検出の代わりに branch 名を指定します。                   | `string`   | はい | —                |
| `--disable-branch-detection` | 関係性の検出を行わず、指定した branch のみを使用します。            | `boolean`  | はい | `false`          |
| `--remote-name <name>`       | branch 検出に使用する Git リモート。                    | `string`   | はい | `origin`         |
| `--tag [value]`              | 実行に tag を付けます。値を指定しない場合は git から自動的に解決されます。  | `string`   | はい | —                |
| `-m, --message <message>`    | 翻訳 tag に付与するメッセージ。                          | `string`   | はい | —                |

`download` では、[`gt translate`](/docs/cli/reference/commands/translate#experimental) に記載されている実験的フラグも使用できます (たとえば `--experimental-clear-locale-dirs` は、新しい翻訳を書き込む前にロケールディレクトリを消去します) 。

## 例 [#example]

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

# ステージ2: 翻訳をキューに追加する
npx gt enqueue

# ステージ3: 完了した翻訳をダウンロードする（このコマンド）
npx gt download
```

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

* `stageTranslations` が有効な場合、`download` はステージ済みバージョンのデータを読み取ります。無効な場合は、ダウンロード対象を判定するためにファイルを収集してハッシュ化します。
* `download` は、翻訳の準備が整うか `--timeout` に達するまで API をポーリングするため、[`gt enqueue`](/docs/cli/reference/commands/enqueue) を実行する CI ジョブより後のジョブで実行できます。