# generaltranslation: General Translation Core SDK: setConfig
URL: https://generaltranslation.com/ja/docs/core/class/set-config.mdx
---
title: setConfig
description: GT の setConfig メソッドの API リファレンス
---

## 概要

`setConfig` メソッドは、既存の GT インスタンスの設定を更新します。
これにより、インスタンスの作成後でも API 認証情報やロケールなどの設定を変更できます。

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

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

`setConfig` メソッドは、指定されたすべてのロケールコードを検証し、コンストラクタに渡された既存の設定があればそれにマージします。

***


## リファレンス

### パラメータ

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

`GTConstructorParams` オブジェクトでは、コンストラクタと同じプロパティを指定できます。

| プロパティ           | 型               | 任意 | 説明                  |
| --------------- | --------------- | -- | ------------------- |
| `apiKey`        | `string`        | ✓  | 翻訳サービス用の本番環境 API キー |
| `devApiKey`     | `string`        | ✓  | 開発環境用 API キー        |
| `projectId`     | `string`        | ✓  | 一意のプロジェクト識別子        |
| `sourceLocale`  | `string`        | ✓  | 翻訳時のデフォルトのソースロケール   |
| `targetLocale`  | `string`        | ✓  | 翻訳時のデフォルトのターゲットロケール |
| `locales`       | `string[]`      | ✓  | サポートされているロケールコードの配列 |
| `baseUrl`       | `string`        | ✓  | カスタム API ベース URL    |
| `customMapping` | `CustomMapping` | ✓  | カスタム ロケールコードマッピング   |

### 戻り値

`void` - このメソッドはインスタンスの設定をインプレースで更新します。

***

## 例

この例では、ターゲットロケールをスペイン語からフランス語に切り替えます。

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

// フランス語に切り替える
gt.setConfig({
  targetLocale: 'fr'
});
```

***


## 注意事項

* 設定の変更は、以後のメソッド呼び出しに直ちに反映されます
* `setConfig` を呼び出しても、環境変数は再読み込みされません
* カスタムマッピングは既存のマッピングを完全に置き換え、マージはされません
* この更新は**アトミックではありません** — 途中で検証に失敗した場合 (たとえば2番目のロケールで) 、それ以前のプロパティはすでに設定されている可能性があります
* このメソッドは同期的に動作し、`void` を返します

## 次のステップ

* **[コンストラクタで初期化する](/docs/core/class/constructor)**
* **[コンテンツの翻訳を始める](/docs/core/class/methods/translation/translate)**
* **[GTConstructorParamsについて学ぶ](/docs/core/types/gt-constructor-params)**