# General Translation Integrations: クイックスタート
URL: https://generaltranslation.com/ja/docs/integrations/storyblok/quickstart.mdx
---

title: クイックスタート
description: StoryblokのスペースをGeneral Translationに接続し、ダッシュボードから最初のストーリーを翻訳するためのクイックスタート。
related:
  links:
    - /docs/integrations/storyblok/guides/translating-content
    - /docs/integrations/storyblok/guides/managing-translations
    - /docs/integrations/storyblok/guides/using-translated-content
    - /docs/integrations/storyblok/guides/configuring-storyblok

---

Storyblok連携を使うと、General TranslationのダッシュボードからStoryblokのストーリーを翻訳できます。

Storyblokは、ダッシュボード上で管理するコンテンツソース連携です。認証情報を使ってStoryblokのスペースを接続し、その後はダッシュボードからストーリーを翻訳します。インストールが必要なnpmパッケージはありません。翻訳は各ストーリーにフィールド単位のローカライズ済み値 (Storyblokのフィールド単位翻訳) として書き戻されるため、Storyblok独自のContent Delivery APIを通じて読み取ります。

## 始める前に [#before-start]

必要なもの:

* `project_integrations` 機能を含むプランの General Translation [Project](/docs/platform/dashboard/get-started)。
* その Project に対する `project:write` Permission。
* **設定 > 言語** で対象言語が設定されている Storyblok の スペース。
* Storyblok の personal access token (Management API token) 。

*注: ご利用のプランに `project_integrations` 機能が含まれていない場合、ダッシュボード には連携カタログではなくアップグレードの案内が表示されるため、スペース を接続できません。*

## クイックスタート [#quickstart]

### 1. Storyblokで言語を設定する [#configure-languages]

Storyblok でスペースを開き、**設定 > Languages** に移動します。翻訳先にしたい各言語を追加します。

General Translation では、Storyblok の言語がスペースで設定されており、かつGeneral Translation がサポートするロケールにマッピングされている場合にのみ、その言語を対象ロケールとして利用できます。[ロケール](/docs/integrations/storyblok/reference/locales)を参照してください。

### 2. 個人アクセストークンを作成する [#create-token]

Storyblok で **My account > Personal access tokens** に移動し、トークンを作成します。この連携では、このトークンを使ってあなたに代わり Storyblok Management API を呼び出します。

スペースの **Space ID** (数値。**設定 > General** に表示) と **リージョン** (EU、US、CA、AP、または CN) をメモしておきます。

### 3. ダッシュボードでスペースを接続する [#connect-space]

General Translation ダッシュボードで **Project > Integrations** に移動し、カタログを開いて **Storyblok** を探します。**Connect** をクリックし、次の項目を入力します。

* **Space ID** — スペースの数値 ID。
* **Region** — スペースがホストされているリージョン。
* **Personal access token** — 前の手順で取得したトークン。

認証情報は Project に保存されます。正常に接続されると、その統合の管理ページに移動します。

### 4. ストーリーとロケールを選択してから同期する [#sync-apply]

管理ページで、次の操作を行います。

1. 1 つ以上の **Story** エントリを選択します (セレクターは検索可能で、全選択／全解除に対応しています) 。
2. **ソースロケール** を設定します (デフォルトでは Project のデフォルトロケールが使用されます) 。
3. **ターゲットロケール** を確認します (デフォルトでは、ソースを除く space で設定済みの言語が使われます) 。
4. 必要に応じて **対応フィールドを自動で有効化** をオンにし、同期前に Storyblok で対応フィールドを翻訳対象としてマークします。
5. **同期して適用** をクリックします。

General Translation は各 ストーリー の下書きを読み取り、翻訳可能なフィールドを抽出して翻訳し、その結果を下書きとして ストーリー に書き戻します。自動的に公開されることはありません。

完全な workflow と結果の概要については、[コンテンツの翻訳](/docs/integrations/storyblok/guides/translating-content) を参照してください。

### 5. Storyblokで下書きを確認する [#review-draft]

Storyblokでストーリーを開き、対象の言語に切り替えて翻訳済みの下書きを確認します。内容に問題がなければ、Storyblokで公開します。

アプリで翻訳済みコンテンツを取得するには、`language` パラメータを指定して Storyblok の Content Delivery API をクエリします。詳しくは、[翻訳済みコンテンツを使う](/docs/integrations/storyblok/guides/using-translated-content)を参照してください。
## Next steps

- /docs/integrations/storyblok/guides/translating-content
- /docs/integrations/storyblok/guides/managing-translations
- /docs/integrations/storyblok/guides/using-translated-content
- /docs/integrations/storyblok/guides/configuring-storyblok