# generaltranslation: General Translation Core SDK: Costruttore di GT
URL: https://generaltranslation.com/it/docs/core/class/constructor.mdx
---
title: Costruttore di GT
description: Riferimento API per il costruttore della classe GT
---

## Panoramica

Il costruttore `GT` crea una nuova istanza della classe General Translation, che consente di accedere a tutte le funzionalità di traduzione, formattazione e impostazione regionale.

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

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

Il costruttore controllerà automaticamente se nell'ambiente sono presenti le variabili d'ambiente `GT_API_KEY`, `GT_DEV_API_KEY` e `GT_PROJECT_ID`, quindi puoi ometterle dai parametri del costruttore.
Inoltre, convaliderà tutti i codici locale forniti.

***

## Riferimento

### Parametri

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

L&#39;oggetto `GTConstructorParams` supporta le proprietà seguenti:

| Proprietà       | Tipo            | Facoltativo | Descrizione                                                            |
| --------------- | --------------- | ----------- | ---------------------------------------------------------------------- |
| `apiKey`        | `string`        | ✓           | API key di produzione per il servizio di traduzione                    |
| `devApiKey`     | `string`        | ✓           | API key di sviluppo (ha la precedenza in ambiente 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 personalizzato dell&#39;API (per installazioni enterprise) |
| `customMapping` | `CustomMapping` | ✓           | Mapping e definizioni personalizzati dei codici locale                 |

### Restituisce

Una nuova istanza della classe `GT` con tutti i metodi di traduzione e gestione delle impostazioni regionali disponibili.

***

## Esempi

### Uso di base

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

// Configurazione minima - usa le variabili d'ambiente
const gt = new GT();
```


### Con le credenziali API

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


### Con mappatura personalizzata delle impostazioni regionali

È possibile fornire una mappatura personalizzata.
Questo consente all&#39;utente di (1) usare alias per i codici locale che (2) possono bypassare la validazione standard BCP 47 e (3) sostituire le informazioni standard sulle impostazioni regionali BCP 47.

Ad esempio, supponiamo che tu voglia usare `cn` come alias di `zh`.
Poiché l&#39;API di General Translation non supporta `cn`, devi specificare una mappatura personalizzata.

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

Puoi fare anche altre cose con le mappature personalizzate, ad esempio aggiungere nomi personalizzati, emoji, ecc.

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

***


## Note

* Tutti i parametri sono facoltativi, ma le operazioni dell&#39;API richiedono `apiKey` e `projectId`
* Il costruttore convalida immediatamente tutti i codici locali e genera errori per quelli non validi
* Le mappature personalizzate hanno la precedenza sulla convalida BCP 47 standard

## Passaggi successivi

* Configura la tua istanza con [`setConfig`](/docs/core/class/set-config)
* Inizia a tradurre con [`translate`](/docs/core/class/methods/translation/translate)
* Scopri il tipo [`GTConstructorParams`](/docs/core/types/gt-constructor-params)