# generaltranslation: General Translation Core SDK: Constructeur GT
URL: https://generaltranslation.com/fr/docs/core/class/constructor.mdx
---
title: Constructeur GT
description: Référence de l’API pour le constructeur de la classe GT
---

## Vue d’ensemble

Le constructeur `GT` crée une nouvelle instance de la classe General Translation, qui donne accès à toutes les fonctionnalités de traduction, de mise en forme et liées au paramètre régional.

```typescript
import { GT } from 'generaltranslation';

const gt = new GT({
  apiKey: 'your-api-key',
  projectId: 'your-project-id',
  sourceLocale: 'en',
  targetLocale: 'es'
});
```

Le constructeur vérifiera automatiquement dans l'environnement la présence des variables d'environnement `GT_API_KEY`, `GT_DEV_API_KEY` et `GT_PROJECT_ID`, vous pouvez donc les omettre des paramètres du constructeur.
De plus, il validera tous les codes de langue fournis.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "params": {
    type: 'GTConstructorParams',
    optional: true,
    default: '{}',
  }
}}
/>

L’objet `GTConstructorParams` accepte les propriétés suivantes :

| Propriété       | Type            | Optionnel | Description                                                              |
| --------------- | --------------- | --------- | ------------------------------------------------------------------------ |
| `apiKey`        | `string`        | ✓         | Clé API de production pour le service de traduction                      |
| `devApiKey`     | `string`        | ✓         | Clé API de développement (prioritaire en environnement de développement) |
| `projectId`     | `string`        | ✓         | Identifiant unique du projet                                             |
| `sourceLocale`  | `string`        | ✓         | Paramètre régional source par défaut pour les traductions                |
| `targetLocale`  | `string`        | ✓         | Paramètre régional cible par défaut pour les traductions                 |
| `locales`       | `string[]`      | ✓         | Tableau des codes de langue pris en charge                               |
| `baseUrl`       | `string`        | ✓         | URL de base de l’API personnalisée (pour les déploiements Enterprise)    |
| `customMapping` | `CustomMapping` | ✓         | Mappages et définitions personnalisés des codes de langue                |

### Renvoie

Une nouvelle instance de la classe `GT`, avec toutes les méthodes de traduction et de gestion des paramètres régionaux disponibles.

***

## Exemples

### Utilisation de base

```typescript
import { GT } from 'generaltranslation';

// Configuration minimale - utilise les variables d'environnement
const gt = new GT();
```


### Avec des identifiants d’API

```typescript
const gt = new GT({
  projectId: 'my-project-id',
  apiKey: 'my-api-key',
  targetLocale: 'fr'
});
```


### Avec un mappage personnalisé des paramètres régionaux

Il est possible de fournir un mappage personnalisé.
Cela permet à l’utilisateur (1) d’utiliser des alias pour les codes de langue, (2) de remplacer la validation BCP 47 standard et (3) de remplacer les informations BCP 47 standard du paramètre régional.

Par exemple, supposons que vous souhaitiez utiliser `cn` comme alias de `zh`.
Comme l’API General Translation ne prend pas en charge `cn`, vous devez spécifier un mappage personnalisé.

```typescript
const gt = new GT({
  projectId: 'my-project-id',
  apiKey: 'my-api-key',
  targetLocale: 'es',
  customMapping: {
    'cn': { code: 'zh' }
  }
});
```

Vous pouvez aussi faire d’autres choses avec les mappages personnalisés, comme ajouter des noms ou des émojis personnalisés, etc.

```typescript
const gt = new GT({
  projectId: 'my-project-id',
  apiKey: 'my-api-key',
  targetLocale: 'es',
  customMapping: { 'en-US': { name: 'Mandarin', emoji: '🇫🇷' } }
});
```

***


## Remarques

* Tous les paramètres sont facultatifs, mais les opérations de l’API nécessitent `apiKey` et `projectId`
* Le constructeur valide immédiatement tous les codes de langue et génère une erreur si l’un d’eux est invalide
* Les mappages personnalisés priment sur la validation BCP 47 standard

## Prochaines étapes

* Configurez votre instance avec [`setConfig`](/docs/core/class/set-config)
* Commencez à traduire avec [`translate`](/docs/core/class/methods/translation/translate)
* Découvrez le type [`GTConstructorParams`](/docs/core/types/gt-constructor-params)