文件CommerceCatalog Service 指南

Commerce Storefront Catalog Service發行說明

Last update: Thu Feb 19 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員

下列發行說明涵蓋最新的Commerce Catalog Service更新，包括：

  • 店面目錄服務發行版本

    • 目錄服務API結構描述增強功能，可改善資料擷取。
    • 目錄服務API和基礎基礎結構的安全性、效能和可靠性改善。

  • 目錄服務中繼套件發行版本

    • 更新相依性，以提升效能、穩定性以及與其他Adobe Commerce元件的相容性。

更新會依型別分類：

新 新功能
修正 修正和改良
錯誤 已知問題

支援最新版本。 隨附舊版發行說明以供參考。

店面目錄服務

v1.48版本

2025年2月19日

新增 GraphQL API中的categoryTree查詢現在會傳回類別說明、影像和SEO中繼標籤。 此更新提供店面開發人員顯示類別影像所需的資料，並透過適當的中繼標題、說明和關鍵字改善搜尋引擎最佳化。 僅支援針對Headless店面<使用可撰寫目錄資料模型的Commerce實作

v1.47版本

2025年2月12日

新 API服務現在支援CategoryProductView型別，可依類別啟用產品的增強型檢視和查詢。 此更新可讓開發人員根據類別有效率地擷取及篩選產品資料，改善類別導向使用案例的彈性和效能。 如需詳細資訊，請參閱實作店面上的類別。 僅支援針對Headless店面使用可撰寫目錄資料模型的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
    }
  }
}
NOTE
若要擷取所有屬性而不進行篩選，請省略names引數或提供空陣列。

v1.44版本

2025年11月6日

修正 系統層級和基礎建設的改善，以強化效能和穩定性。

v1.43版本

2025年11月3日

新增 多維度產品自訂的產品層 — 已針對Adobe Commerce Optimizer實作新增通道特定、地區設定感知的內容傳遞支援。

  • 為不同的客戶區段提供不同的產品內容

  • 套用地區特定自訂而不複製基本資料

  • 使用圖層遮色片控制欄位層級覆寫

  • 支援優質、季節和行動最佳化內容層

    使用現有products查詢擷取圖層、從請求標頭套用至伺服器端，且不需要變更結構描述。 請參閱Adobe Commerce Optimizer指南中的​目錄層。

修正 當父項沒有訂價時，現在可以查詢已分組的產品；子項產品會傳回自己的可見性角色。

修正 系統層級和基礎建設的改善，以強化效能和穩定性。

v1.42版本

2025年9月8日

新 已新增層級定價支援​以查詢磁碟區定價：

若要擷取階層訂價，請執行下列步驟：

  1. 搭配您想要的SKU使用products查詢
  2. 針對​SimpleProductView，存取price.tiers
  3. 針對​ComplexProductView，存取priceRange.minimum.tiers和priceRange.maximum.tiers
  4. 每個層級都包含折扣的tier價格和quantity條件
  5. 使用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日

修正 已改善遺失價格資訊的錯誤處理 — 尚未收到價格資料時，API會傳回價格欄位的null，而非擲回錯誤，讓使用者端能夠妥善處理遺失的資料。

修正 系統層級和基礎建設的改善，以強化效能和穩定性。

v1.40版本

2025年7月30日

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

v1.39版本

2025年7月24日

新的 依單位ID擷取建議單位 — 新的GraphQL端點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日

新的 禮卡產品型別 — 目錄店面服務現在支援產品屬性為JSON物件或陣列，可彈性管理複雜型別，例如禮卡。

v1.37版本

2025年6月20日

新的 階層式價格簿組態 — 上下階價格簿的精確價格範圍。 計算會遵循階層與繼承的規則；當連結多重價格簿時，可減少訂價錯誤。 僅限Adobe Commerce Optimizer。 檢視價格手冊。

新 不區分大小寫的索引鍵 — 查詢中的索引鍵查閱現在不區分大小寫，可減少因索引鍵大小寫造成的錯誤。

v1.36版本

2025年6月20日

新 目錄店面的公用IO事件 — 已新增公用IO事件，以便即時整合和可觀察性（CSS和EDS）。

新的 伺服器端轉譯(SSR) — 支援SSR的架構改進，可在大型目錄上提供更優異的效能、SEO和UX。

新 基礎架構和安全性 — 事件服務的新AWS角色、ServiceNow整合和CI/CD管道。

新 事件格式和可觀察性 — 簡化裝載、增強監控、改善變體事件資料。

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

舊版

v1.35版本

2025年6月13日

新的 擷取未快取的資料 — 啟用Magento-Is-Preview標頭以將未快取的資料從目錄端點傳遞至搜尋服務。

新的 多重選取產品選項-GraphQL API現在會公開產品選項是否允許多重選取（例如，套件組合「選擇多個專案」）。

新的 資料擷取已更新價格驗證，以支援沒有價格的產品。

修正 已改善Adobe Commerce Optimizer中簡單套件定價的錯誤處理。

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

v1.34版本

2025年3月23日

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

v1.33版本

2025年4月29日

修正 系統層級和基礎建設改善。 基礎架構現在支援超大型的目錄（最多達4.4億SKU），不會影響現有的工作負載。

v1.32版本

2025年3月28日

修正 沒有角色的屬性預設不再為可撰寫的目錄編制索引，因此可縮短編制索引的時間並減少儲存空間。 舊版行為可透過功能標幟重新啟用。

修正 系統層級和基礎建設改善，以強化安全性、效能和穩定性。

v1.31版本

