# General Translation Integrations: 接続設定
URL: https://generaltranslation.com/ja/docs/integrations/storyblok/reference/connection.mdx
---

title: 接続設定
description: Storyblok スペースを General Translation に接続するための設定のリファレンス。Storyblok 接続設定の API リファレンス。

---

Storyblok スペースを General Translation に接続するための設定です。これらの設定は **Project > Integrations** の **Connect** ダイアログで一度入力するだけでよく、General Translation はそれらを Project に保存し、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 スペースに接続し、認証情報がプロジェクト間で共有されることはありません。連携が解除されるまで保持されます。

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

Storyblok 連携を接続するには、次の両方が必要です。

* **権限:** Project に対する `project:write`
* **プラン機能:** Project のプランで `project_integrations` が有効になっていること

プラン機能がない場合、Dashboard では連携カタログの代わりにアップグレードの案内 (必要なプラン付き) が表示されるため、**Connect** アクションは利用できません。`project:write` がない場合も、**Connect** アクションは利用できません。`project_integrations` による制限は翻訳の実行にも適用されます。機能がない場合、接続アクションおよび翻訳サーバーのアクションは "Integrations are not available on your current plan." というエラーを返します。