ヒント
Phrase StringsにおけるContentful統合の詳細については、Contentful (Strings)を参照してください。
Contentfulは、あらゆるプラットフォームやデバイスに対してコンテンツを作成、管理、配信するためのヘッドレスコンテンツ管理インフラストラクチャを提供します。Phraseは、以下の2つの方法でContentfulと統合します：
-
専用のContentfulコネクタ経由（2.0、エントリーレベル、フィールドレベル）
Contentful 2.0コネクタは現在、米国データセンター経由の認証のみをサポートしています。
-
カスタマイズされたエクスペリエンスのためのContentful Marketplaceプラグイン経由
備考
このコネクタは、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アプリケーションを使用する場合：
-
マーケットプレイスからPhrase TMSアプリケーションをダウンロードします。
-
アプリケーションを現在アクティブなスペースにインストールし、アプリケーションのインストールが必要なコンテンツモデルを選択します。
-
Phrase TMS内でコネクタを作成する際に取得したPhrase TMS認証トークンを入力します。
-
インストールをクリックします。
オプション - アプリを起動（Contentfulにより非推奨）
ContentfulのLaunch App経由でワークフローサポートを使用する場合は、以下の手順に従ってください。
-
ContentfulのLaunchアプリケーションを1つ以上のスペースにインストールします。
備考
1つのスペースにつき作成できるワークフローは1つだけです。1つのContentfulスペース内で異なるコンテンツタイプのアプローチが必要な場合は、担当のカスタマーサクセスマネージャーにお問い合わせください。
-
必要なローカリゼーションワークフローを設定します。
-
説明されているワークフローに従うコンテンツタイプを選択します。
コネクタでワークフローが設定されている場合、監視対象のアーティクルまたはコンテンツタイプでワークフローのステップに変更が検出されると、自動プロジェクト作成（APC）機能によって新しいプロジェクトが自動的に作成されます。
送信済みのジョブはキャンセルできるため、変更を加えた後にコンテンツを再送信できます。これらのジョブはPhrase内に残るため、プロジェクトマネージャーが削除する必要があります。
備考
Contentful Launch Appは、2.0コネクタではサポートされていません。
-
設定
ページから、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
新しいコネクタをクリックします。
ページが開きます。
-
タイプをContentful 2.0に変更します。
-
コネクタの名前を入力します。
-
Connect to Contentful 2.0 をクリックします。
Contentfulのログインウィンドウが開きます。
-
ログイン情報を入力し、Log in をクリックします（または他のログイン方法を使用します）。ログインウィンドウが閉じ、 と表示されます。
-
アプリでコネクタを使用する場合は、必要に応じて Phrase Contentful App チェックボックスを選択します。
-
Generate token をクリックします。
ウィンドウが開きます。
-
Generate token をクリックします。
トークンが生成されます。これをクリップボードまたはテキストファイルにコピーしてください。トークンは再度表示されないため、ウィンドウを閉じる前に必ずコピーしてください。このトークンは、アプリに接続する際に使用されます。
-
ウィンドウを閉じると、 と表示されます。
-
-
Contentful Tags を使用して翻訳可能なコンテンツを識別する場合は、タグIDを入力して Enter を押します。
IDが表示され、さらに追加することができます。タグを使用して、Contentfulからコネクタに表示されるコンテンツを制限できます。
-
必要に応じて、 を選択します。
-
必要に応じて、 （ネストされたコンテンツ）を選択します。
が表示されます。目的のフィルターを適用して、システムがコンテンツの関係をどのようにトラバースするかについて、より詳細な制御を確立します。
-
インポート中にPhraseが参照エントリをたどる深さを制限します。
デフォルト値は10,000です。必要に応じて、他の値を選択するか、カスタム整数値を指定します。
-
指定されたリストとコンテンツタイプが一致するエントリで停止するか、それらのエントリを追跡するかを選択します。
-
親コンテンツタイプが指定されたリストと一致するエントリを除外します。
-
指定されたコンテンツタグのいずれかを持つエントリで停止するか、それらのエントリを追跡するかを選択します。
-
指定されたフィールドIDによって参照されるエントリで停止するか、それらのエントリを追跡するかを選択します。
-
-
必要に応じて、を選択します。
フィールドが表示されます。タクソノミ設定を有効にするには、値を入力してください。
-
選択すると、コネクタはContentfulからタクソノミを取得し、それらを.XLIFF fileに含めます。CAT editorのペインには、各セグメントのContentfulタクソノミ値が一覧表示されます。
-
タクソノミのメタデータが利用できない場合、またはコネクタがそれを使用して構成されていない場合、ペインは単に省略されます。
-
プロジェクトで機能/画面のコンテキストが不要な場合は、.XLIFFエクスポート時のパフォーマンスを最適化するために、タクソノミを無効のままにすることをお勧めします。
-
-
必要に応じて、を選択します。
aliasは、すべてのAPC監視およびジョブの再インポート/エクスポートに使用されます。将来エイリアスのターゲットが変更された場合、APCは新しいターゲット内のコンテンツを監視し、ジョブは新しいエイリアスターゲットとの間で再インポート/エクスポートされます。
-
（デフォルトおよび推奨）
APCおよび作成されたジョブは、ジョブ/APC作成時にエイリアスが指していた環境に紐付けられます。APCはその環境とコンテンツのみを監視し、ジョブはその環境に対してエクスポートおよび再インポートされます。
-
APCおよび作成されたジョブは、エイリアス自体に紐付けられます。APCはそのエイリアスとコンテンツのみを監視し、ジョブはそのエイリアスに対してエクスポートおよび再インポートされます。
エイリアスのターゲットが変更された場合、APCは新しいエイリアスターゲット（環境）を監視し、ジョブは今後そのターゲットに対してエクスポートおよび再インポートされます。
Contentfulのカスタムロールには、エイリアスそのものだけでなく、エイリアスが指し示す特定の基盤環境への直接アクセス権が必要です。これがないと、Phrase TMSアプリのダッシュボードが読み込まれません。このアクセス権は、Contentfulのにある、ロールのセクションで追加してください。エイリアスが後で別の環境を指すように変更された場合は、新しい環境へのアクセス権も追加してください。
-
-
必要に応じて、を指定してください。
これは、Contentfulからレンダリングされたコンテンツへ導くURLテンプレートです。以下のプレースホルダーを利用できます。
-
env_id:Environment ID
-
Entry IDEntry ID
-
Space IDSpace ID
URLテンプレートは以下のようになります：
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}
備考
URLは、Contentfulのコンテンツをレンダリングするデプロイ済みのアプリケーションへ導く必要があります。ライブプレビューを使用するには、URLテンプレート内の
contentfulapp.tldを、アプリケーションの実際のドメインに置き換えてください。コンテンツプレビューの設定に関する詳細については、Contentfulのドキュメントを参照してください。
現在、ロケールはプレースホルダーとしてサポートされていません。URLでロケールを使用するには、固定値を指定し、複数のコネクタインスタンスを作成してください。
-
-
必要に応じて、を使用して、特定のフィールドをPhraseへのインポート対象から除外してください。インポートから除外するContentIDを指定してください。
-
に必要なとを指定してください。
プレビューAPIには、という名前のContentfulアクセストークンが必要です。これはContentfulスペースのAPI設定で構成する必要があります。
Contentful 2.0統合では、コンテンツのインポートおよび変更の監視（APC）にこのAPIを使用します。
-
Contentfulから監視/インポートする各スペースと環境を選択してください。
-
設定とアクセス権はContentful自体の中で管理されます。
-
-
保存をクリックします。
コネクターがページの一覧に追加されます。
備考
APC監視では、Contentfulがどのロケールが変更されたかを報告しないため、実行のたびに追跡対象エントリとその参照の全コンテンツを再チェックします。参照エントリはバッチではなく個別に取得されるため、参照エントリが多いスペースでは、1回の実行でContentfulプレビューAPIおよびコンテンツAPIへのリクエスト数が多くなる可能性があります。このため、ソースに変更がない場合でも、翻訳を受け取った後にエントリを再インポートできます。大容量のスペースでは、これによりAPCの実行が遅くなり、Contentful APIの使用量が大幅に増加する可能性があります。
これを軽減するには：
-
エントリが完了したら翻訳タグを削除し、再翻訳が必要な場合にのみ再度追加してください。
-
の設定を、翻訳が必要なエントリのみに絞り込みます。
-
Phrase Contentfulアプリを使用してください。このアプリは、それを通じて送信されたエントリーのみを監視します。
以前に翻訳されたエントリーは、元のコピーに変更を加えた後に再送信できます。Phrase Contentfulアプリを使用する場合、再送信は手動で行われます。エディタはContentfulでエントリを開き、Phraseアプリのサイドバーを開いてStart overをクリックする（またはアプリダッシュボードから一括再送信を使用する）必要があります。その後、APCがそれを取得し、既存のジョブのソースを更新します。これは、APCが手動での再送信を必要とせずにソースの変更を自動的に検出する、ファイルまたはフォルダ監視コネクタとは異なります。
注意
カスタムドメイン（例：mydomain.phrase.jp）からアクセスする場合は、シークレットブラウザウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.com経由でログインして、コネクタの作成または保存に必要な認証を適用してください。保存後、カスタムドメイン経由でコネクタにアクセスできるようになります。
-
設定
-
[コネクタ]をクリックします。
ページが開きます。
-
New connectorをクリックします。
ページが開きます。
-
「Type」をいずれかのContentful (Entry-Level)またはContentful (Field-Level)に変更し、コネクタの名前を入力してください。
-
アプリでコネクタを使用する場合は、必要に応じて Phrase Contentful App チェックボックスを選択します。
-
Contentfulアプリのトークン
Phrase TMS Contentfulアプリケーションに入力するアプリトークンを生成します。トークンを生成し、それをContentfulアプリにコピーした後、コネクタを保存します。
備考
一度保存すると、Contentful内からトークンを変更することはできません。更新するには、Phrase TMSのコネクタ設定からトークンを取り消し、新しいトークンを生成してください。
-
-
言語に依存しない設定を構成します。
-
原文言語
Contentfulのデフォルト言語を上書きするソース言語を選択します。その後、コネクタはコネクタ設定で設定された言語からコンテンツを取得します。
例：
備考
アプリケーションを使用している場合は適用されません。
-
-
ネストされたコンテンツの処理方法をエントリインポートモードで選択します。コンテンツは参照フィールドを使用して他のコンテンツを参照でき、エンティティの階層を作成できます。
-
Contentful (エントリレベル)
エントリレベルのコネクタは、ネストされたコンテンツの階層全体を自動的にトラバースします。
-
Contentful (フィールドレベル)
フィールドレベルのコネクタがネストされたコンテンツをインポートする方法を選択します。
-
-
リポジトリから追加する際に明示的に選択されたコンテンツがインポートされます。
-
APCによって検出された変更が翻訳用にインポートされます。
-
-
参照エントリをインポート
-
コネクタはネストされたコンテンツの階層全体をトラバースし、翻訳可能なすべてのフィールドを翻訳用にインポートします。
-
-
-
-
翻訳可能なフィールドを省略にカンマ区切りのリストを作成し、がチェックされているフィールドをPhrase TMSへのインポートから除外します。次の構造を使用します：
contentTypeID:fieldID。-
リストされたフィールドを空のままにする場合は、省略されたフィールドを空にするを選択します。この設定はリストされているすべてのエントリに適用されます。
-
リストされたフィールドにソース値を含める場合は、ソースをターゲットにコピーを選択します。この設定はリストされているすべてのエントリに適用されます。
-
-
ソース言語で特定のフィールドのデータが欠落している場合は、を選択します。
必要に応じて、ドロップダウンリストからを選択します。この言語ロケールは、データが欠落している場合に使用されます。
備考
Contentfulのフォールバック言語とこの設定の間に関係はありません。
-
必要に応じて、（BETA）を提供してください。
これは、Contentfulからレンダリングされたコンテンツへ導くURLテンプレートです。以下のプレースホルダーを利用できます。
-
env_id:Environment ID
-
entry.sys.id:Entry ID
-
Space IDSpace ID
URLテンプレートは以下のようになります：
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
備考
URLは、Contentfulのコンテンツをレンダリングするデプロイ済みのアプリケーションへ導く必要があります。ライブプレビューを使用するには、URLテンプレート内の
contentfulapp.tldを、アプリケーションの実際のドメインに置き換えてください。コンテンツプレビューの設定に関する詳細については、Contentfulのドキュメントを参照してください。
現在、ロケールはプレースホルダーとしてサポートされていません。URLでロケールを使用するには、固定値を指定し、複数のコネクタインスタンスを作成してください。
-
-
テクニカルサポートチームからデバッグ情報のログ記録を要求された場合は、を選択します。
-
Contentfulに接続をクリックします。
接続が成功すると、コネクタ設定にチェックマークが表示されます。そうでない場合、赤い感嘆符が表示されます。アイコンにカーソルを合わせると、詳細が表示されます。
-
Contentful（エントリーレベル）のみ：
ソース言語を設定します。
備考
この言語は、ContentfulのLocales設定で構成されているContentfulスペースのデフォルトロケールと一致している必要があります。
-
保存をクリックします。
コネクターがページの一覧に追加されます。
-
オプションで、コネクタを編集してを選択します。
-
原文記事の翻訳
コネクターは、選択したステージ（例: 要翻訳）の記事を監視します。翻訳の準備ができたら、作成者はこのラベルを記事に適用することができます。
Contentfulからのインポート時
-
ソース記事がダウンロードされると、コネクタはワークフローを選択したステージ（例：Translation in Progress）に進めます。
Contentfulへのエクスポート時
-
翻訳がエクスポートされると、コネクタはソース記事のワークフローのステージを選択したステージ（例：Translations Completed）に設定します。
備考
ワークフローのサポートは、June 1, 2023にContentfulによって終了されました。継続的な使用はサポートされていません。
-
コネクタを削除する
コネクタを削除するには：
-
ページから、削除するコネクタを選択します。
-
削除をクリックします。
ウィンドウが開きます。
-
「delete」と入力し、Deleteをクリックします。
コネクタが削除され、コネクタのリストが表示されます。
備考
プロジェクト内の未完了のジョブ（ごみ箱にあるジョブを含む）にまだリンクされているコネクタは削除できません。そのようなコネクタを削除しようとすると、「Failed to delete connector」エラーが返されます。
解決策：コネクタに関連付けられているプロジェクトを開き、残りのジョブを完了または削除してください。に移動し、コネクタにまだリンクされているジョブをすべて削除するために空にしてください。コネクタの削除を再試行してください。