# gt-node: General Translation Node.js SDK: initializeGT
URL: https://generaltranslation.com/ja/docs/node/reference/functions/initialize-gt.mdx
---

title: initializeGT
description: サーバーの起動時に General Translation の gt-node ライブラリを一度だけ設定します。initializeGT の API リファレンス。

---

Node.js ランタイムで General Translation を使用するための設定を行います。ロケール、認証情報、翻訳配信を設定するため、他の翻訳関数を呼び出す前に `initializeGT` を一度だけ呼び出してください。

## 概要 [#overview]

サーバーの`entry file`の先頭で`initializeGT`を呼び出します。環境変数や`config file`は自動では一切読み込まれないため、すべての値を明示的に渡してください。オプションの完全な一覧は、[設定リファレンス](/docs/node/reference/config)を参照してください。

```ts
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
  projectId: 'your-project-id',
});
```

シグネチャ:

```ts
initializeGT(config: InitializeGTParams): void
```

*注: [`withGT`](/docs/node/reference/functions/with-gt)、[`getGT`](/docs/node/reference/functions/get-gt)、[`getMessages`](/docs/node/reference/functions/get-messages)、またはその他の翻訳関数を使用する前に、`initializeGT` を呼び出す必要があります。これらの関数を先に呼び出すと、エラーがスローされます。*

## 仕組み [#how-it-works]

* **一度だけのセットアップ。** サーバーの初期化時に `initializeGT` を必ず一度だけ呼び出します。これにより、ロケール設定、翻訳キャッシュ、リクエスト単位のロケールストレージが設定されます。
* **配信モード。** `projectId` を指定して General Translation CDN から翻訳を読み込むか、[`loadTranslations`](/docs/react/reference/functions/load-translations) を使って独自のソースを読み込みます。開発時にオンデマンド翻訳を行う場合は、`devApiKey` も指定してください。
* **同期。** この呼び出しは即座に返り、ネットワークリクエストの完了は待ちません。

## パラメータ [#parameters]

| パラメータ               | 説明                                                               | Type                 | 任意  | デフォルト |
| ------------------- | ---------------------------------------------------------------- | -------------------- | --- | ----- |
| [`config`](#config) | 設定オブジェクトです。詳しくは[設定リファレンス](/docs/node/reference/config)を参照してください。 | `InitializeGTParams` | いいえ | —     |

### `config` [#config]

**型** `InitializeGTParams` · **必須**

ロケール、認証情報、キャッシュ、辞書に関するオプションをまとめたオブジェクトです。オブジェクト自体は必須ですが、含まれる各フィールドはすべて省略可能です。各フィールドの詳細は [設定リファレンス](/docs/node/reference/config) を参照してください。よく使われるフィールド:

* `defaultLocale` — ソースおよびフォールバックのロケール (デフォルトは `'en'`) 。
* `locales` — サポート対象のロケール。
* `projectId` — プロジェクト ID。設定すると CDN ローダーが有効になります。
* `devApiKey` — オンデマンド翻訳用の開発用 API キー。
* `loadTranslations` — ロケールの翻訳を返すカスタムローダー。
* `customMapping` — ロケールのエイリアスとプロパティのオーバーライド。

## 戻り値 [#returns]

**型** `void`

## 例 [#examples]

```ts title="server.js"
// 基本的なセットアップ
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr', 'ja'],
  projectId: process.env.GT_PROJECT_ID,
});
```

```ts title="server.js"
// カスタムtranslation ローダーを使用する場合
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es'],
  loadTranslations: async (locale) => {
    const res = await fetch(`https://my-api.com/translations/${locale}`);
    return res.json();
  },
});
```

## メモ [#notes]

* `initializeGT` は、翻訳関数を実行する前に一度だけ呼び出す必要があります。
* General Translation のクラウドサービスを使用する場合は `projectId` を指定してください。開発時は `devApiKey` も指定してください。
* `loadTranslations` オプションを使うと、General Translation の CDN ではなく独自の翻訳ソースを利用できます。