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

title: gt download
description: Télécharge les traductions terminées à partir de General Translation. Référence de l’API pour la commande gt download.

---

Télécharge les traductions terminées qui ont été précédemment envoyées en traduction avec [`gt enqueue`](/docs/cli/reference/commands/enqueue) ou [`gt stage`](/docs/cli/reference/commands/stage), et les enregistre dans les chemins de sortie définis dans votre configuration. Voir [Gérer les traductions](/docs/cli/guides/managing-translations#split).

*Remarque : à utiliser en production uniquement. Nécessite une `GT_API_KEY` et un `GT_PROJECT_ID` de production.*

```bash
npx gt download
```

## Fonctionnement [#how-it-works]

1. Lit `gt.config.json` pour déterminer la configuration des fichiers.
2. Lit les données de la version mise en attente lorsque `stageTranslations` est activé ; sinon, collecte les fichiers et calcule leur hachage afin de déterminer ce qu’il faut télécharger.
3. Interroge l’API de General Translation pour récupérer les traductions terminées.
4. Enregistre les fichiers de traduction aux chemins de sortie définis dans votre configuration.

## Options [#flags]

`download` accepte l’ensemble complet des options de [`gt translate`](/docs/cli/reference/commands/translate#flags), à l’exception des options d’analyse du code source (`--src`, `--dictionary`, `--tsconfig`/`--jsconfig`, `--inline`, `--ignore-errors`), qui ne s’appliquent que lors de l’analyse du code source. Toutes les options ci-dessous sont acceptées ; celles qui ont un effet dans le cadre d’un téléchargement uniquement sont les options d’API, de configuration, de délai d’attente, de téléchargement et de branche.

| Paramètre                    | Description                                                                                                     | Type       | Facultatif | Par défaut         |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------- | ---------- | ------------------ |
| `--api-key <key>`            | Clé API de production.                                                                                          | `string`   | Oui        | `GT_API_KEY`       |
| `--project-id <id>`          | ID de projet.                                                                                                   | `string`   | Oui        | `GT_PROJECT_ID`    |
| `--version-id <id>`          | ID de la version à télécharger.                                                                                 | `string`   | Oui        | Hachage de contenu |
| `-c, --config <path>`        | Chemin vers le fichier de configuration.                                                                        | `string`   | Oui        | `gt.config.json`   |
| `--default-locale <locale>`  | Paramètre régional source du projet.                                                                            | `string`   | Oui        | `en`               |
| `--locales <locales...>`     | Paramètres régionaux cibles supplémentaires, ajoutés à ceux de la configuration.                                | `string[]` | Oui        | —                  |
| `--timeout <seconds>`        | Délai d’attente en secondes.                                                                                    | `number`   | Oui        | `900`              |
| `--dry-run`                  | Analyse et valide sans appeler l’API.                                                                           | `boolean`  | Oui        | `false`            |
| `--force`                    | Invalide les traductions en cache et relance la traduction.                                                     | `boolean`  | Oui        | `false`            |
| `--force-download`           | Écrase les fichiers locaux en contournant les vérifications de `gt-lock.json`.                                  | `boolean`  | Oui        | `false`            |
| `--save-local`               | Détecte et enregistre les modifications locales avant le téléchargement.                                        | `boolean`  | Oui        | `false`            |
| `--publish`                  | Publie les traductions sur le CDN.                                                                              | `boolean`  | Oui        | `false`            |
| `--enable-branching`         | Active le suivi basé sur les branches.                                                                          | `boolean`  | Oui        | —                  |
| `--branch <branch>`          | Nom de la branche à utiliser au lieu de la détecter automatiquement.                                            | `string`   | Oui        | —                  |
| `--disable-branch-detection` | Utilise uniquement la branche spécifiée, sans détection des relations.                                          | `boolean`  | Oui        | `false`            |
| `--remote-name <name>`       | Remote Git utilisée pour la détection de branche.                                                               | `string`   | Oui        | `origin`           |
| `--tag [value]`              | Ajoute un tag à l’exécution ; est déterminé automatiquement à partir de Git lorsqu’aucune valeur n’est fournie. | `string`   | Oui        | —                  |
| `-m, --message <message>`    | Message associé au tag de traduction.                                                                           | `string`   | Oui        | —                  |

`download` accepte également les options expérimentales listées sous [`gt translate`](/docs/cli/reference/commands/translate#experimental) (par exemple `--experimental-clear-locale-dirs`, qui efface les répertoires de paramètres régionaux avant d’écrire de nouvelles traductions).

## Exemple [#example]

```bash
# Étape 1 : upload des fichiers source
npx gt upload

# Étape 2 : mettre en attente les traductions
npx gt enqueue

# Étape 3 : télécharger les traductions terminées (cette commande)
npx gt download
```

## Autres remarques [#notes]

* Lorsque `stageTranslations` est activé, `download` lit les données de la version mise en attente ; sinon, il collecte les fichiers et en calcule le hachage pour déterminer ce qu’il faut télécharger.
* `download` interroge l’API jusqu’à ce que les traductions soient prêtes ou que le délai `--timeout` soit atteint, ce qui lui permet de s’exécuter dans une tâche CI ultérieure à [`gt enqueue`](/docs/cli/reference/commands/enqueue).