# General Translation Integrations: 接続設定
URL: https://generaltranslation.com/ja/docs/integrations/storyblok/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Storyblok スペースを General Translation に接続するための設定のリファレンス。Storyblok 接続設定の API リファレンス。

これらの接続設定は **プロジェクト > Integrations > Catalog** から一度入力します。General Translation はそれらを Organization 接続に保存し、Storyblok Management API の呼び出しに使用します。

## 概要 [#overview]

| 設定                          | 説明                            | 型                                | 任意  | デフォルト |
| --------------------------- | ----------------------------- | -------------------------------- | --- | ----- |
| [Space ID](#space-id)       | Storyblok スペースの数値ID。         | `string`                         | いいえ | —     |
| [リージョン](#region)            | space がホストされるリージョン。           | `eu` | `us` | `ca` | `ap` | `cn` | いいえ | `eu`  |
| [個人アクセストークン](#access-token) | Storyblok Management APIトークン。 | `string`                         | いいえ | —     |

接続するには、以下の[プランと権限による制限](#gating)も満たす必要があります。

## Space ID [#space-id]

**Type** `string` · **必須**

Storyblok の **設定 > General** に表示される、Storyblok スペースの数値 ID です。数値入力を受け付ける **Space ID** フィールドに入力します。値を保存する前に、先頭の `#` は削除され、前後の空白はトリミングされます。

space ID は、連携のリソース識別子としても認証情報内にも保存されます。認証情報内の space ID が接続された連携と一致しない場合、翻訳の実行は失敗します。

## リージョン [#region]

**型** `eu` | `us` | `ca` | `ap` | `cn` · **必須** · **デフォルト** `eu`

Storyblok スペースがホストされているリージョンを指定します。**リージョン** フィールドで **EU**、**US**、**CA**、**AP**、**CN** のいずれかを選択します。リージョンに応じて、この連携が呼び出す Storyblok Management API のベース URL が決まります。

| リージョン | Management API ベース URL             |
| ----- | ---------------------------------- |
| `eu`  | `https://mapi.storyblok.com/v1`    |
| `us`  | `https://api-us.storyblok.com/v1`  |
| `ca`  | `https://api-ca.storyblok.com/v1`  |
| `ap`  | `https://api-ap.storyblok.com/v1`  |
| `cn`  | `https://app.storyblokchina.cn/v1` |

未対応のリージョンを指定すると、接続時に拒否されます。

## 個人アクセストークン [#access-token]

**Type** `string` · **必須**

Storyblok の個人アクセストークン (Management API トークン) です。Storyblok の **My account > Personal access tokens** で作成し、マスク表示される **Personal access token** フィールドに入力します。

このトークンは、連携が行うすべての Management API リクエストで `Authorization` header として送信されます。連携ではストーリーの読み取り、ストーリーコンテンツの読み取りと更新、さらに ([対応フィールドの自動有効化](/docs/integrations/storyblok/guides/translating-content#auto-enable) のために) コンポーネント schema の読み取りと更新を行うため、space のストーリーとコンポーネントにアクセスできる必要があります。

## ストレージ [#storage]

認証情報 (space ID、リージョン、パーソナルアクセストークン) は、Storyblok スペースをキーとする Organization 接続に一度だけ保存されます。プロジェクトのインテグレーションはその接続にリンクされます。接続レコードは **Organization > Connections** に表示されます。

## プランと権限による制限 [#gating]

Storyblok インテグレーションを接続するには、次の両方が必要です。

* **権限:** プロジェクトに対する `project:write`
* **プラン:** Starter または Enterprise

対応するプランがない場合、Dashboard ではインテグレーションカタログの代わりにアップグレードの案内が表示されるため、**Connect** アクションは利用できません。`project:write` がない場合も、**Connect** アクションは利用できません。翻訳の実行には `translations:content:write` と同じプラン機能も必要です。接続アクションおよび翻訳アクションは、対応していないプランからのリクエストを拒否します。

## Sitemap

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