# gt-node: General Translation Node.js SDK: gt-node の設定
URL: https://generaltranslation.com/ja/docs/node/guides/configuring.mdx
---

title: gt-node の設定
description: "General Translation の gt-node を初期化する方法。このガイドでは、ロケール、認証情報、翻訳の配信について説明します。"
related:
  links:
    - /docs/node/guides/translating-strings
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/storing-translations

---

`gt-node` の設定は、起動時に一度だけ行う [`initializeGT`](/docs/node/reference/functions/initialize-gt) の呼び出しですべて行います。このガイドでは、何を渡す必要があるかと、翻訳がどのように配信されるかを説明します。

*注: `gt-next` とは異なり、`gt-node` は `gt.config.json` や環境変数を自動では読み込みません。すべての値を明示的に渡してください。*

## 起動時に初期化する [#initialize]

ロケールと認証情報を指定して、リクエストの処理が始まる前に `initializeGT` を一度だけ呼び出します。

```ts title="server.js"
import { initializeGT } from 'gt-node';

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

CLI と値の同期を保つには、`gt.config.json` をインポートし、そのフィールドを呼び出し内でスプレッドして渡してください。

## 認証情報を追加する [#credentials]

Project ID と APIキーを環境変数として設定し、それらを渡します。開発中は開発用キーを使用し、本番環境では本番用キーを使用します。

```ts title="server.js"
initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
  projectId: process.env.GT_PROJECT_ID,
  devApiKey: process.env.NODE_ENV !== 'production' ? process.env.GT_API_KEY : undefined,
  apiKey: process.env.NODE_ENV === 'production' ? process.env.GT_API_KEY : undefined,
});
```

開発環境では、`projectId` と開発用 API キーを使うことで、オンデマンド翻訳とホットリロードが有効になり、作業中に追加した新しい文字列もその場で翻訳されます。本番環境では、翻訳は事前生成されたファイルまたは CDN から提供されます。利用可能なすべてのオプションについては、[Configuration reference](/docs/node/reference/config)を参照してください。

## 翻訳の取得方法を選択する [#delivery]

`gt-node` は、次のいずれかのモードで翻訳を解決します。

* **General Translation CDN:** `projectId` を指定すると (カスタム `loader` を使わない場合) 、GT の CDN から翻訳を取得します。
* **ローカルファイル:** 指定したロケールの翻訳を返す [`loadTranslations`](/docs/react/reference/functions/load-translations) コールバックを指定します。詳しくは [翻訳をローカルに保存する](/docs/node/guides/storing-translations) を参照してください。
* **カスタムエンドポイント:** 独自のホストから読み込むにはカスタム `cacheUrl` を設定し、リモートからの読み込みを無効にするには `null` を設定します。

## 翻訳が見つからない場合の対処 [#missing]

翻訳が見つからない場合、`gt-node` は例外を投げる代わりに、変数を補間したソース文字列を返すため、リクエストは常にレンダリングされます。[`getTranslations`](/docs/node/reference/functions/get-translations) による dictionary の参照は例外で、存在しない dictionary id を指定すると例外が発生します。本番環境で翻訳を確実に利用できるよう、`initializeGT` の値は CLI が生成するものと揃えてください。
## Next steps

- /docs/node/guides/translating-strings
- /docs/node/guides/detecting-locale
- /docs/node/guides/storing-translations