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

title: gt upload
description: ソースファイルと翻訳を General Translation プラットフォームにアップロードします。`gt upload` コマンドの API リファレンス。

---

プロジェクトのソースファイルと既存の翻訳を General Translation プラットフォームにアップロードし、ローカルファイルを同期して、管理・キューへの追加・追跡を行えるようにします。[`gt enqueue`](/docs/cli/reference/commands/enqueue) および [`gt download`](/docs/cli/reference/commands/download) と組み合わせることで、翻訳処理を CI の各ステージに分割できます。詳しくは [翻訳を管理する](/docs/cli/guides/managing-translations#split) を参照してください。

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

```bash
npx gt upload
```

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

1. `gt.config.json` を読み取り、どのファイルをアップロードするかを判定します。
2. 翻訳可能なすべてのソースファイルを収集します。
3. 各ファイルをハッシュ化して、`fileId` (パスから) と `versionId` (内容から) を生成します。
4. API に問い合わせて、どのファイルが新規または変更されたものかを判定します。
5. ファイルの移動 (内容は同じでパスが異なるもの) を検出し、既存の翻訳を保持します。
6. 新規または変更されたソースファイルを、ローカル翻訳の翻訳ファイルとともにアップロードします。

## フラグ [#flags]

`upload` は [`gt translate`](/docs/cli/reference/commands/translate#flags) と同じフラグを受け付けます。以下はその中でも特によく使われるものです。完全な一覧は、上記リンク先のリファレンスを参照してください。

| パラメータ                       | 説明                             | 型          | 任意  | デフォルト            |
| --------------------------- | ------------------------------ | ---------- | --- | ---------------- |
| `--api-key <key>`           | 本番用の API キー。                   | `string`   | Yes | `GT_API_KEY`     |
| `--project-id <id>`         | プロジェクト ID。                     | `string`   | Yes | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | 設定ファイルのパス。                     | `string`   | Yes | `gt.config.json` |
| `--locales <locales...>`    | 追加の対象ロケール。設定の locales に追記されます。 | `string[]` | Yes | —                |
| `--default-locale <locale>` | プロジェクトのソースロケール。                | `string`   | Yes | `en`             |
| `--timeout <seconds>`       | リクエストのタイムアウト時間 (秒) 。           | `number`   | Yes | `900`            |
| `--dry-run`                 | ファイルを収集し、アップロードせずに一覧表示します。     | `boolean`  | Yes | `false`          |

## 例 [#example]

```bash
# ステージ1: ソースファイルをアップロードする（このコマンド）
npx gt upload

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

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

## その他のメモ [#notes]

* `upload` は、設定されているあらゆる種類の翻訳可能なソースファイル (JSON、YAML、Markdown、MDX など) と、ローカル翻訳ファイルを収集します。
* 各ファイルはパスと内容に基づいてハッシュ化されるため、ファイルを移動しても (内容が同じでパスだけが変わった場合) 、再翻訳されず既存の翻訳がそのまま引き継がれます。