# gt: General Translation CLI tool: ダウンロード
URL: https://generaltranslation.com/ja/docs/cli/download.mdx
---
title: ダウンロード
description: 以前にキューに追加した、またはステージングした翻訳をダウンロードする方法
---

## 使用方法

```bash
npx gt download
```

<Callout type="info">
  **注:** このコマンドの実行には本番環境用の API キーが必要です。API キーは
  [プラットフォーム](https://generaltranslation.com/dashboard)
  で取得できます。
</Callout>


## 概要

`gt download` コマンドは、[`gt enqueue`](/docs/cli/enqueue) または [`gt stage`](/docs/cli/stage) で以前に翻訳に送信した、完了済みの翻訳をダウンロードします。

一般的なワークフローは次のとおりです。

1. [`gt upload`](/docs/cli/upload) — ソースファイルを General Translation プラットフォームにアップロードする
2. [`gt enqueue`](/docs/cli/enqueue) — アップロードしたファイルを翻訳キューに追加する
3. **`gt download`** — 完了した翻訳をダウンロードする

このように処理を分けておくと、各ステップを別々のステージやジョブで実行する CI/CD パイプラインで便利です。

<Callout type="warn">
  **本番環境でのみ使用してください！**

  このコマンドは本番ビルド向けであり、**開発環境では使用しないでください**。
  環境変数には、本番用の API キー (`GT_API_KEY`) とプロジェクト ID (`GT_PROJECT_ID`) を必ず指定してください。
</Callout>

## 仕組み

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

## フラグ

`download` コマンドでは、[`translate`](/docs/cli/translate#flags) と同じフラグを使用できます。

| Parameter         | Description                         | Type     | Optional | Default            |
| ----------------- | ----------------------------------- | -------- | -------- | ------------------ |
| `--api-key`       | 本番用の API キーを指定します                   | `string` | `true`   |                    |
| `--project-id`    | プロジェクト ID を指定します                    | `string` | `true`   |                    |
| `--version-id`    | バージョン ID を指定します (デフォルトではコンテンツのハッシュ) | `string` | `true`   |                    |
| `--config <path>` | GT 設定ファイルのパスを指定します                  | `string` | `true`   | `"gt.config.json"` |

| `--timeout`                     | リクエストのタイムアウト時間 (秒) を指定します            | `number`   | `true`   | `900`              |
| `--new, --locales <locales>`    | プロジェクトの翻訳先となるロケールを指定します              | `[string]` | `true`   |                    |
| `--default-locale <locale>`     | プロジェクトのソース ロケールを指定します                | `string`   | `true`   | `en`               |
| `--dry-run`                     | コマンドをドライランで実行します                     | `flag`     | `true`   | `false`            |
| `--force`                       | すべての翻訳を強制的にダウンロードし、ローカルの変更を上書きします    | `flag`     | `true`   | `false`            |
| `--force-download`              | すべての翻訳を強制的にダウンロードし、ローカルの変更を上書きします    | `flag`     | `true`   | `false`            |

## 例: CI パイプラインを分割する

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

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

# ステージ 3: 準備完了後にダウンロード
npx gt download
```