# General Translation Platform: setConfig
URL: https://generaltranslation.com/fr/docs/platform/core/reference/gt-class/set-config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Met à jour la configuration d'une instance GT existante. Référence de l'API pour setConfig.

Modifiez les identifiants d'API, les locales et d'autres paramètres d'une instance [GT](/docs/platform/core/reference/gt-class/constructor) après sa création, sans en créer une nouvelle.

## Vue d’ensemble [#overview]

Appelez `setConfig` pour modifier une instance sur place. Les nouvelles valeurs sont fusionnées avec la configuration fournie au constructeur et s’appliquent à tous les appels de méthode ultérieurs.

```typescript
const gt = new GT();

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

Signature :

```typescript
setConfig(params: GTConstructorParams): void
```

*Remarque : `setConfig` est synchrone et renvoie `void` ; il modifie l’instance sur place.*

## Fonctionnement [#how-it-works]

* **Identités configurées.** L’orthographe des codes de langue est préservée. Tous les champs de code de langue fournis, y compris `locales`, sont validés par rapport au mapping personnalisé effectif. Les codes invalides lèvent une exception. Les codes de langue renvoyés suivent les [règles du constructeur](/docs/platform/core/reference/gt-class/constructor#how-it-works).
* **Modification des identifiants.** Utilisez cette méthode pour changer d’identifiants ou modifier les paramètres du projet. L’affectation directe des propriétés n’est pas prise en charge pour ces modifications.
* **Fusion de la configuration.** Les nouvelles valeurs sont fusionnées avec la configuration transmise au constructeur. En revanche, `customMapping` remplace entièrement tout mapping existant au lieu d’être fusionné.
* **Aucune relecture de l’environnement.** Les variables d’environnement (`GT_API_KEY`, `GT_DEV_API_KEY`, `GT_PROJECT_ID`) ne sont pas relues lors de l’appel à `setConfig`.
* **Échec d’une mise à jour.** Si une mise à jour échoue, certains paramètres peuvent déjà avoir été modifiés.

## Paramètres [#parameters]

`setConfig` accepte un objet [`GTConstructorParams`](/docs/platform/core/reference/types/gt-constructor-params) obligatoire, avec les mêmes propriétés que le [constructeur](/docs/platform/core/reference/gt-class/constructor) :

| Paramètre                          | Description                                                                 | Type                                                                  | Facultatif | Par défaut |
| ---------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------- | ---------- |
| [`apiKey`](#api-key)               | Clé API de projet pour le service de traduction.                            | `string`                                                              | Oui        | —          |
| [`devApiKey`](#dev-api-key)        | Clé API de projet alternative, utilisée lorsque `apiKey` n’est pas définie. | `string`                                                              | Oui        | —          |
| [`projectId`](#project-id)         | Identifiant unique du projet.                                               | `string`                                                              | Oui        | —          |
| [`sourceLocale`](#source-locale)   | Paramètre régional source par défaut pour les traductions.                  | `string`                                                              | Oui        | —          |
| [`targetLocale`](#target-locale)   | Paramètre régional cible par défaut pour les traductions.                   | `string`                                                              | Oui        | —          |
| [`locales`](#locales)              | Codes de langue pris en charge.                                             | `string[]`                                                            | Oui        | —          |
| [`baseUrl`](#base-url)             | URL de base de l’API personnalisée.                                         | `string`                                                              | Oui        | —          |
| [`customMapping`](#custom-mapping) | Mappings personnalisés des codes de langue et remplacements de propriétés.  | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Oui        | —          |

L’objet `params` est lui-même requis, mais toutes ses propriétés sont facultatives — ne fournissez que les paramètres que vous souhaitez modifier.

### `apiKey` [#api-key]

**Type** `string` · **Facultatif**

Clé API de projet pour le service de traduction.

### `devApiKey` [#dev-api-key]

**Type** `string` · **Facultatif**

Alias de compatibilité déprécié pour `apiKey`. Utilisé lorsque `apiKey` n'est pas définie, quel que soit l'environnement.

### `projectId` [#project-id]

**Type** `string` · **Facultatif**

Identifiant unique du projet.

### `sourceLocale` [#source-locale]

**Type** `string` · **Facultatif**

Paramètre régional source par défaut des traductions. Son orthographe est préservée, et sa validité est vérifiée à l'aide du `customMapping` effectif, alias compris.

### `targetLocale` [#target-locale]

**Type** `string` · **Facultatif**

Paramètre régional cible par défaut pour les traductions. Son orthographe est préservée, et sa validité est vérifiée en tenant compte du `customMapping` effectif, alias compris.

### `locales` [#locales]

**Type** `string[]` · **Facultatif**

Tableau des identités de paramètres régionaux prises en charge. Chaque code est préservé et validé en tenant compte du `customMapping` effectif ; les alias personnalisés sont acceptés.

### `baseUrl` [#base-url]

**Type** `string` · **Facultatif**

URL de base personnalisée pour l’API.

### `customMapping` [#custom-mapping]

**Type** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Facultatif**

Mappings personnalisés des codes de langue et remplacements de propriétés. Contrairement aux autres paramètres, un nouveau `customMapping` remplace entièrement le mapping existant au lieu de le fusionner.

## Renvoie [#returns]

**Type** `void`

La méthode met à jour la configuration de l’instance sur place et ne renvoie rien.

## Exemples [#examples]

```typescript
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es',
});

// Changer le paramètre régional cible de l'espagnol vers le français
gt.setConfig({
  targetLocale: 'fr',
});
```

## Notes [#notes]

* Les modifications de configuration prennent effet immédiatement pour les appels de méthode suivants.
* Les identités de paramètres régionaux configurées sont préservées et validées avec le mapping personnalisé en vigueur, y compris les entrées de `locales`.
* Les chaînes de caractères vides ou `undefined` n’effacent pas les identifiants.
* Les variables d’environnement ne sont pas relues lors de l’appel à `setConfig`.
* Les mappings personnalisés remplacent entièrement les mappings existants (ils ne sont pas fusionnés).
* Si une mise à jour échoue, certains paramètres peuvent déjà avoir été modifiés.
* La méthode est synchrone et renvoie `void`.

## Sitemap

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