# General Translation Platform: GTConstructorParams
URL: https://generaltranslation.com/it/docs/platform/core/reference/types/gt-constructor-params.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Opzioni di configurazione accettate dal costruttore di GT. API Reference per il tipo GTConstructorParams.

`GTConstructorParams` è l'oggetto passato al [costruttore](/docs/platform/core/reference/gt-class/constructor) di General Translation per configurare le credenziali API, le impostazioni regionali e gli endpoint di un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

## Panoramica [#overview]

Tutte le proprietà sono facoltative. Se `apiKey`, `devApiKey` e `projectId` non vengono forniti, il costruttore li legge dalle variabili d'ambiente `GT_API_KEY`, `GT_DEV_API_KEY` e `GT_PROJECT_ID`.

```typescript
type GTConstructorParams = {
  apiKey?: string;
  devApiKey?: string;
  sourceLocale?: string;
  targetLocale?: string;
  locales?: string[];
  projectId?: string;
  baseUrl?: string;
  customMapping?: CustomMapping;
};
```

## Proprietà [#properties]

| Proprietà                          | Descrizione                                                                 | Tipo                                                                  | Facoltativo |
| ---------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------- |
| [`apiKey`](#api-key)               | Chiave API del progetto.                                                    | `string`                                                              | Sì          |
| [`devApiKey`](#dev-api-key)        | Chiave API del progetto alternativa, usata quando `apiKey` non è impostata. | `string`                                                              | Sì          |
| [`sourceLocale`](#source-locale)   | Impostazione regionale sorgente predefinita.                                | `string`                                                              | Sì          |
| [`targetLocale`](#target-locale)   | Impostazione regionale di destinazione predefinita.                         | `string`                                                              | Sì          |
| [`locales`](#locales)              | Codici locale supportati.                                                   | `string[]`                                                            | Sì          |
| [`projectId`](#project-id)         | identificatore del progetto.                                                | `string`                                                              | Sì          |
| [`baseUrl`](#base-url)             | Endpoint API. Il valore predefinito è `https://api.gtx.dev`.                | `string`                                                              | Sì          |
| [`customMapping`](#custom-mapping) | Mapping personalizzati delle impostazioni regionali.                        | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sì          |

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

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

Chiave API del progetto per il servizio di traduzione. In alternativa, viene usata la variabile d'ambiente `GT_API_KEY`.

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

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

Alias deprecato di `apiKey`, usato quando `apiKey` non è impostata. Usa come fallback `GT_DEV_API_KEY`; non seleziona un tipo di chiave distinto specifico per un ambiente.

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

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

Impostazione regionale sorgente predefinita per le traduzioni. La grafia configurata viene mantenuta invariata e convalidata rispetto al mapping personalizzato effettivo.

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

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

Impostazione regionale di destinazione predefinita per le traduzioni. La grafia configurata viene mantenuta invariata e convalidata in base al mapping personalizzato in vigore.

### `locales` [#locales]

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

Array di identificatori di impostazioni regionali supportate. Le grafie e gli alias personalizzati vengono mantenuti invariati e convalidati in base al mapping personalizzato in vigore. I codici locale restituiti seguono le [regole del costruttore](/docs/platform/core/reference/gt-class/constructor#how-it-works).

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

**Tipo** `stringa` · **Opzionale**

Identificatore del progetto. Per impostazione predefinita usa la variabile d'ambiente `GT_PROJECT_ID`.

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

**Tipo** `string` · **facoltativo** · **Default** `https://api.gtx.dev`

Endpoint API. Modificalo solo se la tua distribuzione utilizza un endpoint diverso.

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

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

Mapping personalizzati dei codici locale e override delle proprietà dell'impostazione regionale. (Vedi [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping)).

## Esempio [#example]

```typescript
// Configurazione di base
const gt = new GT({
  apiKey: 'your-api-key',
  sourceLocale: 'en',
  targetLocale: 'es',
  locales: ['en', 'es', 'fr']
});
```

```typescript
// Con variabili d'ambiente
const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});
// Utilizza GT_API_KEY e GT_PROJECT_ID dall'ambiente
```

## Sitemap

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