---
url: "/ja/emailify/localization/locize.md"
description: "EmailifyとLocize APIを使って、Figmaから原文テキストをアップロードし、翻訳されたメールのバリエーションをLocizeのネームスペースからインポートできます。"
---

# Locizeでメールデザインを翻訳する

> EmailifyとLocize APIを使って、Figmaから原文テキストをアップロードし、翻訳されたメールのバリエーションをLocizeのネームスペースからインポートできます。

## EmailifyでLocize APIを使う {#use-the-locize-api-with-emailify}

[Locize](https://www.locize.com/)をお使いの場合、Emailifyでメールデザインの原文をLocizeのネームスペースにアップロードし、翻訳されたバリエーションをFigmaにインポートできます。

### 始める前に {#before-you-start}

次のものが必要です。

- 参照言語と、1つ以上の翻訳先の言語が設定されたLocizeプロジェクト
- メールの翻訳用の既存のバージョンとネームスペース
- プロジェクト単位の[LocizeのAPIキー](https://www.locize.com/docs/integration/api#authentication)

### ステップ1：Locizeプロジェクトを接続する {#step-1-connect-your-locize-project}

1. Emailifyの**Localize**ボタンをクリックします。
2. ローカライズのオプションから**Locize API**を選択します。
3. **Project ID**と**API Key**を入力します。
4. 使用するLocizeの**Version**（`latest`や`production`など）を入力します。
5. メールの翻訳が含まれる**Namespace**（`emails`など）を入力します。
6. Locizeプロジェクトに合わせて、**Standard CDN**または**Pro CDN**を選択します。
7. **String Key Source**で、EmailifyがLocizeの文字列キーを作成する方法を選びます。

Emailifyが接続されると、Locizeプロジェクトで設定されている参照言語と翻訳先の言語が表示されます。

> **Tip:** CDNの種類がLocizeプロジェクトと一致していることを確認してください。Standard CDNは公開型で、キャッシュ時間は1時間で固定されています。一方、Pro CDNは非公開での公開とキャッシュの設定に対応しています。詳しくは[LocizeのCDNの比較](https://www.locize.com/docs/integration/cdn-types-standard-vs-pro)をご覧ください。

### Locizeの文字列キーの作成方法を選ぶ {#choose-how-locize-string-keys-are-created}

**Figma Node ID (Default)** は、これまでのEmailifyの動作を維持し、生成されたFigmaのノードIDをLocizeのキーに使用します。既存のLocizeのワークフローは、設定を変更しない限りこのオプションを使い続けます。

Figmaのテキストレイヤー名が、Locizeのネームスペース内の文字列キーとすでに一致している場合は、**Figma Text Layer Name**を選択します。Emailifyはドットを含むレイヤー名をそのまま保持するため、`templates.assistant_invited.h01`という名前のレイヤーには、そのままのLocizeキーが使われます。

対象となるテキストレイヤーにはすべて名前が必要で、選択したメール全体で一意でなければなりません。重複するキーがある場合、Emailifyは原文の文字列をLocizeに送信する前にアップロードやインポートを停止し、重複しているキーを示します。リンクと画像の代替テキストのキーには、テキストレイヤーまたは画像レイヤーの名前に、Emailifyの`_LINK`または`_ALT_TEXT`サフィックスを付けたものが使われます。件名とプリヘッダーの行は、Figmaのテキストレイヤーではなくメールのメタデータであるため、引き続きEmailifyが生成するキーを使用します。

### ステップ2：メールと翻訳先のロケールを選択する {#step-2-select-your-emails-and-target-locales}

ローカライズしたいEmailifyのフレームを選び、あとでインポートするLocizeの翻訳先の言語を選択します。

メールの文章に、翻訳の往復で保持したい太字、斜体、リンク付きテキスト、改行が含まれている場合は、**Import Markdown Formatting**を有効のままにしておきます。

### ステップ3：参照用の原文をLocizeにアップロードする {#step-3-upload-the-reference-copy-to-locize}

**Upload**をクリックすると、選択したEmailifyのテキストが、Locizeで設定されている参照言語としてネームスペースに送信されます。あとでFigmaの原文を更新した場合は、もう一度アップロードして、対応するLocizeのキーを更新してください。

### ステップ4：Locizeで翻訳する {#step-4-translate-in-locize}

Locizeプロジェクトを開き、アップロードされたキーを翻訳先の言語ごとに翻訳またはレビューします。

### ステップ5：翻訳されたメールをFigmaにインポートする {#step-5-import-translated-emails-into-figma}

Emailifyに戻り、必要な翻訳先のロケールを選択して**Import Translations**をクリックします。Emailifyは翻訳されたLocizeのキーを選択した原文のメールに対応付け、インポートしたロケールごとにメールフレームの複製を作成します。

> **Tip:** EmailifyはLocizeのAPIキーを、共有のFigmaファイルではなく、現在のユーザーのFigmaのローカルクライアントストレージに保存します。より広い権限を持つ個人用アクセストークンではなく、プロジェクト単位のAPIキーを使用してください。