2025年2月18日

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

v1.30版本

2024年12月9日

主要版本： Headless店面、標題管理和產品資料處理的可撰寫目錄資料模型。

新的 可撰寫的目錄資料模型(CCDM) — 支援客戶將Composable目錄用於Headless店面。 新端點接受目錄檢視和原則ID （向後相容）。 可設定的產品詳細資料和價格（內建分頁）。

針對可撰寫的目錄API作業， New 標題管理-AC-Locale已重新命名為AC-Scope-Locale；已指定標題對應和預設值。

新的 產品資料與價格 — 支援可撰寫的目錄資料模型，並改善可設定產品價格處理。

已更新CurrencyEnum以支援NONE產品搜尋查詢，與同盟邏輯一致。

修正 基礎結構和升級 — 安全性、效能和穩定性的系統層級改善。

修正 套件組合產品選項現在只會顯示啟用的產品。

v1.29版本

2024年12月9日

新 產品查詢中的影像訂購—GraphQL images欄位中的產品影像現在會遵循目錄匯出sortOrder，以取得一致的店面和API行為。

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

v1.28版本

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

v1.27版本

2024年9月26日

修正 系統層級和基礎建設改善專案，以強化安全性、效能和穩定性。

v1.26版本

2024年10月22日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

新的 GraphQL結構描述現在在產品資訊中包含lastModifiedAt，以取得精確的Sitemap和搜尋引擎重新索引(例如Google)。

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或更新版本

New 已新增支援，以依據產品SKU擷取所有變體。 檢視目錄服務API參考。

v1.19版本

2024年5月23日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

修正 選項值的InStock旗標現在會遵守產品變體的領域enabled狀態。

修正 已新增對產品價格的支援，最多可包含16位數和4位小數。 從資料管理儀表板或CLI重新同步以套用更新。

已知限制

尚未支援下列功能：

  • 動態屬性承載的大小上限為9 MB。
  • 本集團產品價格可用簡單產品價格計算。
  • 在影像陣列中，只有第一個影像包含角色。

將API Mesh和核心GraphQL API用於：

  • 最低廣告價格
  • 層級定價
  • 捆綁固定價格的產品

如需詳細資訊和範例，請參閱目錄服務和API Mesh。

v1.18版本

2024年4月11日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

新 已新增對PHP 8.3的支援。

新的 products與refineProduct查詢現在會傳回簡單與複雜產品的可自訂選項資料。

v1.17版本

2024年2月22日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

新增 Data Management Dashboard現在可用於資料串流（產品推薦、即時搜尋、目錄服務）。 需要catalog-service個中繼封裝v3.1.0+。

v1.16版本

2024年2月13日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

目錄服務API現在支援 新 產品影片。
Fix 無存貨的選項現在顯示在PDP Widget中。

已知限制

尚未支援這些功能：

  • 動態屬性承載的大小上限為9 MB。
  • 群組產品價格。 此值可使用簡單產品價格計算。
  • 在影像陣列中，只有第一個影像包含角色。

將API Mesh和核心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或更新版本

新 目錄服務現在使用SaaS價格索引。
修正 此版本包含服務端的錯誤修正和改善。

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或更新版本

新 目錄服務API現在支援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 Mesh取得的功能。

v1.5版本

2023年3月6日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

新 已新增categories GraphQL功能。
修正 已改善效能和API擴充性。

v1.4版本

2023年2月7日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.x或更新版本

新增 已發佈的目錄服務中繼資料以簡化安裝步驟。
修正 API擴充性和效能改善。

v1.3版本

2023年1月17日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.x或更新版本

新 簡化並改善入門體驗。
新的 新客戶沙箱端點可用於生產前測試。
已新增虛擬產品的 新 支援。
修正 API擴充性和效能改善。

v1.1版本

2022年11月18日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.x或更新版本

新 目錄服務現在支援Adobe的API Mesh。
修正 已改善API擴充性和整體效能。

v1.0版本

2022年10月4日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.x或更新版本

套件和群組產品的 新 支援。
新 已新增B2B可見性覆寫。 產品現在可供搜尋，並可新增至特定客戶群組的購物車。
Fix 服務現在更穩定且效能更佳。

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客戶特定定價的產品型別。

目錄服務中繼資料

目錄服務PHP中繼套件(magento/catalog-service)的更新。

  • 針對Adobe Commerce as a Cloud Service客戶，您的環境中已安裝最新版本。

  • 針對雲端內部部署的Adobe Commerce，Adobe建議使用撰寫器，將雲端環境中的目錄服務中繼資料升級為最新版本。

v3.3.0版本

2025年10月14日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

新 資料服務升級—magento/data-services相依性已更新為^8.0.0。升級之前，請先驗證環境與自訂資料服務API的使用情況，以符合8.x版本。
ea
新 已更新3.3.0版的版本和中繼資料。

v3.2.0版本

2024年4月12日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

已針對3.2.0更新 新 版本和中繼資料。沒有其他相依性變更。

v3.1.0版本

2024年1月26日

[支援]{class="badge informative" title="支援"} Adobe Commerce 2.4.4或更新版本

新 已新增新的套件相依性：

  • 類別許可權資料匯出工具 (magento/module-category-permission-data-exporter)，用於匯出目錄服務使用的類別許可權資料。
  • 目錄同步管理員 magento/module-catalog-sync-admin，用於與目錄同步相關的管理員UI和設定。

新 已更新3.1.0版的版本和中繼資料。

相關檔案

recommendation-more-help
caa758b0-fff2-4350-a281-16253ff7b81f