# gt: General Translation CLI tool: gt download
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/download.mdx
Docs index: https://generaltranslation.com/llms.txt
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. 翻訳ファイルを設定内の出力パスに保存します。

まだ処理中のファイルはスキップされます。後で取得するには `gt download` を再実行してください。

## フラグ [#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>`             | project ID。                                   | `string`   | はい | `GT_PROJECT_ID`  |
| `--version-id <id>`             | ダウンロードするバージョン ID。                             | `string`   | はい | Content hash     |
| `-c, --config <path>`           | 設定 file のパス。                              | `string`   | はい | `gt.config.json` |
| `--default-locale <locale>`     | プロジェクトの source ロケール。                          | `string`   | はい | `en`             |
| `--locales <locales...>`        | 追加の対象ロケール。設定 の locales に追加されます。           | `string[]` | はい | —                |
| `--timeout <seconds>`           | 待機タイムアウト (秒) 。                                | `number`   | はい | `900`            |
| `--dry-run`                     | API を呼び出さずに、解析と検証のみを行います。                     | `boolean`  | はい | `false`          |
| `--force`                       | キャッシュ済みの翻訳を無効化し、再翻訳します。                       | `boolean`  | はい | `false`          |
| `--force-download`              | `gt-lock.json` のチェックをスキップしてローカルファイルを上書きします。   | `boolean`  | はい | `false`          |
| `--save-local, --no-save-local` | 共通フラグパーサーでは受け付けられますが、ダウンロードのみの実行中には編集を保存しません。 | `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 ジョブより後のジョブで実行できます。
* ステージ済みファイルは、設定されているすべてのロケールがダウンロードされるまで、`gt-lock.json` 内でステージ済みのままになります。
* `_versionId` が必要なのは、ダウンロードにインライン GTJSON テンプレートが含まれ、かつ `omitConfigIds` が `false` の場合のみです。Lottie 専用のプロジェクトを含む、ファイルのみのプロジェクトでは必要ありません。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.