새로운 기능, 버그 수정, 출시 업데이트에 관한 최신 공지사항을 확인하세요.
2026년 8월
2026년 8월
새로운 기능:
- Content API for Shopping은 2026년 8월 18일에 지원이 종료되었습니다. 모든 개발자는 기존 통합을 최대한 빨리 Merchant API로 이전해야 합니다. 자세한 내용은 지원 중단 및 서비스 종료를 참고하세요.
- 범용 커머스 프로토콜 (UCP) 계정 통합:
ucp-integration프로그램 및 제한된 액세스 권한이 있는ucp_integration서비스 약관과 함께 계정 서비스 리소스에UcpCheckoutManagement이 서비스 유형으로 추가되었습니다. - 제품 수준 반품 정책 재정의:
ProductAttributes내에returns속성을 추가하여 제품 수준에서 직접 반품 정책 (예: 국가, 기간 일수, 반품 수수료, 상태)을 구성하고 재정의합니다. - 부동산 임대 속성: 임대 광고 데이터를 제출하기 위해
ProductAttributes에leaseTerm를 비롯한 기본 등록정보 속성이 추가되었습니다. - 인벤토리 하위 API 개선사항:
LocalInventoryAttributes에localShippingLabel을 추가하여 스토어별 배송 규칙을 구성했습니다.- 오프라인 판매점 인벤토리의 맞춤 메타데이터를 지원하기 위해
LocalInventoryAttributes에customAttributes를 추가했습니다.
- 계정 서비스 알림: 계정 서비스의 상태 변경을 추적하기 위해 알림 하위 API에
ACCOUNT_SERVICE가 지원되는NotificationEventType로 추가되었습니다. 계정 서비스 변경사항 알림에 대한 자세한 내용은 계정 서비스 변경사항 푸시 알림 받기를 참고하세요. - YouTube Shopping 제휴사 보고 조회수 (
v1alpha):youtube_product_sold_stats_view: YouTube에서 제휴 제품의 판매 실적을 쿼리합니다.youtube_product_tagged_stats_view를 사용하여 동영상에서 태그된 제품의 노출수, 클릭수, 주문수를 추적합니다.
- 충성도 고객 매치 타겟팅 엔드포인트: 고객 충성도 데이터를 업로드하고 관리하여 자연 검색 결과에 등급 혜택 (예: 회원가)을 표시합니다. 고객 충성도 데이터에 대한 자세한 내용은 충성도 고객 일치 타겟팅 서비스 개요를 참고하세요.
- 알파 클라이언트 라이브러리 공개 저장소: Python, Java, PHP, C#, Ruby, Node.js, Go 전반의 리뷰 하위 API용 알파 라이브러리가 이제 공개 GitHub 저장소에서 제공됩니다.
변경사항
ListAccounts액세스 수준 필터: 호출자 권한을 기반으로 계정을 필터링하기 위해DIRECT,INDIRECT,ALL를 지원하는access매개변수를 도입했습니다. 고급 계정과 하위 계정을 구분하는 데 사용할 수 있습니다.DataSources할당량 및 규칙 유효성 검사:- 고급 계정의 데이터 소스에 자동 할당량 관리가 도입되었습니다. 자세한 내용은 할당량 및 한도 이해하기를 참고하세요.
- 기본 제품 데이터 소스의 기본 규칙에
self또는 기본 데이터 소스에 대한 참조가 정확히 하나 포함되도록 하는 규칙 검증이 추가되었습니다. DataSourceReference에서primaryDataSourceName이(가) 지원 중단되고self로 대체되었습니다.
- 지연 시간 개선: 제품 삽입, 업데이트, 삭제 호출의 API 오버헤드가 감소했습니다.
출시 예정:
- Content API for Shopping 지원 중단 및 종료: 새로운 Merchant API로 전환하라는 알림 완전한 서비스 해지 전에 마이그레이션을 장려하고 개발자가 애플리케이션 로그에서 지원 중단 알림을 확인할 수 있도록 Google에서는 2026년 9월 1일부터 점진적인 서비스 저하 프로세스를 도입합니다. 자세한 내용은 Content API for Shopping의 지원 종료 일정 섹션을 참고하세요.
2026년 5월
2026년 5월
새로운 기능:
- 판매자 센터 데이터 및 통계에 대한 승인된 액세스 권한이 있으며 읽기 전용에 중점을 둔 새로운 Merchant API MCP 서비스(알파 버전)가 이제 Merchant API의 새로운 에이전트 도구로 제공됩니다.
이제 제품 하위 API의
ProductAttributes에서 새 대화형 속성을 사용할 수 있습니다.이러한 속성은 다음과 같습니다.
제품 하위 API에 차량 광고 전용 속성 전체가 추가되었습니다.
이제 범용 커머스 프로토콜 (UCP) 결제의 제품 상태 변경에 관한 알림을 보고 컨텍스트 값
FREE_LISTINGS_UCP_CHECKOUT를 통해 알림 하위 API에서 확인할 수 있습니다.Merchant API Agent Skills는 Code Assist 툴킷 내의 새로운 에이전트 도구입니다. 개방형 에이전트 스킬 표준을 기반으로 구축된 새로운
mapi-developer-assistant스킬은 지능적이고 맥락에 맞는 지원을 제공합니다. 도메인별 전문 지식, 자동화된 워크플로, Antigravity CLI 및 IDE와 같은 AI 도구 내의 향상된 효율성을 제공하여 통합을 가속화합니다.YouTube 제휴 프로그램 계약을 관리할 수 있는 새로운 YouTube sub-API v1alpha 버전이 제공됩니다.
Accounts 하위 API에서 YouTube Shopping 제휴 및 제품 리뷰 프로그램을 관리하는 지원이 추가되었습니다.
고급 계정 수준에서 제품 프로모션에 사용할 수 있는 새 데이터 소스가 있습니다.
변경사항
- Merchant API v1beta 버전이 지원 중단되었습니다. 이제 모든 API 호출은
v1또는v1alpha버전으로 전달되어야 합니다. 마이그레이션 단계는 v1beta에서 v1로 마이그레이션을 참고하세요. - 이제 제품 하위 API의
patch메서드를 통해price및availability속성을 더 자주 업데이트할 수 있습니다. 이 기능을 사용하면 지연 시간이 짧은 특정 속성을 업데이트하여 데이터 업데이트 빈도를 높일 수 있습니다. 현재 이 기능은 허용 목록에 추가된 판매자만 사용할 수 있습니다. 자세한 내용을 알아보거나 액세스 권한을 요청하려면 Google 담당자에게 문의하세요.
출시 예정:
- Reports API에서 UCP를 사용한 에이전트 성능 분석
2026년 1월
2026년 1월
새로운 기능:
UCP (범용 커머스 프로토콜) 결제의 제품 자격 요건 상태를 파악하기 위한
FREE_LISTINGS_UCP_CHECKOUT라는 새 보고 컨텍스트 값이 Reports 하위 API에 추가되었습니다.보고서 하위 API 내 v1alpha에 YouTube Shopping 제휴사 실적 보고가 도입되었습니다.
잘못된 API 호출에 대한 머신이 읽을 수 있는 메타데이터를 제공하기 위해
ErrorInfo메시지 지원이 추가되었습니다. 이와 함께 오류 처리 관련 새로운 가이드와 전체 오류 메시지 목록이 제공됩니다.
변경사항
- 사용자가 할인, 향후 구매 시 캐시백, 포인트와 같은 포인트 기능을 통합적으로 관리할 수 있도록 오프라인 인벤토리 서비스에
InventoryLoyaltyProgram를 추가했습니다.
출시 예정:
- 2026년 2월 28일 Merchant API v1beta 지원 중단 v1beta 지원 종료 기한 전에 모든 API 호출을 각각 v1 및 v1alpha 버전으로 전달합니다.
- Reviews API v1alpha를 통해 제품 리뷰 프로그램을 사용 설정 및 중지할 수 있어 제품 리뷰 제출 및 관리 프로세스가 간소화됩니다.
2025년 11월
2025년 11월
새로운 기능:
- YouTube에 표시되는 크리에이터, 콘텐츠, 제품에 관한 분석을 가져오는 Reports 하위 API의 YouTube Shopping 제휴 분석(v1alpha)에 대한 새로운 통계입니다. Google 판매자 센터 (GMC)에서 제공되는 기존 보고서와 동일한 정보를 제공합니다.
- Merchant API(v1)로의 이전을 지원하는 업그레이드된 API 진단 도구
- 판매자가 판매자 제품의 속성에 대한 일부 조건부 필터를 기반으로 피드의 일부만 Google Ads 계정과 공유할 수 있도록 계정 하위 API에 새 필드
product_filters를 추가했습니다. 이 기능은 일부 판매자만 사용할 수 있습니다. - 전자상거래 플랫폼의 판매자를 위한 독립형 계정 생성 지원이 추가되었습니다.
- 할당량 API에서 계정 한도를 쿼리하는 두 가지 새로운 메서드
accounts.limits.get및accounts.limits.list이 추가되었습니다.
변경사항
- 이제 제품 ID를 사용하는 모든 메서드에서 base64url로 인코딩된 제품 ID의 자동 감지 및 내부 디코딩이 지원됩니다.
출시 예정:
YouTube에 표시되는 크리에이터, 콘텐츠, 제품에 관한 분석을 가져오는 Reports 하위 API의 YouTube Shopping 제휴 분석(v1alpha)에 대한 새로운 통계입니다. Google 판매자 센터 (GMC)에서 제공되는 기존 보고서와 동일한 정보를 제공합니다.
2026년 2월 28일 Merchant API의 v1beta 버전 지원 중단 v1beta 지원 종료 기한 전에 모든 API 호출이 각각 v1 및 v1alpha 버전으로 전달되어야 합니다. 자세한 내용은 Merchant API 버전 관리 및 지원 종료 정책을 참고하세요.
2025년 9월
2025년 9월
새로운 기능:
- Merchant API용 첫 번째 모델 컨텍스트 프로토콜 (MCP) 서비스가 제공됩니다.
- 새 MCP 서비스는 공신력 있는 Google API 참고 리소스를 통합 개발 환경 (IDE) 코딩 어시스턴트에 통합하여 Merchant API 통합을 가속화하고 이전 워크플로의 정확성을 개선합니다.
- Google Cloud에 등록된 판매자 계정을 가져오는 계정 하위 API의 새 메서드
getAccountForGcpRegistration
변경사항
- Accounts 하위 API의 지역 관리를 위한 새로운 메서드
- 계정 하위 API의 리전에서
create,update,delete작업의 호출 일괄 처리를 지원하여 리전 관리를 용이하게 하고one-region-per-request호출의 제한사항을 완화하는 세 가지 새 메서드batchCreate,batchDelete,batchUpdate도입
- 계정 하위 API의 리전에서
- 제품 수준에서 배송 속성을 지정할 수 있는 새로운 운송업체 기반 배송 구성이 제품 하위 API에서 제공됩니다.
출시 예정:
- Google 판매자 센터에서 제공되는 보고서와 동등한 YouTube에 표시된 크리에이터, 콘텐츠, 제품에 관한 분석을 가져오는 Reports 하위 API의 v1alpha와 같은 YouTube Shopping 제휴 프로그램 분석을 위한 새로운 보고서
- 재고 및 가격 속성에 대한 제품 업데이트 빈도를 높입니다.
- 강화된 ErrorInfo 및 메타데이터를 사용하여 API 오류를 더 쉽게 분석할 수 있습니다.
2025년 7월
2025년 7월
새로운 기능:
Merchant API (v1) - Content API for Shopping의 공식 후속 API가 정식 버전으로 출시되었습니다.
즉, 앞으로는 Merchant API 내에 v1alpha 및 v1 하위 API만 있으며 대부분의 v1beta 버전이 v1로 업그레이드됩니다. 자세한 내용은 추후 공지드리겠습니다.
새 리소스를 사용할 수 있습니다.
- Product Studio API (알파)의 이미지 리소스는 생성형 AI를 활용하여 새로운 제품 배경을 생성하고, 이미지 배경을 삭제하고, 이미지 해상도를 업스케일합니다.
- Accounts 하위 API의 Checkout on Merchant는 결제 설정을 생성, 업데이트, 삭제, 가져오는 기능을 제공합니다.
- 계정 하위 API의 온라인 반품 정책이 이전되었으며 사용자 기능은 변경되지 않았습니다. 일관성을 위해 오래된 필드, 기존 필드 이름 변경 등 작은 기술 개선사항이 삭제되었습니다.
- AccountRelationship 리소스의
AccountIdAlias(계정 하위 API)는 내부 ID(계정 ID) 대신 사용자 정의 별칭을 사용합니다. 이렇게 하면 내부 ID 대신 마켓의 사용자 정의 별칭을 사용하는 등 복잡한 계정 구조를 더 쉽게 관리할 수 있습니다.
이제 Apps Script 사용자가 Merchant API에 액세스할 수 있습니다.
이제 문제 해결 API에서 제품 상태에 관한 통합 통계를 쿼리하는 새로운
AggregateProductStatuses메서드를 사용할 수 있습니다.
변경사항
- 스토어 빌더 및 CSS의 독립형 계정을 만들 수 있습니다. 이전에는 판매자 계정이 단일 고급 계정으로 생성되었습니다.
보고서 하위 API 아래의
productView표에서 클릭 가능성 순위를 클릭합니다. 이제clickPotential에 기반한 제품 순위가 1~1, 000 사이의 값으로 정규화됩니다.clickPotentialRank가 낮은 제품은 검색어 조건을 충족하는 판매자의 제품 중click potential이 가장 높습니다.
출시 예정:
- 모델 컨텍스트 프로토콜 (MCP) 서버를 통한 액세스 (v1alpha)
2025년 5월
2025년 5월
새로운 기능:
- 두 개의 새로운 하위 API가 출시되었습니다.
- 계정 하위 API에서 새 리소스를 사용할 수 있습니다.
OmnichannelSettings는 무료 오프라인 등록정보 (FLL) 및 오프라인 판매점 인벤토리 광고 (LIA)와 같은 옴니채널 게재의 계정 구성을 관리합니다.LfpProviders는 인벤토리 데이터를 위해 오프라인 제품 피드 파트너십 (LFP) 파트너에 연결됩니다.GbpAccounts오프라인 매장 데이터의 Google 비즈니스 프로필 계정에 연결됩니다.OnlineReturnPolicy를 사용하면 온라인 정책을 생성, 삭제, 업데이트할 수 있습니다.
- 제품 하위 API에서 새로운 메서드를 사용할 수 있습니다.
ProductsUpdate를 사용하면ProductInput에 필요한 모든 필드를 제공하지 않고도 개별 제품을 업데이트할 수 있습니다.
변경사항
- 최대
pageSize이 API 호출당 250개 행에서 1,000개 행으로 증가했습니다. DataSources생성 후 제품 삽입, 프로모션, 제품 리뷰, 판매자 리뷰에 발생했던 지연이 수정되었습니다.
출시 예정:
DataSources및 제품의 채널 필드 지원 중단 및 향후 삭제- 보고서 하위 API의
productView표에서clickPotentialRank의 업데이트된 정의가 출시됩니다.clickPotential에 기반한 제품 순위는 1~1000 사이의 값으로 정규화됩니다.clickPotentialRank이 낮은 제품은 검색어 조건을 충족하는 판매자의 제품 중에서 클릭 가능성이 가장 높습니다. 이는 2025년 7월 1일에 출시될 수 있는 비호환성 변경사항입니다.
AccountRelationship리소스의AccountIdAlias를 사용하면 복잡한 계정 구조를 더 잘 관리할 수 있습니다. 예를 들어 마켓에서는 계정 ID와 같은 판매자의 내부 ID 대신 사용자 정의 별칭을 사용합니다.
2025년 4월
2025년 4월
새로운 기능:
- 새로운 하위 API가 출시되었습니다.
- Product Studio (알파)는 생성형 AI를 활용하여 제품명과 설명을 생성하고 최적화합니다.
- Accounts 하위 API에서 새 리소스를 사용할 수 있습니다.
AutomaticImprovementsGoogle 판매자 센터 플랫폼에서 제공하는 세 가지 자동 업데이트 기능의 선택을 관리합니다.AccountService및AccountRelationship리소스는 관계를 관리하고 서비스 제공업체에 서비스를 설정합니다.
- Google 자동 할인 (GAD)을 선택한 제품의 실시간 가격을 가져오기 위해 제품 하위 API에
AutomatedDiscounts필드 3개를 출시했습니다.
변경사항
- 이제 데이터 소스 하위 API의 경우 판매자 센터에서 마케팅 방법이라고 하는 대상 유형이 지원됩니다.
- 리소스가 여러 번 조정되었으므로 자세한 내용은 계정 출시 노트를 참고하세요.
- 콘텐츠 API에서
accounttax가 지원 중단됨에 따라 제품 하위 API의taxes및tax_category필드가 지원 중단됩니다.
출시 예정:
- Google에서는 의견을 고려하여 API 개발자 문서를 개선하기 위해 여러 분야에서 노력하고 있습니다.
- 앞으로도 자주 확인해 주시고 의견을 더 보내 주세요.