# General Translation Platform: setConfig
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class/set-config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Aggiorna la configurazione di un'istanza GT esistente. API Reference di setConfig.

Modifica le credenziali API, le impostazioni regionali e altre impostazioni di un'istanza [GT](/docs/platform/core/reference/gt-class/constructor) dopo la sua creazione, senza crearne una nuova.

## Panoramica [#overview]

Usa `setConfig` per modificare un'istanza in-place. I nuovi valori vengono combinati con la configurazione passata al costruttore e si applicano a ogni successiva chiamata di metodo.

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

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

Firma:

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

*Nota: `setConfig` è sincrona, restituisce `void` e aggiorna l'istanza in-place.*

## Come funziona [#how-it-works]

* **Identità configurate.** La grafia delle impostazioni regionali viene mantenuta invariata. Tutti i campi relativi alle impostazioni regionali forniti, incluso `locales`, vengono validati rispetto al mapping personalizzato effettivo. I codici non validi sollevano un errore. I codici locale restituiti seguono le [regole del costruttore](/docs/platform/core/reference/gt-class/constructor#how-it-works).
* **Modifica delle credenziali.** Usa questo metodo per cambiare le credenziali o le impostazioni del progetto. Per queste modifiche non è supportata l'assegnazione diretta delle proprietà.
* **Merge della configurazione.** I nuovi valori vengono uniti alla configurazione passata al costruttore. `customMapping`, tuttavia, sostituisce completamente qualsiasi mapping esistente invece di essere unito.
* **Nessuna rilettura dell'ambiente.** Le variabili d'ambiente (`GT_API_KEY`, `GT_DEV_API_KEY`, `GT_PROJECT_ID`) non vengono lette di nuovo quando chiami `setConfig`.
* **Aggiornamenti non riusciti.** Se un aggiornamento non va a buon fine, alcune impostazioni potrebbero essere già state modificate.

## Parametri [#parameters]

`setConfig` accetta un oggetto [`GTConstructorParams`](/docs/platform/core/reference/types/gt-constructor-params) obbligatorio con le stesse proprietà del [costruttore](/docs/platform/core/reference/gt-class/constructor):

| Parametro                          | Descrizione                                                                 | Tipo                                                                  | Facoltativo | Predefinito |
| ---------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- | ----------- |
| [`apiKey`](#api-key)               | Chiave API del progetto per il servizio di traduzione.                      | `string`                                                              | Sì          | —           |
| [`devApiKey`](#dev-api-key)        | Chiave API del progetto alternativa, usata quando `apiKey` non è impostata. | `string`                                                              | Sì          | —           |
| [`projectId`](#project-id)         | Identificatore del progetto univoco.                                        | `string`                                                              | Sì          | —           |
| [`sourceLocale`](#source-locale)   | Impostazione regionale sorgente predefinita per le traduzioni.              | `string`                                                              | Sì          | —           |
| [`targetLocale`](#target-locale)   | Impostazione regionale di destinazione predefinita per le traduzioni.       | `string`                                                              | Sì          | —           |
| [`locales`](#locales)              | Codici locale supportati.                                                   | `string[]`                                                            | Sì          | —           |
| [`baseUrl`](#base-url)             | URL base dell'API personalizzato.                                       | `string`                                                              | Sì          | —           |
| [`customMapping`](#custom-mapping) | Mapping personalizzati dei codici locale e sovrascrittura delle proprietà.  | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          | —           |

L'oggetto `params` è obbligatorio, ma tutte le sue proprietà sono facoltative: passa solo le impostazioni che vuoi modificare.

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

**Tipo** `string` · **Facoltativo**

Chiave API del progetto per il servizio di traduzione.

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

**Tipo** `string` · **Facoltativo**

Alias deprecato di `apiKey`, mantenuto per compatibilità. Viene utilizzato quando `apiKey` non è impostata, indipendentemente dall'ambiente.

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

**Tipo** `string` · **Facoltativo**

Identificatore univoco del progetto.

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

**Tipo** `string` · **Facoltativo**

Impostazione regionale sorgente predefinita per le traduzioni. La sua grafia viene mantenuta invariata e validata con il `customMapping` effettivo, alias inclusi.

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

**Tipo** `string` · **Facoltativo**

Impostazione regionale di destinazione predefinita per le traduzioni. La sua grafia viene mantenuta invariata e validata rispetto al `customMapping` effettivo, alias inclusi.

### `locales` [#locales]

**Tipo** `string[]` · **Facoltativo**

Un array di identificatori delle impostazioni regionali supportate. Ogni codice viene mantenuto invariato e validato con il `customMapping` effettivo; gli alias personalizzati vengono accettati.

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

**Tipo** `string` · **Facoltativo**

URL base personalizzato dell'API.

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

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

Mappature personalizzate dei codici locale e sovrascritture delle proprietà. A differenza delle altre impostazioni, un nuovo `customMapping` sostituisce completamente la mappatura esistente invece di unirsi a essa.

## Valore restituito [#returns]

**Tipo** `void`

Il metodo aggiorna in-place la configurazione dell'istanza e non restituisce alcun valore.

## Esempi [#examples]

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

// Cambia l'impostazione regionale di destinazione dallo spagnolo al francese
gt.setConfig({
  targetLocale: 'fr',
});
```

## Note [#notes]

* Le modifiche alla configurazione hanno effetto immediato sulle chiamate ai metodi successive.
* Le identità delle impostazioni regionali configurate vengono preservate e validate in base al mapping personalizzato effettivo, incluse le voci in `locales`.
* Le stringhe vuote o `undefined` non cancellano le credenziali.
* Le variabili d'ambiente non vengono rilette quando si chiama `setConfig`.
* I mapping personalizzati sostituiscono completamente i mapping esistenti (non vengono combinati).
* Se un aggiornamento non va a buon fine, alcune impostazioni potrebbero essere già state modificate.
* Il metodo è sincrono e restituisce `void`.

## Sitemap

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