GraphQL APIにより構造化コンテンツをスケーラブルに配信

従来のREST APIは、複数のサーバー呼び出しや過剰なデータペイロードによりアプリケーションに負荷をかけ、パフォーマンスを低下させ、開発を複雑化させます。Adobe Experience Manager Sitesは、ネイティブGraphQL APIによりこの課題を解決し、フロントエンドチームが単一の効率的なリクエストで必要なコンテンツを正確にクエリできるようにします。

Adobe Experience Manager Sitesは、エンタープライズCMSの標準ソリューションとして、構造化されたコンテンツ管理と現代的な配信機能を統合しています。GraphQL統合により、固定的なエンドポイント構造が不要になり、webサイト、アプリ、デジタルエクスペリエンスなどにおいてスケーラブルかつ高性能なコンテンツ配信が可能になります。

今日のコンポーザブルアーキテクチャ向けに設計されたAdobe Experience Manager Sites GraphQL APIは、ページの読み込みの高速化、開発の俊敏性の向上をもたらし、進化する顧客の要求に大規模かつ正確に対応するために企業が必要とする柔軟性を提供します。

Adobe Experience ManagerのGraphQL APIは、特にコンテンツフラグメントなどの構造化コンテンツを、あらゆるデジタルチャネルでのヘッドレス配信向けに公開するように設計されています。単一の柔軟なエンドポイントとして機能するAPIにより、クライアントアプリケーションは、必要なコンテンツを正確かつ必要なタイミングで取得できます。

この現代的なグラフベースのアプローチは、従来のRESTメソッドに比べて明確な利点を提供します。

• 効率性： 複雑にネストされたコンテンツ構造を単一のAPI呼び出しで取得できるので、複数のエンドポイントを組み合わせる必要がなくなります。これにより、開発が簡素化され、ページ読み込み速度が向上します。
• 精度： 開発者は必要なフィールドのみをクエリするため、ペイロードサイズが削減され、特にモバイルネットワークでのパフォーマンスが向上します。
• 柔軟性： GraphQL APIはフロントエンドに依存しないため、React、Angular、Vueなど、あらゆるフレームワークを使用して開発でき、独自のSDKに縛られることはありません。

GraphQLスキーマの生成

Adobe Experience Manager Sitesは、コンテンツフラグメントモデルからGraphQLスキーマを自動的に生成し、ヘッドレス開発を簡素化します。手作業でのスキーマ作成は不要です。コンテンツアーキテクトがモデルを定義または更新すると、Adobe Experience Managerはその変更を即座に対応するエンドポイントの完全に型定義されたライブGraphQLスキーマに変換します。

この動的なスキーマ生成により、エンタープライズレベルの利点が得られます。

• 強い型付けと早期検証： スキーマ強制型付けは、予測可能な結果を保証し、クエリ実行前に無効なクエリを検出し、開発時間とエラーを削減します。
• 組み込みのイントロスペクション： 開発者はスキーマ自体をクエリでき、GraphQLツールで自動補完、検証、インラインドキュメントなどの機能を利用できます。
• コンテンツ主導の一貫性： スキーマは実際のコンテンツ構造を反映し、信頼できる唯一の情報源として機能します。コンテンツ作成者と開発者の緊密な連携により、コラボレーションが効率化され、スキーマの乖離が防がれます。

Adobe Experience Manager Sitesは、スキーマ生成の自動化によりヘッドレス構築を加速し、メンテナンスのオーバーヘッドを削減し、構造化コンテンツとスケーラブルな配信のギャップを埋めます。

GraphQLで必要なデータを正確にクエリ

GraphQLによりクライアントアプリケーションは、コンテンツリクエストの構造と詳細を完全に制御できます。Adobe Experience Manager Sitesでは、GraphQLクエリを使用して、アプリケーション要件に最適化された構造化コンテンツをコンテンツフラグメントから効率的に取得できます。主な機能は次のとおりです。

• フィールドの選択： 必要なフィールドのみを取得し、不要なデータを省略することで、データ転送量を最小限に抑え、パフォーマンスを向上させます。
• ターゲットを絞ったコンテンツフラグメントへのアクセス： パスを指定して個別のコンテンツフラグメントをクエリしたり、モデルタイプごとにリストを返すことができます。
• 高度なフィルタリング： フィールドの値にフィルタを適用して、検索結果を絞り込むことができます。
• ネストされたコンテンツの取得： 単一のクエリでネストされたまたはリンクされたコンテンツフラグメントを取得でき、複雑なコンテンツ構造に最適です。
• ローカライズされたコンテンツとバリエーション： フラグメントの特定のバリエーションをリクエストし、パーソナライズされた体験や地域やチャネル別の体験を提供できます。
• 変数を使用した動的クエリ： IDや検索用語などの値を実行時に入力することで、構造を変更せずに柔軟で再利用可能なクエリを構築できます。

Adobe Experience Manager SitesのGraphQLでは、スピード、スケーラビリティ、精度を重視して設計された、ヘッドレスコンテンツアクセス用のパワフルで直感的なインターフェイスを利用できます。

Adobe Experience Manager Sitesでは、GraphQLクエリは、指定エンドポイント（ヘッドレスコンテンツ配信のアクセスポイントとして機能する特定のURL）に送信されます。REST APIのように異なるリソースごとに複数のエンドポイントが必要な場合とは異なり、GraphQLは、設定ごとに単一のエンドポイントを通じてインタラクションを一元管理するため、開発が簡素化され、保守性が向上します。

Adobe Experience Manager SitesのGraphQLエンドポイントは、適切なガバナンスを維持するために管理者によって明示的に構成、有効化、公開する必要があります。このアプローチは、構造化されたコンテンツを公開する前にセキュリティと制御を強化します。Adobe Experience Manager Sitesは2種類のGraphQLエンドポイントをサポートします。

• グローバルエンドポイント： グローバル設定で定義されたコンテンツフラグメントモデルへのアクセスを許可します。これには、サイトに固有の設定のモデルも含まれます。プロジェクト間で共有されるコンテンツ構造の再利用に最適です。
• サイト固有のエンドポイント： 特定のサイトまたはプロジェクト設定に紐付けられ、その設定のモデルとグローバルスコープのモデルにのみアクセスを許可します。これにより、明確な隔離が可能で、プロジェクトをまたいだ露出を最小限に抑えることができます。

この柔軟な設定により、企業はブランド、地域、事業部門などをまたいでコンテンツ配信を精確に管理でき、セキュリティや明確さを損なうことなくスケーラビリティを確保できます。