# General Translation Integrations: 连接设置
URL: https://generaltranslation.com/zh/docs/integrations/storyblok/reference/connection.mdx
---

title: 连接设置
description: 用于将 Storyblok space 连接到 General Translation 的设置参考。Storyblok 连接设置的 API 参考。

---

用于将 Storyblok space 连接到 General Translation 的各项设置。你只需在 **项目 > Integrations** 的 **Connect** 对话框中填写一次；General Translation 会将其存储在 项目 中，并用它们调用 Storyblok Management API。

## 概览 [#overview]

| 设置                      | 描述                           | 类型                               | 可选 | 默认   |
| ----------------------- | ---------------------------- | -------------------------------- | -- | ---- |
| [Space ID](#space-id)   | Storyblok space 的数字 ID。      | `string`                         | 否  | —    |
| [区域](#region)           | 该 space 托管所在的区域。             | `eu` | `us` | `ca` | `ap` | `cn` | 否  | `eu` |
| [个人访问令牌](#access-token) | Storyblok Management API 令牌。 | `string`                         | 否  | —    |

连接还要求满足下方的[套餐和权限限制](#gating)。

## Space ID [#space-id]

**类型** `string` · **必填**

Storyblok space 的数字 ID，可在 Storyblok 的 **设置 > 常规** 中查看。在 **Space ID** 字段中输入，该字段仅接受数字。存储前会去掉开头的 `#`，并去除首尾空白字符。

space ID 既会作为集成的资源标识符存储，也会存储在凭据中。如果凭据中的 space ID 与已连接的集成不一致，翻译任务将失败。

## 区域 [#region]

**类型** `eu` | `us` | `ca` | `ap` | `cn` · **必填** · **默认值** `eu`

你的 Storyblok space 所托管的区域。在 **区域** 字段中选择，可选项包括 **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]

**类型** `string` · **必填**

Storyblok 个人访问令牌 (Management API 令牌) ，在 Storyblok 的 **My account > Personal access tokens** 下创建。填写在 **Personal access token** 字段中，该字段会以掩码形式显示。

该令牌会作为 `Authorization` 标头随集成发出的每个 Management API 请求一起发送。它必须具有访问该 space 的 stories 和 components 的权限，因为该集成需要读取 stories、读取并更新 story 内容，以及 (对于 [自动启用受支持字段](/docs/integrations/storyblok/guides/translating-content#auto-enable)) 读取并更新 component schema。

## 存储 [#storage]

凭证 (即 space ID、区域 和个人访问令牌) 会存储在与其关联的 项目 上。每个 项目 都连接各自的 Storyblok space；凭证不会在不同的 项目 之间共享。除非断开集成，否则这些凭证会一直保留。

## 套餐与权限限制 [#gating]

连接 Storyblok 集成需要同时满足以下两项条件：

* **权限：**对项目拥有 `project:write` 权限。
* **套餐功能：**项目套餐包含 `project_integrations` 功能。

如果缺少该套餐功能，仪表板会显示升级提示 (包含所需套餐) ，并替代集成目录，因此无法执行 **Connect** 操作。若没有 `project:write` 权限，**Connect** 操作将不可用。`project_integrations` 限制也适用于运行翻译；缺少该功能时，连接和翻译服务器操作都会返回错误“您当前的套餐不支持集成。”