Commerce Storefront Catalog Service 릴리스 정보
이러한 릴리스 노트는 다음을 포함한 최신 Commerce 카탈로그 서비스 업데이트를 다룹니다.
-
- 개선된 데이터 검색을 위한 카탈로그 서비스 API 스키마 개선 사항
- 카탈로그 서비스 API 및 기본 인프라의 보안, 성능 및 안정성 개선.
이러한 API에 대한 자세한 내용은 Commerce 개발자 설명서에서 Storefront Services 스키마를 참조하십시오.
-
- 종속성을 업데이트하여 성능, 안정성 및 다른 Adobe Commerce 구성 요소와의 호환성을 개선했습니다.
-
- 카탈로그 서비스와 Commerce 스택 간의 호환성을 유지하기 위해 종속성이 업데이트되었습니다.
업데이트는 유형별로 분류됩니다.
새 기능
최신 버전에 대한 지원이 제공됩니다. 이전 버전에 대한 릴리스 노트는 참조를 위해 포함됩니다.
Storefront 카탈로그 서비스
2026년 5월
릴리스 날짜: 2026년 5월 13일
CategoryView GraphQL 유형에 위치 필드가 포함되므로 상점 앞에는 카탈로그 계층 구조에서 판매자가 구성하는 순서로 범주를 표시할 수 있습니다.
릴리스 날짜: 2026년 5월 4일
NONE이(가) 표시되어 가격이 누락되었습니다. 이 업데이트는 상점 전반에서 일관되고 정확한 가격 렌더링을 보장합니다.
2026년 4월
릴리스 날짜: 2026년 4월 29일
Adobe Commerce Optimizer 및 Adobe Commerce as a Cloud Service에 대해 요청당 최대 100개의 SKU에 대한
문서화된 제한 및 경계에 따른 클라이언트.
릴리스 날짜: 2026년 4월 17일
searchCategory GraphQL 쿼리를 추가했습니다. 쿼리는 필수 searchTerm(최소 3자)과 선택적 family, pageSize 및 currentPage 매개 변수를 허용합니다. 결과에 전체 범주 메타데이터와 일치하는 CategoryTreeView 개체, 페이지 매김을 위한 totalCount 및 pageInfo이(가) 포함됩니다.
이 쿼리는 Adobe Commerce Optimizer 머천다이징 서비스를 사용하는 고객에게만 제공됩니다. searchCategory를 참조하십시오.
2026년 3월
릴리스 날짜: 2026년 3월 24일
2025년 12월
릴리스 날짜: 2025년 12월 11일
2025년 11월
릴리스 날짜: 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 인수를 생략하거나 빈 배열을 제공하십시오.릴리스 날짜: 2025년 11월 6일
2025년 9월
릴리스 날짜: 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은(는) 가격 범위를 만들 때 동일한 규칙을 사용합니다.
릴리스 날짜: 2025년 9월 2일
null을(를) 반환하여 클라이언트가 누락된 데이터를 정상적으로 처리할 수 있습니다.

