# gt-node: General Translation Node.js SDK: gt-node の設定
URL: https://generaltranslation.com/ja/docs/node/guides/configuring.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: General Translation の gt-node をロケール、認証情報、翻訳の配信を指定して初期化する方法。

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

*注: `gt-next` とは異なり、`gt-node` は `gt.config.json` を自動では読み込みません。ロケール設定を Runtime と共有するには、そのファイルを明示的にインポートしてください。認証情報のフォールバックとして、`GT_PROJECT_ID`、`GT_API_KEY`、`GT_DEV_API_KEY` は読み込みます。*

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

ロケールと認証情報を指定して、リクエストの処理が始まる前に [`initializeGT`](/docs/node/reference/functions/initialize-gt) を一度だけ呼び出します。

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

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

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

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

サービスが実行される環境で project ID と APIキーを設定します。対応するフィールドを省略すると、[`initializeGT`](/docs/node/reference/functions/initialize-gt) はそれらを使用します。

```bash
export GT_PROJECT_ID="your-project-id"
export GT_DEV_API_KEY="gtx-dev-..."
export GT_API_KEY="gtx-api-..."
```

[`initializeGT`](/docs/node/reference/functions/initialize-gt) に直接渡した値は、環境変数よりも優先されます。明示的に空の値を指定した場合は、環境変数の値が使用されます。

開発環境では、project ID と開発用 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`](/docs/node/reference/functions/initialize-gt) の値は CLI が生成するものと揃えてください。

## Next steps

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

## Sitemap

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