# generaltranslation: General Translation Core SDK: GT コンストラクタ
URL: https://generaltranslation.com/ja/docs/core/class/constructor.mdx
---
title: GT コンストラクタ
description: GT クラスのコンストラクタに関する API リファレンス
---

## 概要

`GT` コンストラクタは、General Translation クラスの新しいインスタンスを作成します。このクラスを通じて、翻訳、書式設定、ロケールに関するすべての機能を利用できます。

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

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

コンストラクタは環境内の `GT_API_KEY`、`GT_DEV_API_KEY`、および `GT_PROJECT_ID` 環境変数を自動的に確認するため、コンストラクタの引数からはこれらを省略できます。
また、指定されたすべてのロケールコードを検証します。

***

## リファレンス

### パラメータ

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

`GTConstructorParams` オブジェクトは、次のプロパティをサポートします。

| プロパティ           | 型               | 任意 | 説明                               |
| --------------- | --------------- | -- | -------------------------------- |
| `apiKey`        | `string`        | ✓  | 翻訳サービス用の本番環境 API キー              |
| `devApiKey`     | `string`        | ✓  | 開発用 API キー (開発環境ではこちらが優先されます)    |
| `projectId`     | `string`        | ✓  | 一意のプロジェクト ID                     |
| `sourceLocale`  | `string`        | ✓  | 翻訳のデフォルトのソースロケール                 |
| `targetLocale`  | `string`        | ✓  | 翻訳のデフォルトのターゲットロケール               |
| `locales`       | `string[]`      | ✓  | サポートされているロケールコードの配列              |
| `baseUrl`       | `string`        | ✓  | カスタム API ベース URL (エンタープライズ環境向け)  |
| `customMapping` | `CustomMapping` | ✓  | カスタムマッピングのロケールコードマッピングと定義             |

### 戻り値

翻訳メソッドとロケール関連メソッドをすべて利用できる、新しい `GT` クラスのインスタンスです。

***

## 使用例

### 基本的な使い方

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

// 最小限のセットアップ - 環境変数を使用
const gt = new GT();
```


### API認証情報を使う場合

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


### カスタムロケールマッピングを使用する場合

カスタムマッピングを指定できます。
これにより、ユーザーは (1) ロケールコードのエイリアスを使用でき、(2) 標準の BCP 47 検証を上書きし、(3) 標準の BCP 47 ロケール情報を上書きできます。

たとえば、`zh` のエイリアスとして `cn` を使いたい場合を考えます。
General Translation API は `cn` をサポートしていないため、カスタムマッピングを指定する必要があります。

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

カスタムマッピングを使うと、カスタム名や絵文字の追加などもできます。

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

***


## 注意事項

* すべてのパラメータは省略可能ですが、API 操作には `apiKey` と `projectId` が必要です
* コンストラクタはすべてのロケールコードを即座に検証し、無効なコードがあるとエラーをスローします
* カスタムマッピングは標準の BCP 47 検証よりも優先されます

## 次のステップ

* [`setConfig`](/docs/core/class/set-config) でインスタンスを設定する
* [`translate`](/docs/core/class/methods/translation/translate) で翻訳を始める
* [`GTConstructorParams` 型](/docs/core/types/gt-constructor-params) について確認する