# General Translation Integrations: 连接设置
URL: https://generaltranslation.com/zh/docs/integrations/storyblok/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 用于将 Storyblok space 连接到 General Translation 的设置参考。Storyblok 连接设置的 API 参考。

你只需在 **项目 > 集成 > Catalog** 中填写连接设置一次。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 为键的连接上。项目集成会链接到该连接。该连接记录可在 **组织 > Connections** 下查看。

## 方案与权限限制 [#gating]

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

* **权限：**对项目拥有 `project:write` 权限。
* **方案：**Starter 或 Enterprise。

如果没有受支持的方案，仪表板会显示升级提示，并替代集成目录，因此无法执行 **Connect** 操作。若没有 `project:write` 权限，**Connect** 操作将不可用。运行翻译还需要 `translations:content:write` 权限以及相同的方案功能；连接和翻译操作会拒绝来自不受支持方案的请求。

## Sitemap

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