# generaltranslation: General Translation Core SDK: setConfig
URL: https://generaltranslation.com/it/docs/core/class/set-config.mdx
---
title: setConfig
description: Riferimento dell'API per il metodo setConfig di GT
---

## Panoramica

Il metodo `setConfig` aggiorna la configurazione di un'istanza GT esistente.
Ti consente di modificare le credenziali API, le impostazioni regionali e altre opzioni dopo la creazione dell'istanza.

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

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

Il metodo `setConfig` convaliderà tutti i codici locale forniti e li integrerà con l'eventuale configurazione esistente passata al costruttore.

***


## Riferimento

### Parametri

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

L&#39;oggetto `GTConstructorParams` supporta le stesse proprietà del costruttore:

| Proprietà       | Tipo            | Facoltativo | Descrizione                                                          |
| --------------- | --------------- | ----------- | -------------------------------------------------------------------- |
| `apiKey`        | `string`        | ✓           | Chiave API di produzione per il servizio di traduzione               |
| `devApiKey`     | `string`        | ✓           | Chiave API di sviluppo                                               |
| `projectId`     | `string`        | ✓           | Identificatore univoco del progetto                                  |
| `sourceLocale`  | `string`        | ✓           | Impostazione regionale di origine predefinita per le traduzioni      |
| `targetLocale`  | `string`        | ✓           | Impostazione regionale di destinazione predefinita per le traduzioni |
| `locales`       | `string[]`      | ✓           | Array di codici locale supportati                                    |
| `baseUrl`       | `string`        | ✓           | URL di base dell&#39;API personalizzato                              |
| `customMapping` | `CustomMapping` | ✓           | Mappature personalizzate dei codici locale                           |

### Restituisce

`void` - Il metodo aggiorna la configurazione dell&#39;istanza sul posto.

***

## Esempio

In questo esempio, cambiamo l&#39;impostazione regionale di destinazione dallo spagnolo al francese.

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

// Passa al francese
gt.setConfig({
  targetLocale: 'fr'
});
```

***


## Note

* Le modifiche alla configurazione hanno effetto immediato sulle chiamate ai metodi successive
* Le variabili d&#39;ambiente non vengono rilette quando si chiama `setConfig`
* Le mappature personalizzate sostituiscono completamente quelle esistenti (non vengono unite)
* L&#39;aggiornamento **non è atomico** — se la convalida fallisce a metà (ad esempio, sulla seconda impostazione regionale), le proprietà precedenti potrebbero essere già state impostate
* Il metodo è sincrono e restituisce `void`

## Passaggi successivi

* **[Inizializzare con il costruttore](/docs/core/class/constructor)**
* **[Iniziare a tradurre i contenuti](/docs/core/class/methods/translation/translate)**
* **[Scoprire GTConstructorParams](/docs/core/types/gt-constructor-params)**