Commerce Storefront Catalog Service リリースノート
これらのリリースノートでは、次のような最新のCommerce カタログサービスのアップデートについて説明しています。
-
ストアフロントカタログサービスリリース
- データ取得を改善するための Catalog Service API スキーマの機能強化。
- Catalog Service API とその基盤となるインフラストラクチャのセキュリティ、パフォーマンス、信頼性の向上。
-
Catalog Service metapackage リリース
- パフォーマンス、安定性、他のAdobe Commerce コンポーネントとの互換性を向上させるための依存関係を更新しました。
アップデートはタイプ別に分類されます。
最新バージョンのサポートが提供されています。 古いバージョンのリリースノートは参照用に含まれています。
Storefront カタログサービス
v1.48 リリース
2025 年 2 月 19 日
categoryTree クエリで、カテゴリの説明、画像および SEO メタタグを返すようになりました。 この更新により、ストアフロントの開発者がカテゴリ画像を表示し、適切なメタタイトル、説明およびキーワードで検索エンジンの最適化を向上させるために必要なデータが提供されます。 ヘッドレスストアフロントの場合、 コンポーザブルカタログデータモデル を使用したCommerce実装でのみサポートされます <
v1.47 リリース
2025 年 2 月 12 日
CategoryProductView タイプがサポートされ、カテゴリ別の製品の拡張ビューとクエリが有効になりました。 この更新により、開発者はカテゴリに基づいて製品データを効率的に取得およびフィルタリングでき、カテゴリ駆動型のユースケースの柔軟性とパフォーマンスが向上します。 詳しくは、 ストアフロントでのカテゴリの実装 を参照してください。 ヘッドレスストアフロントの場合、 構成可能なカタログデータモデル を使用したCommerce実装でのみサポートされま 。
v1.46 リリース
2025 年 12 月 11 日
v1.45 リリース
2025 年 11 月 17 日
productSearch GraphQL クエリで、names フィールドを使用した製品属性のフィルタリングがサポートされるようになりました。 このフィルターを使用すると、次のことができます。
-
特定の属性のみをリクエストすることで、応答のペイロードサイズを削減
-
既存の
rolesフィルターと組み合わせて、表示ロールと属性名で絞り込みます -
例:
属性名のみでフィルタリング
code language-graphql query { products(skus: ["SKU-001"]) { attributes(names: ["color", "size", "material"]) { name label value } } }役割と名前の両方でフィルタリング:
code language-graphql query { products(skus: ["SKU-001"]) { attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) { name label value roles } } }
names 引数を省略するか、空の配列を指定します。v1.44 リリース
2025 年 11 月 6 日
v1.43 リリース
2025 年 11 月 3 日
-
様々な製品コンテンツを様々な顧客セグメントに提供する
-
ベースデータを複製せずにロケール固有のカスタマイズを適用する
-
レイヤーマスクを使用したフィールドレベルのオーバーライドの制御
-
プレミアム、季節ごとのコンテンツ、モバイルに最適化されたコンテンツレイヤーのサポート
レイヤーは、既存の
productsクエリを使用して取得され、リクエストヘッダーからサーバーサイドで適用され、スキーマの変更は必要ありません。 詳しくは、Adobe Commerce Optimizerガイドの カタログレイヤー を参照してください
v1.42 リリース
2025 年 9 月 8 日
階層レベルの価格を取得するには:
- 目的の SKU で
productsクエリを使用します - SimpleProductView の場合、
price.tiersにアクセスします - ComplexProductView については、
priceRange.minimum.tiersおよびpriceRange.maximum.tiersにアクセスします - 各階層には、割引された
tier価格とquantity条件が含まれます gte(以上)およびlt(以下)の数量しきい値を定義します
例:
query {
products(skus: ["SKU-001"]) {
... on SimpleProductView {
price {
regular { amount { value currency } }
tiers {
tier { amount { value currency } }
quantity {
... on ProductViewTierRangeCondition { gte lt }
}
}
}
}
}
}
API は、割引価格が製品の最終価格の最低価格 下 の層のみを返すようになりました。 ストアフロントには最終価格の最小値が適用されるので、より高い階層は省略されます。
適用先:
- シンプル製品:
price.tiersには、tier.amount.value<price.final.amount.value(最小最終)の階層のみが含まれます。 - 複雑な製品:
priceRange.minimum.tiersとpriceRange.maximum.tiersは、価格範囲を作成する際に同じルールを使用します。
v1.41 リリース
2025 年 9 月 2 日
null を返し、クライアントが欠落しているデータを適切に処理できるようにします。
v1.40 リリース
2025 年 7 月 30 日
v1.39 リリース
2025 年 7 月 24 日
recommendationsByUnitIds より柔軟でターゲットを絞ったアクセスのために、一意の ID でレコメンデーションユニットを取得します。
-
unitIdsは必須です(取得する recId のリスト)。 -
コンテキストパラメーター(
currentSku、cartSkus、userViewHistory、userPurchaseHistory、category)は、既存のレコメンデーションクエリと同じように動作します。 -
例
code language-graphql query { recommendationsByUnitIds( unitIds: ["11ee89d1-bfae-4582-a921-2ced44ff6bf7"] currentSku: "24-MB01" cartSkus: ["24-MB01"] ) { totalResults results { unitId unitName totalProducts productsView { sku } pageType typeId storefrontLabel displayOrder } } }
v1.38 リリース
2025 年 7 月 15 日
v1.37 リリース
2025 年 6 月 20 日
v1.36 リリース
2025 年 6 月 20 日
v1.35 リリース
2025 年 6 月 13 日
Magento-Is-Preview ヘッダーを有効にして、キャッシュされていないデータをカタログエンドポイントから検索サービスに渡します。
v1.34 リリース
2025 年 3 月 23 日
v1.33 リリース
2025 年 4 月 29 日
v1.32 リリース
2025 年 3 月 28 日
v1.31 リリース
2025 年 2 月 18 日
v1.30 リリース
2024 年 12 月 9 日
メジャーリリース:ヘッドレスストアフロント、ヘッダー管理、製品データ処理のための 構成可能なカタログデータモデル 。
AC-Locale を、構成可能なカタログ API 操作のために AC-Scope-Locale に名前を変更しました。ヘッダーマッピングとデフォルト値を指定しました。
CurrencyEnum は、フェデレーション ロジックに合わせて、製品検索クエリの NONE をサポートするように更新されました。
v1.29 リリース
2024 年 12 月 9 日
images」フィールドの商品画像がカタログの書き出し sortOrder に従って、ストアフロントと API の動作が一貫するようになりました。
v1.28 リリース
v1.27 リリース
2024 年 9 月 26 日
v1.26 リリース
2024 年 10 月 22 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
lastModifiedAt が含まれるようになりました。
v1.23 リリース
2024 年 8 月 22 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.
v1.22 リリース
2024 年 8 月 13 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
v1.19 リリース
2024 年 5 月 23 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
InStock フラグは、製品バリアントのスコーピングされた enabled ステータスを尊重するようになりました。
既知の制限事項
次の機能は、まだサポートされていません。
- 動的属性ペイロードの最大サイズは 9 MB です。
- グループ商品価格はシンプルな商品価格で算出できます。
- 画像配列では、最初の画像にのみ役割が含まれます。
次の場合は、API メッシュとコア GraphQL API を使用します。
- 広告の最低価格
- 階層の価格
- 固定価格で製品をバンドル
詳細と例については、 カタログサービスと API メッシュ を参照してください。
v1.18 リリース
2024 年 4 月 11 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
products クエリと refineProduct クエリは、シンプルな製品と複雑な製品の両方でカスタマイズ可能なオプションデータを返すようになりました。
v1.17 リリース
2024 年 2 月 22 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
catalog-service metapackage v3.1.0 以降が必要です。
v1.16 リリース
2024 年 2 月 13 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
既知の制限事項
これらの機能は、まだサポートされていません。
- 動的属性ペイロードの最大サイズは 9 MB です。
- グループ製品価格。 この値は、単純な製品価格で計算できます。
- 画像配列では、最初の画像にのみ役割が含まれます。
次の場合は、API メッシュとコア GraphQL API を使用します。
- 広告の最低価格
- 階層の価格
v1.13 リリース
2023 年 10 月 12 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
inStock フラグをサポートしています。
urlKey フィールドと externalId フィールドがGraphQL スキーマに追加されました。
v1.12 リリース
2023 年 9 月 19 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
v1.11 リリース
2023 年 7 月 18 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
recommendations GraphQL クエリがサポートされるようになりました。
v1.10 リリース
2023 年 6 月 27 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
related products がサポートされるようになりました。
v1.7 リリース
2023 年 4 月 12 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
v1.6 リリース
2023 年 3 月 28 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
products クエリにスウォッチを追加しました。
entityIdAPI メッシュ を使用して を取得する機能が追加されました。
v1.5 リリース
2023 年 3 月 6 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
categories 追加しました。
v1.4 リリース
2023 年 2 月 7 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.x 以降
v1.3 リリース
2023 年 1 月 17 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.x 以降
v1.1 リリース
2022 年 11 月 18 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.x 以降
v1.0 リリース
2022 年 10 月 4 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.x 以降
0.3 リリース - Beta+
2022 年 9 月 12 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.x 以降
Beta リリース
2022 年 8 月 9 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.x 以降
products クエリと refineProduct クエリは、次のデータを返します。
- 事前定義済み(システム)製品属性。
- 製品の動的属性および役割別のフィルター(製品の表示ページ/製品のリストページ)。
- 製品オプション。
- 製品画像を役割(PDP/PLP)別にフィルタリングする方法を説明します。
- シンプルな製品の特定の価格と設定可能な製品の価格範囲。
- 顧客グループの価格と価格範囲。 顧客グループを持たない買い物客に対しては、フォールバックのデフォルト価格が返されます。
- B2B 顧客固有の価格を使用する製品タイプ。
Catalog Service メタパッケージ
カタログサービスの PHP メタパッケージ (magento/catalog-service)を更新しました。
-
Adobe Commerce as a Cloud Serviceをご利用のお客様の場合、お使いの環境に最新バージョンがインストールされています。
-
オンプレミスのクラウド上のAdobe Commerceの場合、Adobeでは Composer を使用して、クラウド環境のカタログサービスメタパッケージを最新リリースにアップグレードすることをお勧めします。
v3.3.0 リリース
2025 年 10 月 14 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
magento/data-services 依存関係が^8.0.0 に更新されました。アップグレードする前に、8.x の互換性に関する環境およびカスタム Data Services API の使用状況を確認してください。
ea
v3.2.0 リリース
2024 年 4 月 12 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
v3.1.0 リリース
2024 年 1 月 26 日
[ サポート対象 ]{class="badge informative" title="サポート"} Adobe Commerce バージョン 2.4.4 以降
- カタログサービスで使用されるカテゴリ権限データを書き出すための カテゴリ権限データエクスポーター (
magento/module-category-permission-data-exporter)。 - カタログ同期に関連する管理 UI および設定の カタログ同期管理者
magento/module-catalog-sync-admin。
関連ドキュメント
-
Adobe Commerce on cloud、オンプレミスまたはAdobe Commerce as a Cloud Serviceにデプロイされたプロジェクトの場合は、次のドキュメントを参照してください。
-
Adobe Commerce Optimizer または Adobe Commerce Optimizer Connector を使用するプロジェクトの場合は、次のドキュメントを参照してください。