# General Translation Platform: setConfig
URL: https://generaltranslation.com/es/docs/platform/core/reference/gt-class/set-config.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Actualiza la configuración de una instancia existente de GT. Referencia de la API de setConfig.

Cambia las credenciales de la API, las configuraciones regionales y otros ajustes de una instancia de [GT](/docs/platform/core/reference/gt-class/constructor) después de crearla, sin crear una nueva.

## Descripción general [#overview]

Llama a `setConfig` para modificar una instancia en el mismo documento. Los nuevos valores se combinan con la configuración pasada al constructor y se aplican a todas las llamadas posteriores a métodos.

```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` es síncrona y devuelve `void`; actualiza la instancia en el mismo documento.*

## Cómo funciona [#how-it-works]

* **Identidades configuradas.** Se conserva la grafía de las configuraciones regionales. Todos los campos de configuración regional proporcionados, incluido `locales`, se validan con el mapeo personalizado vigente. Los códigos no válidos lanzan un error. Los códigos de configuración regional devueltos siguen las [reglas del constructor](/docs/platform/core/reference/gt-class/constructor#how-it-works).
* **Cambio de credenciales.** Usa este método para cambiar las credenciales o la configuración del proyecto. Para estos cambios no se admite la asignación directa de propiedades.
* **Combinación de configuración.** Los valores nuevos se combinan con la configuración pasada al constructor. Sin embargo, `customMapping` reemplaza por completo cualquier mapeo existente en lugar de combinarse.
* **No se vuelven a leer las variables de entorno.** Las variables de entorno (`GT_API_KEY`, `GT_DEV_API_KEY`, `GT_PROJECT_ID`) no se vuelven a leer al llamar a `setConfig`.
* **Actualizaciones fallidas.** Si una actualización falla, es posible que algunos ajustes ya hayan cambiado.

## Parámetros [#parameters]

`setConfig` acepta un objeto [`GTConstructorParams`](/docs/platform/core/reference/types/gt-constructor-params) obligatorio con las mismas propiedades que el [constructor](/docs/platform/core/reference/gt-class/constructor):

| Parámetro                          | Descripción                                                                                | Tipo                                                                  | Opcional | Predeterminado |
| ---------------------------------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------- | -------- | -------------- |
| [`apiKey`](#api-key)               | clave de API del Project para el servicio de traducción.                                   | `string`                                                              | Sí       | —              |
| [`devApiKey`](#dev-api-key)        | clave de API del Project alternativa, que se usa cuando `apiKey` no está definida.         | `string`                                                              | Sí       | —              |
| [`projectId`](#project-id)         | Identificador único del proyecto.                                                          | `string`                                                              | Sí       | —              |
| [`sourceLocale`](#source-locale)   | Configuración regional de origen predeterminada para las traducciones.                     | `string`                                                              | Sí       | —              |
| [`targetLocale`](#target-locale)   | Configuración regional de destino predeterminada para las traducciones.                    | `string`                                                              | Sí       | —              |
| [`locales`](#locales)              | Códigos de configuración regional compatibles.                                             | `string[]`                                                            | Sí       | —              |
| [`baseUrl`](#base-url)             | URL base personalizada de la API.                                                          | `string`                                                              | Sí       | —              |
| [`customMapping`](#custom-mapping) | Mapeos personalizados de códigos de configuración regional y sobrescritura de propiedades. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Sí       | —              |

El objeto `params` en sí es obligatorio, aunque todas sus propiedades son opcionales; pasa solo la configuración que quieras cambiar.

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

**Tipo** `string` · **Opcional**

Clave de API de Project para el servicio de traducción.

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

**Tipo** `string` · **Opcional**

Alias obsoleto de `apiKey`, mantenido por compatibilidad. Se usa cuando `apiKey` no está definida, sin importar el entorno.

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

**Tipo** `string` · **Opcional**

Identificador único del proyecto.

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

**Tipo** `string` · **Opcional**

Configuración regional de origen predeterminada para las traducciones. Su escritura se conserva tal cual y se valida con el `customMapping` vigente, incluidos los alias.

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

**Tipo** `string` · **Opcional**

Configuración regional de destino predeterminada para las traducciones. Su grafía se conserva tal cual y se valida con el `customMapping` vigente, incluidos los alias.

### `locales` [#locales]

**Tipo** `string[]` · **Opcional**

array de identidades de configuración regional compatibles. Cada código se conserva y se valida con el `customMapping` vigente; se aceptan alias personalizados.

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

**Tipo** `string` · **Opcional**

URL base personalizada de la API.

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

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

Mapeos personalizados de códigos de configuración regional y sobrescrituras de propiedades. A diferencia de las demás configuraciones, un nuevo `customMapping` sustituye por completo el mapeo existente en lugar de combinarse con él.

## Devuelve [#returns]

**Tipo** `void`

El método actualiza la configuración de la instancia en el mismo documento y no devuelve ningún valor.

## Ejemplos [#examples]

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

// Cambiar la configuración regional de destino de español a francés
gt.setConfig({
  targetLocale: 'fr',
});
```

## Notas [#notes]

* Los cambios de configuración surten efecto de inmediato en las llamadas posteriores al método.
* Las identidades de configuración regional establecidas se conservan y se validan con el mapeo personalizado vigente, incluidas las entradas de `locales`.
* Las cadenas vacías o `undefined` no borran las credenciales.
* Las variables de entorno no se vuelven a leer al llamar a `setConfig`.
* Los mapeos personalizados reemplazan por completo los mapeos existentes (no se combinan).
* Si una actualización falla, es posible que algunos ajustes ya hayan cambiado.
* El método es síncrono y devuelve `void`.

## Sitemap

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