새로운 기능, 버그 수정, 출시 업데이트에 관한 최신 공지사항을 확인하세요.
2026년 8월
2026년 8월
새로운 기능:
- Content API for Shopping은 2026년 8월 18일에 지원 종료되었습니다. 모든 개발자는 기존 통합을 최대한 빨리 Merchant API로 이전해야 합니다. 자세한 내용은 지원 중단 및 종료를 참고하세요.
- 범용 커머스 프로토콜 (UCP) 계정 통합: 계정 서비스 리소스에 서비스 유형으로
UcpCheckoutManagement를 추가하고ucp-integration프로그램 및ucp_integration서비스 약관을 제한된 액세스로 지원합니다. - 제품 수준 반품 정책 재정의:
ProductAttributes내에returns속성을 추가하여 상품 수준에서 직접 반품 정책 (예: 국가, 기간 일수, 반품 수수료, 상태)을 구성하고 재정의할 수 있습니다. - 부동산 임대 속성: 임대 광고 데이터를 제출하기 위해
leaseTerm에서ProductAttributes까지의 기본 등록정보 속성이 추가되었습니다. - Inventories 하위 API 개선사항:
- 매장별 배송 규칙을 구성하기 위해
LocalInventoryAttributes에localShippingLabel를 추가했습니다. - 오프라인 판매점 인벤토리의 커스텀 메타데이터를 지원하기 위해
LocalInventoryAttributes에customAttributes를 추가했습니다.
- 매장별 배송 규칙을 구성하기 위해
- 계정 서비스 알림: 계정 서비스의 상태 변경사항을 추적하기 위해 알림 하위 API에 지원되는
NotificationEventType로ACCOUNT_SERVICE를 추가했습니다. 계정 서비스 변경 알림에 관한 자세한 내용은 계정 서비스 변경에 대한 푸시 알림 받기를 참고하세요. - 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의 새로운 에이전트 도구로 사용할 수 있습니다. 이 서비스는 읽기 전용에 중점을 둡니다.
이제 Products 하위 API의
ProductAttributes에서 새로운 대화형 속성을 사용할 수 있습니다.이러한 속성은 다음과 같습니다.
Products 하위 API에 차량 광고 전용 속성 전체가 추가되었습니다.
이제 Notifications 하위 API에서 보고 컨텍스트 값
FREE_LISTINGS_UCP_CHECKOUT를 통해 범용 커머스 프로토콜 (UCP) 결제의 제품 상태 변경에 관한 알림을 사용할 수 있습니다.Merchant API 에이전트 기술은 Code Assist 툴킷의 새로운 에이전트 도구입니다. 개방형 에이전트 스킬 표준을 기반으로 빌드된 새로운
mapi-developer-assistant스킬은 지능적이고 상황에 맞는 지원을 제공합니다. Antigravity CLI 및 IDE와 같은 AI 도구 내에서 도메인별 전문 지식, 자동화된 워크플로, 향상된 효율성을 제공하여 통합을 가속화합니다.YouTube 제휴 프로그램 계약을 관리하는 데 사용할 수 있는 새로운 YouTube 하위 API v1alpha 버전이 제공됩니다.
Accounts 하위 API에 YouTube Shopping 제휴 및 제품 리뷰 프로그램을 관리하는 지원 기능이 추가되었습니다.
고급 계정 수준에서 제품 프로모션에 사용할 수 있는 새 데이터 소스가 제공됩니다.
변경사항
- Merchant API v1beta 버전이 지원 중단되었습니다. 이제 모든 API 호출을
v1또는v1alpha버전으로 전달해야 합니다. 마이그레이션 단계는 v1beta에서 v1로 마이그레이션을 참조하세요. - 이제 Products 하위 API의
patch메서드를 통해price및availability에 대한 속성 수준 업데이트를 더 자주 수행할 수 있습니다. 이 기능을 사용하면 지연 시간을 줄여 특정 속성을 업데이트할 수 있으므로 데이터 기록 빈도가 높아집니다. 현재 이 기능은 허용 목록에 추가된 판매자만 사용할 수 있습니다. 자세한 내용을 알아보거나 액세스 권한을 요청하려면 Google 담당자에게 문의하세요.
출시 예정 기능:
- Reports API의 UCP를 사용한 에이전트 실적 분석
2026년 1월
2026년 1월
새로운 기능:
Reports 하위 API에서 범용 커머스 프로토콜 (UCP) 결제의 제품 자격 요건 상태를 파악하기 위한 새로운 보고 컨텍스트 값
FREE_LISTINGS_UCP_CHECKOUTReports 하위 API의 v1alpha에 YouTube Shopping 제휴 실적 보고가 도입되었습니다.
잘못된 API 호출에 대해 기계가 읽을 수 있는 메타데이터를 제공하기 위해
ErrorInfo메시지에 대한 지원이 추가되었습니다. 이와 함께 오류 처리에 관한 새로운 가이드와 오류 메시지의 전체 목록이 제공됩니다.
변경사항
- 사용자가 할인, 향후 구매 시 캐시백, 적립 포인트와 같은 포인트 기능을 통합 관리할 수 있도록 오프라인 판매점 인벤토리 서비스에
InventoryLoyaltyProgram를 추가했습니다.
출시 예정 기능:
- 2026년 2월 28일에 Merchant API v1beta가 지원 중단됩니다. v1beta 지원 종료 기한 전에 모든 API 호출을 각각 v1 및 v1alpha 버전으로 전달합니다.
- Reviews API v1alpha를 통해 제품 리뷰 프로그램을 사용 설정 및 중지할 수 있습니다. 이 API는 제품 리뷰 제출 및 관리 프로세스를 간소화합니다.
2025년 11월
2025년 11월
새로운 기능:
- YouTube에 표시된 크리에이터, 콘텐츠, 제품에 대한 분석을 검색하는 Reports 하위 API의 YouTube Shopping 제휴 분석(v1alpha)에 대한 새로운 통계입니다. Google 판매자 센터 (GMC)에서 제공되는 기존 보고서와 동일한 기능을 제공합니다.
- Merchant API(v1)로의 이전을 지원하는 업그레이드된 API 진단 도구
- 판매자가 제품 속성에 대한 일부 조건부 필터를 기반으로 피드의 하위 집합만 Google Ads 계정과 공유할 수 있도록 Accounts 하위 API에 새 필드
product_filters를 추가했습니다. 이 기능은 일부 판매자만 사용할 수 있습니다. - 전자상거래 플랫폼의 판매자를 위한 독립형 계정 생성 지원이 추가되었습니다.
- Quota 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에 등록된 판매자 계정을 가져오는 Accounts 하위 API의 새로운 메서드인
getAccountForGcpRegistration입니다.
변경사항
- Accounts 하위 API의 지역 관리를 위한 새로운 메서드
- Accounts 하위 API의 리전에 대한
create,update,delete작업의 호출 일괄 처리를 사용 설정하여 리전 관리를 용이하게 하고one-region-per-request호출의 제한사항을 완화하는 세 가지 새로운 메서드(batchCreate,batchDelete,batchUpdate)가 도입되었습니다.
- Accounts 하위 API의 리전에 대한
- Products 하위 API에서 새로운 운송업체 기반 배송 구성을 사용하여 제품 수준에서 배송 속성을 지정할 수 있습니다.
출시 예정 기능:
- YouTube Shopping 제휴 프로그램 분석을 위한 새로운 보고서(예: Reports 하위 API의 v1alpha)를 통해 YouTube에 표시된 크리에이터, 콘텐츠, 제품에 대한 분석을 가져올 수 있으며, 이는 Google 판매자 센터에서 제공되는 보고서와 동일한 기능을 제공합니다.
- 재고 및 가격 속성에 대한 제품 업데이트를 더 자주 사용 설정합니다.
- 풍부한 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의 판매자 페이지에서 결제는 결제 설정을 만들고, 업데이트하고, 삭제하고, 가져오는 기능을 제공합니다.
- Accounts 하위 API의 온라인 반품 정책이 이전되었으며 사용자 기능은 변경되지 않았습니다. 일관성을 위해 오래된 필드, 기존 필드 이름 바꾸기와 같은 사소한 기술적 개선사항이 삭제되었습니다.
- Accounts 하위 API의 AccountRelationship 리소스에 있는
AccountIdAlias는 내부 ID (계정 ID) 대신 사용자 정의 별칭을 사용합니다. 이렇게 하면 내부 ID 대신 마켓플레이스에 사용자 정의 별칭을 사용하는 등 복잡한 계정 구조를 더 쉽게 관리할 수 있습니다.
이제 Apps Script 사용자가 Merchant API에 액세스할 수 있습니다.
이제 문제 해결 API에서 새로운
AggregateProductStatuses메서드를 사용하여 제품 상태에 관한 통합 통계를 쿼리할 수 있습니다.
변경사항
- 온라인 상점 제작 도구 및 CSS의 단독 계정을 만들 수 있습니다. 이전에는 판매자 계정이 단일 고급 계정에서 생성되었습니다.
Reports 하위 API의
productView테이블에서 클릭 가능성 순위를 클릭합니다. 이제clickPotential를 기준으로 한 제품 순위가 1에서 1, 000 사이의 값으로 정규화됩니다.clickPotentialRank가 낮은 제품은 검색어 조건을 충족하는 판매자 제품 중에서 여전히click potential가 가장 높습니다.
출시 예정 기능:
- 모델 컨텍스트 프로토콜 (MCP) 서버 (v1alpha)를 통한 액세스
2025년 5월
2025년 5월
새로운 기능:
- 새로운 하위 API 2개가 출시되었습니다.
- Accounts 하위 API에서 새 리소스를 사용할 수 있습니다.
OmnichannelSettings는 무료 오프라인 등록정보 (FLL) 및 오프라인 판매점 인벤토리 광고 (LIA)와 같은 옴니채널 게재의 계정 구성을 관리합니다.LfpProviders는 인벤토리 데이터를 위해 오프라인 제품 피드 파트너십 (LFP) 파트너에 연결합니다.GbpAccounts오프라인 매장 데이터를 위해 Google 비즈니스 프로필 계정에 연결합니다.OnlineReturnPolicy는 온라인 정책을 생성, 삭제, 업데이트할 수 있는 기능을 제공합니다.
- Products 하위 API에서 새로운 메서드를 사용할 수 있습니다.
ProductsUpdate를 사용하면ProductInput에 필요한 모든 필드를 제공하지 않고도 개별 제품을 업데이트할 수 있습니다.
변경사항
- 최대
pageSize가 API 호출당 250개에서 1,000개 행으로 늘어났습니다. DataSources생성 후 제품 삽입, 프로모션, 제품 리뷰, 판매자 리뷰에 존재하던 지연이 수정되었습니다.
출시 예정 기능:
DataSources및 제품의 채널 필드가 지원 중단되고 향후 삭제됩니다.- Reports 하위 API의
productView테이블에서clickPotentialRank의 업데이트된 정의가 출시되었습니다.clickPotential를 기준으로 한 제품 순위는 1에서 1,000 사이의 값으로 정규화됩니다.clickPotentialRank가 낮은 제품은 검색어 조건을 충족하는 판매자의 제품 중에서 클릭 가능성이 가장 높습니다. 이는 2025년 7월 1일에 출시될 수 있는 브레이킹 체인지가 아닌 변경사항입니다.
AccountRelationship리소스의AccountIdAlias를 사용하면 복잡한 계정 구조를 더 효과적으로 관리할 수 있습니다. 예를 들어 마켓플레이스에서는 계정 ID와 같은 판매자의 내부 ID 대신 사용자 정의 별칭을 사용합니다.
2025년 4월
2025년 4월
새로운 기능:
- 새로운 하위 API를 출시했습니다.
- Product Studio (알파)는 생성형 AI를 활용하여 제품명과 설명을 생성하고 최적화합니다.
- Accounts 하위 API에서 새 리소스를 사용할 수 있습니다.
AutomaticImprovements는 Google 판매자 센터 플랫폼에서 제공하는 세 가지 자동 업데이트 기능의 선택을 관리합니다.AccountService및AccountRelationship리소스는 관계를 관리하고 서비스 제공업체에 서비스를 설정합니다.
- Google 자동 할인 (GAD)에 선택된 제품의 실시간 가격을 가져오기 위해 Products 하위 API의
AutomatedDiscounts에 세 가지 필드가 출시되었습니다.
변경사항
- 이제 Data Sources 하위 API의 판매자 센터에서 마케팅 방법이라고 하는 대상 유형이 지원됩니다.
- 리소스에 여러 조정이 적용되었으며 자세한 내용은 계정 출시 노트를 검토하는 것이 좋습니다.
- Products 하위 API의
taxes및tax_category필드는 Content API의accounttax지원 중단에 따라 지원 중단됩니다.
출시 예정 기능:
- Google은 여러분의 의견을 고려하여 API 개발자 문서를 개선하기 위해 여러 영역에서 노력하고 있습니다.
- 계속해서 자주 확인하고 의견을 보내주세요.