2025년 7월
릴리스 날짜: 2025년 7월 30일
보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를
릴리스 날짜: 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 } } }
보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를
릴리스 날짜: 2025년 7월 15일
2025년 6월
릴리스 날짜: 2025년 6월 20일
릴리스 날짜: 2025년 6월 20일
보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를
릴리스 날짜: 2025년 6월 13일
Magento-Is-Preview 헤더를 사용하도록 설정합니다.
보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를
2025년 4월
릴리스 날짜: 2025년 4월 8일
보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를
2025년 3월
릴리스 날짜: 2025년 3월 28일
역할이 없는
2025년 2월
릴리스 날짜: 2025년 2월 18일
보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를
2024년 12월
릴리스 날짜: 2024년 12월 9일
주요 릴리스: 헤드리스 상점, 헤더 관리 및 제품 데이터 처리를 위한 구성 가능한 카탈로그 데이터 모델.
구성 가능한 카탈로그 API 작업을 위해
AC-Locale 이름이 AC-Scope-Locale(으)로 바뀌었습니다. 헤더 매핑 및 기본값이 지정되었습니다.
CurrencyEnum이(가) 페더레이션 논리에 맞춰 제품 검색 쿼리에 대해 NONE을(를) 지원하도록 업데이트되었습니다.
릴리스 날짜: 2024년 12월 9일
images 필드의 제품 이미지가 카탈로그 내보내기 sortOrder을(를) 따릅니다.
보안, 성능 및 안정성을 개선하기 위해 시스템 수준 및 인프라를
릴리스 날짜: 2024년 12월
2024년 10월
릴리스 날짜: 2024년 10월 22일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
lastModifiedAt이(가) 포함됩니다(예: Google).
2024년 9월
릴리스 날짜: 2024년 9월 26일
2024년 8월
릴리스 날짜: 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.
릴리스 날짜: 2024년 8월 13일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
2024년 5월
릴리스 날짜: 2024년 5월 23일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
InStock 플래그는 이제 제품 변형의 범위 enabled 상태를 따릅니다.
알려진 제한 사항
다음 기능은 아직 지원되지 않습니다.
- 동적 특성 페이로드의 최대 크기는 9MB입니다.
- 그룹 제품 가격은 간단한 제품 가격으로 계산할 수 있습니다.
- 이미지 배열에서는 첫 번째 이미지만 역할을 포함합니다.
API Mesh 및 핵심 GraphQL API를 사용하여 다음을 수행할 수 있습니다.
- 최소 광고 가격
- 계층 가격
- 고정 가격으로 묶음 제품
자세한 내용과 예제는 카탈로그 서비스 및 API Mesh를 참조하세요.
2024년 4월
릴리스 날짜: 2024년 4월 11일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
products 및 refineProduct 쿼리가 이제 단순 제품과 복합 제품 모두에 대해 사용자 지정 가능한 옵션 데이터를 반환합니다.
2024년 2월
릴리스 날짜: 2024년 2월 22일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
catalog-service개의 메타패키지 v3.1.0+가 필요합니다.
릴리스 날짜: 2024년 2월 13일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
알려진 제한 사항
다음 기능은 아직 지원되지 않습니다.
- 동적 특성 페이로드의 최대 크기는 9MB입니다.
- 그룹 제품 가격. 이 값은 간단한 제품 가격으로 계산할 수 있다.
- 이미지 배열에서는 첫 번째 이미지만 역할을 포함합니다.
API Mesh 및 핵심 GraphQL API를 사용하여 다음을 수행할 수 있습니다.
- 최소 광고 가격
- 계층 가격
2023년 10월
릴리스 날짜: 2023년 10월 12일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
inStock 플래그를 지원합니다.
urlKey 및 externalId 필드가 GraphQL 스키마에 추가되었습니다.
2023년 9월
릴리스 날짜: 2023년 9월 19일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
2023년 7월
릴리스 날짜: 2023년 7월 18일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
recommendations GraphQL 쿼리를 지원합니다.
2023년 6월
릴리스 날짜: 2023년 6월 27일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
related products을(를) 지원합니다.
2023년 4월
릴리스 날짜: 2023년 4월 12일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
2023년 3월
릴리스 날짜: 2023년 3월 28일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
products 쿼리에 견본을 추가했습니다.
entityId을(를) 가져오는 기능을 추가했습니다.
릴리스 날짜: 2023년 3월 6일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
categories GraphQL 기능이 추가되었습니다.
2023년 2월
릴리스 날짜: 2023년 2월 7일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상
2023년 1월
릴리스 날짜: 2023년 1월 17일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상
가상 제품에 대한
2022년 11월
릴리스 날짜: 2022년 11월 18일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상
2022년 10월
릴리스 날짜: 2022년 10월 4일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상
번들 및 그룹화된 제품에 대한
2022년 9월
릴리스 날짜: 2022년 9월 12일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.x 이상
카탈로그에서 제품이 삭제되면
2022년 8월
릴리스 날짜: 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에서는 Composer를 사용하여 클라우드 환경의 카탈로그 서비스 메타패키지를 최신 릴리스로 업그레이드하는 것이 좋습니다.
v3.3.0 릴리스
릴리스 날짜: 2025년 10월 14일
[지원됨]{class="badge informative" title="지원됨"} Adobe Commerce 버전 2.4.4 이상
magento/data-services 종속성이 ^8.0.0으로 업데이트되었습니다. 업그레이드하기 전에 8.x 호환성에 대한 환경 및 사용자 지정 데이터 서비스 API 사용을 확인하십시오.
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.
카탈로그 서비스 설치 관리자
설치 관리자는 카탈로그 서비스 확장과 함께 제공되며 카탈로그 서비스가 Commerce 스택과 일치하도록 설치 및 환경 검사를 처리합니다.
-
Adobe Commerce as a Cloud Service 고객의 경우 최신 설치 관리자 버전이 환경에 설치되어 있습니다.
-
클라우드 인프라의 Adobe Commerce 또는 온프레미스의 경우 설치 관리자를 카탈로그 서비스 메타패키지와(과) 정렬하세요.
Composer를 사용하여 magento/catalog-service을(를) 업그레이드할 때마다 설치 관리자 패키지가 최신 버전으로 자동 업데이트됩니다. 이 릴리스 정보에서 필요한 변경 사항(예: 새 PHP 버전 지원)을 설명할 때 작성기를 사용하여 magento/catalog-service-installer을(를) 별도로 업그레이드할 수도 있습니다. 이렇게 하면 실행 중인 카탈로그 서비스 버전과 설치 도구가 호환됩니다.
v1.0.6 릴리스
릴리스 날짜: 2026년 3월 25일
관련 설명서
-
**Adobe Commerce on cloud, 온프레미스 또는 Adobe Commerce as a Cloud Service에 배포된 프로젝트의 경우 다음 설명서를 참조하십시오.
-
Adobe Commerce Optimizer 또는 Adobe Commerce Optimizer 커넥터를 사용하는 프로젝트의 경우 다음 설명서를 참조하십시오.