# gt-node: General Translation Node.js SDK: initializeGT
URL: https://generaltranslation.com/ja/docs/node/reference/functions/initialize-gt.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: サーバーの起動時に General Translation の gt-node ライブラリを一度だけ設定します。initializeGT の API リファレンス。

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

## 概要 [#overview]

サーバーの`entry file`の先頭で`initializeGT`を呼び出します。認証情報のフォールバックは`GT_PROJECT_ID`、`GT_API_KEY`、`GT_DEV_API_KEY`から読み取られますが、`gt.config.json`は自動では読み込みません。オプションの完全な一覧は、[設定リファレンス](/docs/node/reference/config)を参照してください。

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

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
});
```

シグネチャ:

```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`、`apiKey`、`devApiKey` の値が優先されます。省略した値または空の値については、対応する環境変数が使用されます。
* **配信モード。** `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 ローダーが有効になります。
* `apiKey` — 本番用の API キー。
* `devApiKey` — オンデマンド翻訳用の開発用 API キー。
* `loadTranslations` — ロケールの翻訳を返すカスタムローダー。
* `customMapping` — ロケールのエイリアスとプロパティのオーバーライド。

## 戻り値 [#returns]

**型** `void`

## 例 [#examples]

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

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr', 'ja'],
  // 認証情報は GT_PROJECT_ID、GT_API_KEY、GT_DEV_API_KEY から読み込まれます。
});
```

```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();
  },
});
```

## バージョン履歴 [#version-history]

| バージョン           | 変更点                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------- |
| `gt-node` 1.0.8 | `GT_PROJECT_ID`、`GT_API_KEY`、`GT_DEV_API_KEY` の環境変数フォールバックを追加しました。引き続き、明示的に指定された空でないパラメータが優先されます。 |

## Sitemap

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