# General Translation Platform: getProjectData
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class-methods/translation/get-project-data.mdx
---

title: getProjectData
description: Leggi i metadati a livello di progetto e la configurazione delle traduzioni. Riferimento API per getProjectData.

---

Recupera informazioni su un progetto di traduzione con General Translation, inclusi il nome, Organization, l'impostazione regionale predefinita e le impostazioni regionali di destinazione attualmente configurate. Usalo per esaminare o verificare la configurazione del progetto.

## Panoramica [#overview]

Chiama `getProjectData` con un ID progetto. Restituisce i metadati del progetto in sola lettura e la configurazione delle impostazioni regionali.

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

const projectData = await gt.getProjectData('project-123');
console.log(`Project: ${projectData.name}`);
console.log(`Default locale: ${projectData.defaultLocale}`);
console.log(`Target locales: ${projectData.currentLocales.join(', ')}`);
```

Firma:

```typescript
getProjectData(
  projectId: string,
  options?: { timeout?: number }
): Promise<ProjectData>
```

*Nota: `getProjectData` richiede un valore `apiKey` (o `devApiKey`) e `projectId` nell&#39;istanza GT e il progetto deve essere accessibile con quella chiave API.*

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

* **Sola lettura.** Il metodo fornisce accesso in sola lettura alle informazioni del progetto: usa la Dashboard per modificare le impostazioni del progetto.
* **Configurazione delle impostazioni regionali.** La risposta include la configurazione delle impostazioni regionali sia sorgente (`defaultLocale`) sia di destinazione (`currentLocales`).
* **Convalida.** Usalo per verificare la configurazione del progetto prima di avviare i workflow di traduzione.

## Parametri [#parameters]

| Parametro                  | Descrizione                                              | Tipo                   | Facoltativo | Predefinito |
| -------------------------- | -------------------------------------------------------- | ---------------------- | ----------- | ----------- |
| [`projectId`](#project-id) | L&#39;identificatore univoco del progetto da recuperare. | `string`               | No          | —           |
| [`options`](#options)      | Configurazione della richiesta.                          | `{ timeout?: number }` | Sì          | —           |

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

**Tipo** `string` · **Obbligatorio**

L&#39;identificatore univoco del progetto da recuperare. Il progetto deve essere accessibile tramite la chiave API fornita.

### `options` [#options]

**Tipo** `{ timeout?: number }` · **Facoltativo**

| Campo     | Descrizione                              | Tipo     | Facoltativo |
| --------- | ---------------------------------------- | -------- | ----------- |
| `timeout` | Timeout della richiesta in millisecondi. | `number` | Sì          |

## Valore restituito [#returns]

**Tipo** `Promise<ProjectData>`

Restituisce un oggetto `ProjectData` che descrive il progetto:

```typescript
type ProjectData = {
  id: string;
  name: string;
  orgId: string;
  defaultLocale: string;
  currentLocales: string[];
};
```

| Proprietà        | Descrizione                                                       | Tipo       |
| ---------------- | ----------------------------------------------------------------- | ---------- |
| `id`             | Identificatore univoco del progetto.                              | `string`   |
| `name`           | Nome del progetto in formato leggibile.                           | `string`   |
| `orgId`          | Identificatore dell&#39;organizzazione proprietaria del progetto. | `string`   |
| `defaultLocale`  | Impostazione regionale sorgente predefinita del progetto.         | `string`   |
| `currentLocales` | Impostazioni regionali di destinazione attualmente configurate.   | `string[]` |

## Esempi [#examples]

```typescript title="index.ts"
import { GT } from 'generaltranslation';

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

async function getProjectInfo(projectId: string) {
  try {
    const project = await gt.getProjectData(projectId);

    console.log('=== Project Information ===');
    console.log(`ID: ${project.id}`);
    console.log(`Name: ${project.name}`);
    console.log(`Organization: ${project.orgId}`);
    console.log(`Default Locale: ${project.defaultLocale}`);
    console.log(`Target Locales: ${project.currentLocales.join(', ')}`);

    return project;
  } catch (error) {
    console.error(`Failed to retrieve project ${projectId}:`, error);
    throw error;
  }
}

const projectInfo = await getProjectInfo('my-project-123');
```

## Note [#notes]

* Il metodo fornisce accesso in sola lettura alle informazioni del progetto: usa la Dashboard per modificare le impostazioni del progetto.
* Questo metodo richiede un ID progetto valido; il progetto deve essere accessibile con la chiave API fornita.
* I dati del progetto includono sia la configurazione dell&#39;impostazione regionale sorgente sia quelle delle impostazioni regionali di destinazione.
* L&#39;array `currentLocales` rappresenta tutte le impostazioni regionali di destinazione configurate per il progetto.
* Usa questo metodo per validare la configurazione del progetto prima di avviare i workflow di traduzione.