統合機能
    1. Phrase
    2. Phrase TMS
    3. 統合機能

    Contentful (TMS)

    本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

    利用可能対象

    • ビジネスおよびエンタープライズプラン（LSPプランでは利用不可）

    ライセンスに関する質問は、営業担当までお問い合わせください。

    利用可能対象

    • Enterpriseプラン（従来のプラン）

    ライセンスに関する質問は、営業担当までお問い合わせください。

    ヒント

    Phrase StringsにおけるContentful統合の詳細については、Contentful (Strings)を参照してください。

    Contentfulは、あらゆるプラットフォームやデバイスに対してコンテンツを作成、管理、配信するためのヘッドレスコンテンツ管理インフラストラクチャを提供します。Phraseは、以下の2つの方法でContentfulと統合します： 

    • 専用のContentfulコネクタ経由（2.0、エントリーレベル、フィールドレベル）

      Contentful 2.0コネクタは現在、米国データセンター経由の認証のみをサポートしています。

    • カスタマイズされたエクスペリエンスのためのContentfulマーケットプレイスプラグイン経由

    備考

    このコネクタは、JSONオブジェクトの翻訳をサポートしていません。

    サポートされているローカライズ方法

    Contentfulは複数のローカライズ方法をサポートしています。詳細な説明については、Contentfulドキュメントを参照してください。

    Contentful 2.0コネクタは、フィールドレベルのローカライズをサポートする、現在推奨されている統合機能です。また、以下の機能も提供します：

    • 連続スペース

    • 環境エイリアス

    • プレビューURL設定

    • 参照インポート

    • タグベースのコンテンツフィルタリング

    • ライブプレビュー設定

    エントリーレベルローカライズ（レガシー）

    Contentful（エントリーレベル）コネクタを使用します。

    エントリーレベルコネクタは、ローカライズに対応した参照フィールドを持つコンテンツタイプでのみ機能します（例：ローカライズが有効になっているLocalizedという参照フィールド）。

    フィールドレベルローカライズ（レガシー）

    Contentful（フィールドレベル）コネクタを使用します。

    フィールドレベルコネクタは、翻訳可能なフィールド（例：ローカライズが有効なテキストまたはリッチテキストフィールド）と、オプションでメディアアセットを持つコンテンツタイプでのみ機能します。参照されたエントリとその翻訳可能なフィールド（参照フィールドがローカライズされている場合）をインポートします。

    注意

    レガシーコネクタは、2026年11月30日に非推奨となります。これらのコネクタの新しいインスタンスは、2026年8月17日まで作成できます。非推奨となる日までに新しいコネクタへ移行してください。

    完全な移行ガイドについては、レガシーコネクタの非推奨を参照してください。

    使用例

    コネクターにはいくつかの使用例があります。

    • プロジェクトマネージャは、ファイルをオンラインリポジトリからプロジェクトに直接追加できます。コンテンツはエントリIDで検索可能です。

    • サブミッターポータルをセットアップして、サブミッターがオンラインリポジトリから直接リクエストにファイルを追加できるようにします。コンテンツはエントリIDで検索可能です。

    • プロジェクトの自動作成（APC）を使用して、監視対象のドキュメントまたはフォルダのコンテンツサイズの変更が検出されたときに、新しいプロジェクトが自動的に作成されるようにします。

    アプリケーションのユースケース：

    • コンテンツエディタは、Contentful内から直接、エントリをローカライズ用に送信できます。これにより、コンテンツエディタやマネージャは、ローカライズフローを完全に制御し、エントリを表示する際にステータス更新をその場で確認できるようになります。

      エントリが確定したら：

      • ローカライズするターゲット言語を選択します。

      • 選択した言語向けにエントリのみをPhrase TMSに送信するか、フィールド選択タブを使用してフィールドを選択します。

        • フィールドが選択されていない場合、ローカライズ可能なすべてのフィールドが翻訳用に送信されます。

        • ローカライズ不可能なフィールドが選択されていても、そのフィールドは翻訳用に送信されません。ローカライズ可能なフィールドのみが送信されます。

        • ローカライズ可能なフィールドの一部のみが選択されている場合、それらのフィールドのみが翻訳用に送信されます。

      • APC設定に基づいて、送信されたコンテンツからジョブが自動的に作成されます。APCの実行中は、送信済みステータスのエントリのみがジョブ作成の対象となります。

      • 送信されたエントリからジョブが作成されると、ステータスが進行中に変更されます。翻訳結果がContentfulに反映されると、ステータスが完了に変更されます。

      • 翻訳済みのエントリは、原文を変更した後に再送信できます。

    • コンテンツエディタは、Phrase TMSのホーム画面で次の操作を行えます。

      • エントリを一括送信する。

      • 一括送信時に個別のターゲット言語を指定する。

      • アクティブな翻訳ジョブの概要を確認する。

    Contentful設定 

    Phrase TMSアプリケーションを使用する場合：

    1. マーケットプレイスからPhrase TMSアプリケーションをダウンロードします。

    2. 現在アクティブなスペースにアプリケーションをインストールし、アプリケーションのインストールが必要なコンテンツモデルを選択します。

    3. Phrase TMS内でコネクタを作成する際に取得したPhrase TMS認証トークンを入力します。

    4. インストールをクリックします。

    任意 - アプリを起動（Contentfulにより非推奨）

    ContentfulのLaunch App経由でワークフローサポートを使用する場合は、以下の手順に従ってください。

    1. ContentfulのLaunchアプリケーションを1つ以上のスペースにインストールします。

      備考

      1つのスペースにつき作成できるワークフローは1つだけです。1つのContentfulスペース内でコンテンツタイプごとに異なるアプローチが必要な場合は、担当のカスタマーサクセスマネージャーにお問い合わせください。

    2. 必要なローカライズワークフローを設定します。

    3. 説明されているワークフローに従うコンテンツタイプを選択します。

    コネクタでワークフローが設定されている場合、監視対象のアーティクルまたはコンテンツタイプでワークフローのステップに変更が検出されると、プロジェクトの自動作成（APC）によって新しいプロジェクトが作成されます。

    送信済みのジョブはキャンセルできるため、変更を加えた後にコンテンツを再送信できます。これらのジョブはPhraseに残るため、プロジェクトマネージャが削除する必要があります。

    Phrase TMS設定（Contentful 2.0）

    備考

    Contentful Launch Appは、2.0コネクタではサポートされていません。

    1. 設定Setup_gear.pngページから、[統合機能]セクションまでスクロールします。

    2. [コネクタ]をクリックします。

      「コネクタ」ページが開きます。

    3. [新しいコネクタ]をクリックします。

      [コネクタを作成]ページが開きます。

    4. [タイプ]をContentful 2.0に変更します。

    5. コネクタの名前を入力します。

    6. [Contentful 2.0に接続]をクリックします。

      Contentfulのログインウィンドウが開きます。

    7. ログイン情報を入力し、[ログイン]をクリックします（または他のログイン方法を使用します）。ログインウィンドウが閉じ、[接続済み]と表示されます。

    8. コネクタをアプリで使用する場合は、必要に応じてPhrase Contentful Appチェックボックスを選択します。

      1. [トークンを生成]をクリックします。

        [Contentfulトークンを生成]ウィンドウが開きます。

      2. [トークンを生成]をクリックします。

        トークンが生成されます。これをクリップボードまたはテキストファイルにコピーしてください。ウィンドウを閉じるとトークンは二度と表示されなくなるため、閉じる前に必ずコピーしてください。このトークンは、アプリに接続する際に使用します。

      3. ウィンドウを閉じると、[トークンが生成されました]と表示されます。

    9. [Contentfulタグ]を使用して翻訳可能なコンテンツを識別する場合は、タグIDを入力してEnterキーを押します。

      IDが表示され、さらに追加することができます。タグを使用して、Contentfulからコネクタに表示されるコンテンツを制限できます。

      • 一覧表示方法を選択

        • すべてのタグ 

          指定したすべてのタグが付いたContentful内のコンテンツを表示します。

        • 1つ以上のタグ 

          リストされたタグが少なくとも1つ付いているContentfulのコンテンツを表示します。

    10. 必要に応じて、アセットを含めるを選択します。

    11. 必要に応じて、参照エントリを含める（入れ子になったコンテンツ）を選択します。

      参照エントリの設定が表示されます。目的のフィルターを適用して、システムがコンテンツ間の関係をたどる方法をより細かく制御します。

      • リンクされたエントリのインポート深度を設定 

        インポート中にPhraseが参照エントリをたどる範囲を制限します。

        デフォルト値は10,000です。必要に応じて、他の値を選択するか、カスタム整数値を指定します。

      • コンテンツの種類

        コンテンツタイプが指定されたリストと一致するエントリで停止するか、それらのエントリをたどるかを選択します。

      • 親コンテンツの種類

        親コンテンツタイプが指定されたリストと一致するエントリを除外します。

      • タグ

        指定されたコンテンツタグのいずれかが付いているエントリで停止するか、それらのエントリをたどるかを選択します。

      • フィールドID

        指定されたフィールドIDによって参照されるエントリで停止するか、それらのエントリをたどるかを選択します。

    12. 必要に応じて、タクソノミーを含めるを選択します。

      Contentful組織IDフィールドが表示されます。値を入力すると、タクソノミー設定が有効になります。

      • 選択すると、コネクタはContentfulからタクソノミーを取得し、.XLIFFファイルに含めます。CATエディターのコンテキストメモペインには、各セグメントのContentfulタクソノミー値が表示されます。タクソノミー値は翻訳対象のコンテンツではありません。これらは、単独で、またはエントリと一緒に、スタンドアロンのジョブとしてリスト、インポート、エクスポートすることはできません。

      • タクソノミーのメタデータを利用できない場合、またはコネクタに設定されていない場合、コンテキストメモペインは表示されません。

      • プロジェクトで機能/画面のコンテキストが不要な場合は、.XLIFFエクスポート時のパフォーマンスを最適化するために、タクソノミーを無効のままにすることをお勧めします。

    13. 必要に応じて、エイリアスを追跡を選択します。

      エイリアスは、すべてのAPC監視とジョブの再インポート・エクスポートに使用されます。将来エイリアスの参照先が変更された場合、APCは新しい参照先のコンテンツを監視し、ジョブは新しい参照先から再インポートされ、その参照先へエクスポートされます。

      「エイリアスを追跡」は、APC監視、ジョブの再インポート、およびジョブのエクスポートに適用されます。これは、エイリアスURLからPhrase Contentful Appを通じて送信されたエントリにも適用されます。アプリは送信時にエイリアスを記録するため、エイリアスターゲットが変更された後でも、コネクタはこれらのエントリを見つけることができます。エイリアスが以前の環境を指していたときに送信されたエントリも、引き続きコネクタから認識できます。各エントリは、送信元の環境に対して引き続きエクスポートおよび再インポートされます。

      エイリアスを追跡するコネクタは、エイリアスURLではなく、実際の環境のURLから送信されたエントリを見つけることができません。また、エイリアスのサポートが追加される前にアプリを通じて送信されたエントリも見つけることができません。これらのエントリを、ContentfulからエイリアスURLを通じて再送信してください。

      • 無効（デフォルトおよび推奨）

        APCおよび作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に紐付けられます。APCはその環境とコンテンツのみを監視し、ジョブはその環境に対してエクスポートおよび再インポートされます。

      • 有効 

        APCおよび作成されたジョブは、エイリアス自体に紐付けられます。APCはそのエイリアスとコンテンツのみを監視し、ジョブはそのエイリアスに対してエクスポートおよび再インポートされます。

        エイリアスのターゲットが変更された場合、APCは新しいエイリアスのターゲット（環境）を監視し、ジョブはその環境に対してエクスポートおよび再インポートされるようになります。

        Phrase Contentful Appを通じて送信されたエントリの場合、ジョブはエントリの送信元環境に対してエクスポートおよび再インポートされます。

      カスタムContentfulロールには、エイリアス自体へのアクセス権だけでなく、エイリアスが指す実際の環境への直接アクセス権も必要です。これがないと、Phrase TMSアプリのダッシュボードを読み込めません。このアクセス権は、Contentfulのスペース設定／ロールにある、対象ロールの環境セクションで追加してください。後でエイリアスが別の環境を指すように変更された場合は、新しい環境へのアクセス権も追加してください。

    14. 必要に応じて、プレビューURLを指定してください。

      これは、ContentfulのコンテンツがレンダリングされたページへのURLテンプレートです。以下のプレースホルダーを利用できます。

      • {env_id}:Environment ID

      • {entry.id}:Entry ID

      • {space_id}:Space ID

      URLテンプレートは以下のようになります。

      https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}

      備考

      URLは、Contentfulのコンテンツをレンダリングするデプロイ済みのアプリケーションへ導く必要があります。ライブプレビューを使用するには、URLテンプレート内のcontentfulapp.tldを、実際のアプリケーションのドメインに置き換えてください。

      コンテンツプレビューの設定に関する詳細については、Contentfulのドキュメントを参照してください。

      現在、ロケールはプレースホルダーとしてサポートされていません。URLでロケールを使用するには、固定値を指定し、複数のコネクタインスタンスを作成します。

    15. 必要に応じて、翻訳可能なフィールドを省略を使用して、特定のフィールドをPhraseへのインポートから除外します。インポートから除外するContentIDを指定してください。

    16. スペースプレビュートークンマップ（必須）に、スペースIDとトークンを入力します。

      プレビューAPIには、Content Preview API – access tokenという名前のContentfulアクセストークンが必要です。これは、ContentfulスペースのAPI設定で構成する必要があります。

      Contentful 2.0統合では、このAPIを使用してコンテンツのインポートと変更の監視（APC）を行います。

      • Contentfulから監視/インポートする各スペースと環境を選択してください。

      • セットアップとアクセスは、Contentful自体の中で管理されます。

    17. 保存をクリックします。

      コネクターが「コネクター」ページの一覧に追加されます。

    備考

    APCモニタリングは、Contentfulがどのロケールが変更されたかを報告しないため、実行のたびに追跡対象エントリとその参照の全コンテンツを再チェックします。参照エントリはバッチではなく個別に取得されるため、参照エントリが多いスペースでは、1回の実行でContentful Preview APIおよびContent APIへのリクエストが大量に発生する可能性があります。このため、ソースが変更されていない場合でも、翻訳を受け取った後にエントリが再インポートされることがあります。処理量の多いスペースでは、これによりAPCの実行が遅くなり、Contentful APIの使用量が大幅に増加する可能性があります。

    これを軽減するには：

    • エントリが完了したら翻訳タグを削除し、再翻訳が必要な場合にのみ再度追加してください。

    • 参照エントリの設定を、翻訳が必要なエントリのみに絞り込んでください。

    • Phrase Contentfulアプリを使用してください。このアプリは、それを通じて送信されたエントリのみを監視します。

      以前に翻訳されたエントリは、元のコピーに変更を加えた後、再送信できます。Phrase Contentfulアプリを使用する場合、再送信は手動で行われます。エディターはContentfulでエントリを開き、Phraseアプリのサイドバーを開いて最初からやり直すをクリックする（またはアプリダッシュボードから一括再送信を使用する）必要があります。そうすることで、APCがそれを検出し、既存のジョブのソースを更新します。これは、ファイルまたはフォルダー監視コネクタとは異なります。ファイルまたはフォルダー監視コネクタの場合、APCは手動での再送信を必要とせずに、ソースの変更を自動的に検出します。

    Contentful 2.0コネクタは、個々のユーザーではなく、組織に属します。コネクタが使用するContentful OAuthトークンは、それを承認したユーザーに紐付けられています。

    コネクタを別のContentfulユーザーにリンクするには、既存のOAuthトークンを削除して、別のユーザーがコネクタを再承認できるようにする必要があります：

    1. トークンを作成したContentfulアカウントを使用して、関連するスペースのAPIトークンページ（https://app.contentful.com/spaces/{space_id}/api/cma_tokens）を開きます。

    2. 「Memsource Connector」という名前のトークンを削除します。同じ名前のトークンが複数ある場合は、削除する前に、影響を受けるコネクタで使用されているトークンを確認してください。

    3. トークンが削除されると、新しいユーザーがPhrase TMSのコネクタ設定から再承認するまで、コネクタは無効になります。

    これらの手順は、元のユーザーのContentfulアクセス権が削除される前に完了してください。そうしないと、トークンが表示されなくなる可能性があります。

    Phrase TMS設定

    注意

    カスタムドメイン（例: mydomain.phrase.jp）からアクセスする場合は、シークレットブラウザウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.com経由でログインして、コネクタの作成または保存に必要な認証を行ってください。保存後、カスタムドメイン経由でコネクタにアクセスできるようになります。

    1. 設定Setup_gear.pngページから、[統合機能]セクションまでスクロールします。

    2. [コネクタ]をクリックします。

      「コネクタ」ページが開きます。

    3. [新しいコネクタ]をクリックします。

      [コネクタを作成]ページが開きます。

    4. タイプをContentful (Entry-Level)またはContentful (Field-Level)に変更し、コネクタの名前を入力します。

    5. コネクタをアプリで使用する場合は、必要に応じてPhrase Contentful Appチェックボックスを選択します。

      • Contentfulアプリトークン

        Phrase TMSのContentfulアプリケーションに入力するアプリトークンを生成します。トークンを生成し、それをContentfulアプリにコピーした後、コネクタを保存します。

      備考

      一度保存すると、Contentful内からトークンを変更することはできません。更新するには、Phrase TMSのコネクタ設定からトークンを取り消し、新しいトークンを生成してください。

    6. 言語に依存しない設定を構成します。

      • 原文言語

        Contentfulのデフォルト言語を上書きするソース言語を選択します。その後、コネクタはコネクタ設定で設定された言語からコンテンツを取得します。

        例：

        ContentfulでEN-USがデフォルト言語として設定されているものの、特定のスペースまたはコンテンツモデルのローカリゼーションのソース言語としてDE-DEが必要な場合、そのスペース（リモートフォルダ）がEN-USではなくDE-DEからコンテンツを取得するように設定を調整できます。

      備考

      アプリケーションの使用時には適用されません。

    7. エントリのインポートモードで、ネストされたコンテンツの処理方法を選択します。コンテンツは参照フィールドを使用して他のコンテンツを参照でき、エンティティの階層を作成できます。

      備考

      アプリケーションの使用時には適用されません。

      • Contentful (Entry-Level)

        エントリレベルのコネクタは、ネストされたコンテンツの階層全体を自動的に走査します。

      • Contentful (Field-Level)

        フィールドレベルのコネクタがネストされたコンテンツをインポートする方法を選択します。

        • 選択したエントリのみ

          • リポジトリから追加する際に明示的に選択されたコンテンツがインポートされます。

          • APCによって検出された変更が翻訳用にインポートされます。

        • 参照されているエントリをインポートする

          • コネクタはネストされたコンテンツの階層全体を走査し、翻訳可能なすべてのフィールドを翻訳用にインポートします。

    8. 翻訳可能なフィールドを除外にカンマ区切りのリストを作成し、このフィールドのローカライズを有効にするがチェックされているフィールドをPhrase TMSへのインポートから除外します。次の構造を使用してください：contentTypeID:fieldID。

      • リストされたフィールドを空のままにする場合は、除外されたフィールドを空のままにするを選択します。この設定はリストされているすべてのエントリに適用されます。

      • リストされたフィールドにソース値を含める場合は、ソースをターゲットにコピーを選択します。この設定はリストされているすべてのエントリに適用されます。

    9. ソース言語の特定のフィールドのデータが欠落している場合は、フォールバック言語を使用を選択します。

      必要に応じて、ドロップダウンリストからソース言語のフォールバックを選択します。この言語ロケールは、データが欠落している場合に使用されます。

      備考

      Contentfulのフォールバック言語とこの設定の間に関係はありません。

    10. 必要に応じて、ライブプレビューURL（BETA）を入力してください。

      これは、ContentfulのコンテンツをレンダリングしたページにアクセスするためのURLテンプレートです。以下のプレースホルダーを利用できます。

      • {env_id}:Environment ID

      • {entry.sys.id}:Entry ID

      • {space_id}:Space ID

      URLテンプレートは以下のようになります。

      https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}

      備考

      URLは、Contentfulのコンテンツをレンダリングするデプロイ済みのアプリケーションにアクセスできるものである必要があります。ライブプレビューを使用するには、URLテンプレート内のcontentfulapp.tldを、実際のアプリケーションのドメインに置き換えてください。

      コンテンツプレビューの設定について詳しくは、Contentfulのドキュメントを参照してください。

      現在、ロケールはプレースホルダーとしてサポートされていません。URLでロケールを使用するには、固定値を指定し、複数のコネクタインスタンスを作成します。

    11. テクニカルサポートチームからデバッグ情報のログ記録を要求された場合は、デバッグ情報をログに記録を選択してください。

    12. Contentfulに接続をクリックします。

      接続が成功すると、コネクタ設定にチェックマークが表示されます。そうでない場合、赤い感嘆符が表示されます。アイコンにカーソルを合わせると、詳細が表示されます。

    13. Contentful（エントリーレベル）のみ：

      ソース言語を設定します。

      備考

      この言語は、Contentfulのロケール設定で構成されているContentfulスペースのデフォルトロケールと一致している必要があります。

    14. 保存をクリックします。

      コネクターが「コネクター」ページの一覧に追加されます。

    15. 必要に応じて、コネクタを編集してContentfulワークフローを選択します。

      • 記事の翻訳元：

        コネクターは、選択したステージ（例: 要翻訳）の記事を監視します。翻訳の準備ができたら、作成者はこのラベルを記事に適用することができます。

      Contentfulからのインポート時：

      • 原文記事を以下に設定

        ソース記事がダウンロードされると、コネクタはワークフローを選択したステージ（例：翻訳中）に進めます。

      Contentfulへのエクスポート時：

      • 原文記事を以下に設定

        翻訳がエクスポートされると、コネクタはソース記事のワークフローのステージを選択したステージ（例：翻訳完了）に設定します。

      備考

      ワークフローのサポートは、2023年6月1日をもってContentfulにより終了されました。引き続き使用することはサポートされていません。

    この記事は役に立ちましたか？
    ★ ★ ★ ★ ★

    Sorry about that! In what way was it not helpful?

    The article didn’t address my problem.
    I couldn’t understand the article.
    The feature doesn’t do what I need.
    Other reason.

    Note that feedback is provided anonymously so we aren't able to reply to questions.
    If you'd like to ask a question, submit a request to our Support team.
    Thank you for your feedback.