# General Translation Python SDKs: 設定
URL: https://generaltranslation.com/ja/docs/python/reference/config.mdx
---

title: 設定
description: gt.config.json ファイルを通じて General Translation Python SDK を設定します。gt.config.json の API リファレンスです。

---

`gt.config.json` には、General Translation Python プロジェクト全体で共有される設定が保存されます。[`initialize_gt`](/docs/python/reference/functions/initialize-gt) は起動時にこのファイルを読み込みます (または、その値を [`I18nManager`](/docs/python/reference/classes/i18n-manager) に渡すこともできます) 。また、キーワード引数を指定した場合は、その値がファイルの設定より優先されます。このページでは、SDK が読み取るすべてのキーについて説明します。

*注: Python SDK は実験段階です。*

## 概要 [#overview]

`gt.config.json` は project root (デフォルトでは現在の作業ディレクトリ。`initialize_gt(..., config_path=...)` で上書き可能) に配置します。ファイル内のキーには **camelCase** を使用します。すべてのキーは任意です。不明なキーは無視されます。デフォルトのファイルが存在しない場合は空の設定が使用されますが、存在しない `config_path` を明示的に指定すると `FileNotFoundError` が発生し、JSON が無効な場合は `ValueError` が発生します。

```json title="gt.config.json"
{
  "projectId": "your-project-id",
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "cacheUrl": "https://cdn.gtx.dev"
}
```

| キー                                 | 説明                                    | 型          | 任意 | デフォルト  |
| ---------------------------------- | ------------------------------------- | ---------- | -- | ------ |
| [`projectId`](#project-id)         | プロジェクト ID。設定すると CDN loader が有効になります。 | `string`   | はい | —      |
| [`defaultLocale`](#default-locale) | source および 代替ロケール。             | `string`   | はい | `"en"` |
| [`locales`](#locales)              | サポートされている対象ロケールコード。                   | `string[]` | はい | —      |
| [`cacheUrl`](#cache-url)           | 翻訳の読み込みに使用する CDN のベース URL。            | `string`   | はい | —      |
| [`customMapping`](#custom-mapping) | カスタムのロケールコードとプロパティ上書き。                | `object`   | はい | —      |
| [`_versionId`](#version-id)        | 固定された翻訳バージョン。                         | `string`   | はい | —      |
| [`runtimeUrl`](#runtime-url)       | Runtime API のベース URL。                 | `string`   | はい | —      |

## `projectId` [#project-id]

**型** `string` · **任意**

General Translation のプロジェクト ID です。これを設定すると (`load_translations` callback が指定されていない場合) 、SDK は `{cacheUrl}/{projectId}/{locale}` の CDN から翻訳を読み込みます。`initialize_gt` と `I18nManager` の `project_id` 引数に対応します。

## `defaultLocale` [#default-locale]

**型** `string` · **任意** · **デフォルト** `"en"`

コンテンツの記述に使用するソースロケールであり、翻訳が見つからない場合に使用される代替ロケールでもあります。config と `initialize_gt` 呼び出しの両方で未設定の場合は、ライブラリの既定値 `"en"` (`LIBRARY_DEFAULT_LOCALE` 定数) が使用されます。

## `locales` [#locales]

**型** `string[]` · **任意**

サポート対象のロケールです。ここで省略しても、デフォルトロケールは常にマネージャーのロケールセットに含まれます。Eager loading では、起動時にこれらのロケールの翻訳を取得します。

## `cacheUrl` [#cache-url]

**型** `string` · **任意**

翻訳リクエスト (`{cacheUrl}/{projectId}/{locale}`) の構築に使用される CDN のベース URL です。General Translation の CDN は `https://cdn.gtx.dev` です。

*注: `cacheUrl` が設定されていない場合、現時点では、マネージャーは CDN のデフォルト値を適用せず、空のベース URL をリモート `loader` に渡します。CDN から読み込む場合は、`cacheUrl` を明示的に設定してください。*

## `customMapping` [#custom-mapping]

**型** `object` · **任意**

カスタムロケールコードを標準コードまたはプロパティの上書きに対応付けるマッピングです (例: `{ "en-US": { "name": "English", "nativeName": "English" } }`) 。`generaltranslation` の `custom_mapping` 引数および [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) 型に対応します。

## `_versionId` [#version-id]

**型** `string` · **任意**

読み込む翻訳バージョンを固定します。ファイル key の先頭にアンダースコアが付いている点に注意してください。これは `initialize_gt` と `I18nManager` の `version_id` 引数に対応しており、[`get_version_id`](/docs/python/reference/functions/get-version-id) によって返されます。

## `runtimeUrl` [#runtime-url]

**型** `string` · **任意**

Runtime API のベース URL。設定 loader はこの key を `runtime_url` として解析しますが、現在の `gt-flask` および `gt-fastapi` の統合ではマネージャーに渡されないため、Runtime では効果がありません。

*注: `runtimeUrl` は読み取られますが、フレームワーク統合では使用されません。*