구글 머천트센터 Content API 종료 Merchant API 전환 설정｜상품·가격·재고 동기화 오류 해결
구글 쇼핑과 구글 머천트센터를 쇼핑몰에 연결해 상품명이나 가격, 재고를 자동으로 업데이트해왔다면 이제는 Content API for Shopping 사용 여부를 반드시 확인해야 합니다.
Google은 기존 Content API for Shopping을 2026년 8월 18일 종료하고 프로그램 방식의 상품 관리는 Merchant API를 중심으로 전환했습니다.
여기서 중요한 점은 API 주소에서 버전 숫자만 바꾸면 끝나는 업데이트가 아니라는 것입니다. 상품·재고·데이터 소스 구조, 인증, 리소스 이름과 일부 대량 요청 방식까지 달라졌기 때문에 자체 개발 쇼핑몰이나 오래된 연동 플러그인을 사용한다면 상품 동기화가 멈추지 않았는지 확인해야 합니다.
구글 머천트센터 API 관리와 Content API → Merchant API 전환 구조 예시
이미지 날짜 참고
본문의 머천트센터 화면은 설정 위치와 구조를 쉽게 이해하기 위한 UI 재현 화면입니다. 일부 예시 화면에 표시된 과거 날짜는 실제 종료일과 관계가 없으며 Google 공식 Content API 종료일은 2026년 8월 18일입니다.
Content API 종료 핵심만 먼저
기존 API : Content API for Shopping
현재 권장 : Merchant API
기존 주소 : shoppingcontent.googleapis.com
신규 주소 : merchantapi.googleapis.com
자체 개발 쇼핑몰 : 코드 전환 확인 필요
Shopify 공식 연동 : 대부분 플랫폼 공급자 측 대응
WooCommerce : 사용하는 구글 연동 플러그인 최신화 확인
CSV·Google Sheets : API 방식이 아니라면 직접 코드 전환이 필요하지 않을 수 있음
구글 Content API 종료, 무엇이 바뀌었나?
Content API for Shopping은 쇼핑몰의 상품 데이터를 Google Merchant Center에 자동으로 전달할 때 사용해왔던 API입니다.
예를 들어 자체 쇼핑몰에서 가격이 59,000원에서 49,000원으로 바뀌었거나 재고가 10개에서 0개가 됐을 때 쇼핑몰 프로그램이 API를 이용해 머천트센터에 새로운 데이터를 전달하는 방식입니다.
이 역할을 앞으로는 Merchant API가 담당합니다.
| 구분 | Content API | Merchant API |
|---|---|---|
| 상태 | 종료 | 현재 사용 |
| API 호스트 | shoppingcontent.googleapis.com | merchantapi.googleapis.com |
| 리소스 | 숫자 ID 중심 | Resource Name 중심 |
| 상품 관리 | Products | Products / ProductInput |
| 재고 | Inventory | Inventories API |
| 대량 처리 | customBatch | 개별 병렬 요청 / HTTP Batch |
구글 머천트센터 데이터 소스부터 확인
API 전환을 시작하기 전에 가장 먼저 해야 할 것은 내 상품이 어떤 방식으로 Google에 전달되고 있는지 확인하는 것입니다.
API라는 단어가 익숙하지 않다고 무조건 개발자를 부를 필요는 없습니다. 쇼핑몰에 따라 CSV 파일이나 Google Sheets, Shopify 앱 같은 방식으로 연결된 경우도 있기 때문입니다.
구글 머천트센터 데이터 소스에서 상품 연결 방식을 먼저 확인합니다.
머천트센터 데이터 소스 확인 위치
Google Merchant Center → 설정 또는 데이터 → 데이터 소스
계정 버전이나 화면 구성에 따라 메뉴 위치는 조금 다르게 표시될 수 있지만 핵심은 상품을 공급하는 Data Source를 확인하는 것입니다.
연결방식이 다음 중 무엇인지 확인합니다.
- Merchant API
- 기존 Content API
- Google Sheets
- CSV 또는 XML 파일
- 예약된 URL 가져오기
- Shopify 앱
- WooCommerce 연동 플러그인
Content API가 표시된다면 현재 사용하는 쇼핑몰 프로그램이나 플러그인부터 확인해야 합니다.
Content API와 Merchant API 차이
기존 Content API와 Merchant API는 URL뿐 아니라 리소스와 요청 구조도 달라집니다.
개발자 입장에서 가장 먼저 체감하는 변화는 API 주소입니다.
기존 Content API 주소
https://shoppingcontent.googleapis.com/content/v2.1/...Merchant API 주소
https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}Merchant API는 Accounts, Products, Inventories, Reports 등 기능을 여러 개의 하위 API로 분리합니다.
따라서 기존 주소에서 v2.1만 v1로 변경하는 방식으로는 정상 이전되지 않습니다.
Resource Name 구조 확인
Merchant API에서는 리소스를 문자열 형태의 이름으로 관리하는 경우가 많습니다.
accounts/123456/products/online~ko~KR~product001기존 프로그램에서 merchantId나 productId 숫자를 단순히 전달했다면 이 부분도 새 구조에 맞게 수정해야 합니다.
Merchant API 인증 설정방법
Merchant API는 OAuth 2.0 또는 서비스 계정을 이용해 인증합니다.
Merchant API 요청에는 인증이 필요합니다. 어떤 방식을 선택할지는 프로그램의 목적에 따라 달라집니다.
| 사용환경 | 추천 인증 |
|---|---|
| 내 회사 Merchant Center만 관리 | 서비스 계정 |
| 쇼핑몰 솔루션·SaaS | OAuth 2.0 |
| 여러 고객 Merchant Center 관리 | OAuth 2.0 |
| 서버에서 재고 자동 업데이트 | 서비스 계정 활용 가능 |
서비스 계정 인증 설정 순서
- Google Cloud Console에 접속합니다.
- API 및 서비스 → 라이브러리로 이동합니다.
- Merchant API를 검색해 활성화합니다.
- API 및 서비스 → 사용자 인증 정보로 이동합니다.
- 서비스 계정을 생성합니다.
- 필요하면 JSON 개인키를 생성해 안전한 서버에 저장합니다.
- 서비스 계정 이메일을 복사합니다.
- Merchant Center에서 해당 이메일을 사용자로 추가합니다.
- 필요한 권한을 부여합니다.
주의
서비스 계정 JSON 키는 웹사이트 공개 폴더나 GitHub 공개 저장소에 올리면 안 됩니다. API 키 방식만으로 Merchant API 인증을 처리할 수도 없습니다.
상품·가격·재고 동기화 상태 확인
API 전환 후에는 전체 상품 수보다 가격·재고 오류와 마지막 동기화 시간을 확인하는 것이 중요합니다.
Merchant API 전환이 끝났다고 바로 작업을 종료하지 않는 것이 좋습니다.
실제로 중요한 것은 API 호출 성공 메시지가 아니라 쇼핑몰 상품값과 Merchant Center의 최종 데이터가 일치하는지입니다.
전환 후 확인할 값
- 전체 상품 수
- 정상 동기화 상품 수
- 가격 업데이트 대기 상품
- 재고 오류 상품
- 최근 갱신 시간
- API 데이터 소스
저라면 전체 1만 개 상품을 하나씩 확인하기보다 아래처럼 테스트 상품을 골라보겠습니다.
전환 테스트 상품
① 정상 판매 상품 3개
② 당일 가격을 변경한 상품 3개
③ 재고가 0으로 변경된 품절상품 3개
④ 신규 등록 상품 3개
⑤ 삭제 예정 상품 1개
상품 상세화면에서 가격·재고 직접 비교
상품 상세페이지에서 상품 ID, 가격, 재고와 연결 데이터 소스를 비교합니다.
전환 직후에는 최소한 몇 개 상품을 직접 열어 자사몰과 비교하는 편이 좋습니다.
| 확인값 | 비교 대상 |
|---|---|
| 상품명 | 쇼핑몰 실제 상품명 |
| 상품 ID | ERP·쇼핑몰 SKU |
| 판매가 | 현재 쇼핑몰 가격 |
| 재고 | ERP 또는 쇼핑몰 재고 |
| 데이터 소스 | Merchant API 여부 |
Merchant API 오류코드 해결방법
Merchant API 전환 과정에서 자주 확인해야 하는 인증·권한·리소스·대량요청 오류입니다.
401 UNAUTHENTICATED 인증 오류
Access Token이 없거나 만료됐거나 올바른 인증 정보가 전달되지 않은 경우입니다.
OAuth Token 또는 서비스 계정 인증을 확인하고 토큰 자동 갱신이 정상적으로 작동하는지 확인합니다.
403 PERMISSION DENIED 권한 오류
인증은 됐지만 해당 Merchant Center 계정이나 리소스를 수정할 권한이 없는 경우입니다.
Merchant Center → 설정 → 사용자 및 액세스에서 인증에 사용하는 계정 또는 서비스 계정의 권한을 확인합니다.
404 NOT FOUND 리소스 없음
Merchant API의 account resource name이나 상품 resource name 형식이 틀린 경우가 많습니다.
accounts/{ACCOUNT_ID}/...기존 merchantId만 전달하는 코드라면 공식 Merchant API 문서의 resource name 형식을 다시 확인합니다.
customBatch 지원 안됨 오류
Content API에서 많이 사용했던 전용 customBatch 메서드는 Merchant API에 그대로 존재하지 않습니다.
다수 요청을 보내야 한다면 개별 API 호출을 병렬 실행하거나 Merchant API의 HTTP Batch 방식을 사용하는 구조로 수정해야 합니다.
Shopify·WooCommerce·CSV는 어떻게 대응할까?
사용하는 쇼핑몰 플랫폼에 따라 Merchant API 대응 방법이 다릅니다.
자체 개발 쇼핑몰
가장 먼저 확인해야 할 대상입니다.
서버 소스코드에서 다음 문자열을 검색합니다.
shoppingcontent.googleapis.com
content/v2.1
ShoppingContent
custombatch
customBatch발견된다면 기존 API 호출이 남아 있는지 개발자가 직접 검토해야 합니다.
Shopify
공식 Google & YouTube 앱을 사용하는 경우에는 일반적으로 플랫폼과 기술 제공자가 API 이전을 처리하는 구조입니다.
판매자 입장에서는 앱을 최신 상태로 유지하고 Merchant Center에서 실제 상품 동기화가 정상적으로 진행되는지 확인하는 것이 중요합니다.
WooCommerce
우커머스는 사용 중인 Google 상품 연동 플러그인을 확인해야 합니다.
오래된 서드파티 플러그인이라면 Content API를 직접 호출하고 있을 가능성이 있으므로 플러그인 업데이트 기록에서 Merchant API 지원 여부를 확인합니다.
CSV·Google Sheets
상품을 파일이나 Google Sheets로 전달하고 있다면 Content API 종료와 직접적인 관련이 없을 수 있습니다.
그래서 API라는 단어만 보고 설정을 전부 변경하기보다 현재 데이터 소스가 실제 API인지 확인하는 과정이 먼저입니다.
전환 후 쇼핑 상품이 줄어들었다면 상품 진단 확인
상품 감소가 발생하면 승인·거부·검토·경고 상태를 함께 확인합니다.
API 전환 직후 Google 쇼핑에 노출되는 상품 수가 줄었다면 광고 캠페인을 바로 삭제하거나 다시 만드는 것은 추천하지 않습니다.
먼저 머천트센터의 상품 진단에서 다음 내용을 확인합니다.
- 승인 상품 수
- 검토 중 상품
- 거부 상품
- 경고 상품
- 가격 불일치
- 재고 정보 지연
- 필수 속성 누락
- 랜딩페이지 오류
가격 불일치가 생기는 경우
쇼핑몰 가격은 79,000원인데 머천트센터에 75,000원이 남아 있다면 API 업데이트 지연이나 캐시, 다른 데이터 소스의 우선순위를 확인합니다.
Google은 상품 페이지에서 확인한 실제 가격과 제출한 상품 데이터를 비교하기 때문에 장시간 가격이 일치하지 않으면 상품 노출에 문제가 발생할 수 있습니다.
재고 불일치
쇼핑몰에서는 품절인데 Google 쇼핑에는 판매중으로 계속 표시된다면 사용자 경험뿐 아니라 광고비 낭비로도 연결됩니다.
이 경우 상품의 마지막 동기화 시간과 API 호출 로그부터 확인합니다.
Merchant API 전환 체크리스트
Content API 코드 검색부터 테스트·실운영·모니터링까지 단계별로 진행하는 것이 안전합니다.
Merchant API 전환 순서
① 기존 Content API 호출 위치 확인
② Google Cloud 프로젝트 확인
③ Merchant API 활성화
④ OAuth 또는 서비스 계정 인증 구성
⑤ Merchant Center 접근권한 연결
⑥ API 엔드포인트 변경
⑦ resource name·parent 구조 수정
⑧ customBatch 코드 수정
⑨ 테스트 상품으로 상품·가격·재고 검증
⑩ 실운영 반영
⑪ 24~48시간 상품 동기화와 오류 모니터링
실제 상황예시 - 품절인데 구글에는 판매중으로 남아있을 때
예를 들어 온라인몰에서 무선 이어폰 재고가 오전 10시에 모두 판매돼 재고가 0개가 됐다고 가정해보겠습니다.
원래는 쇼핑몰 서버가 몇 분마다 Content API를 통해 새로운 재고를 Google에 전달하고 있었습니다.
그런데 API 전환이 되지 않아 기존 호출이 실패하면 쇼핑몰에서는 품절인데 Merchant Center에는 이전 재고값이 남을 수 있습니다.
| 구분 | 실제값 | |
|---|---|---|
| 재고 | 0 | 10개 |
| 쇼핑몰 | 품절 | 판매중 |
| 결과 | 광고 클릭 후 품절 확인 → 사용자 이탈 | |
저라면 전환 직후 가격변경·신상품·품절상품을 각각 몇 개씩 골라 실제 쇼핑몰과 Google Merchant Center를 직접 비교할 것 같습니다.
API 전환과 구글 검색노출 문제는 구분해야 합니다
Merchant API 전환 이후 상품이 줄어들면 Google 검색 전체가 잘못됐다고 생각하기 쉽습니다.
하지만 Google 쇼핑 상품 데이터와 일반 웹페이지 검색색인은 별개로 확인하는 것이 좋습니다.
머천트센터에는 정상인데 일반 구글 검색에서 상품 페이지가 누락됐다면 Google Search Console의 색인 문제를 확인해야 합니다.
잡가이버 관련글 함께보기
Merchant API 바로 확인할 공식 링크
Merchant API 전환 FAQ
Content API가 종료되면 구글 쇼핑도 종료되나요?
아닙니다. 종료된 것은 프로그램 연동에 사용하던 Content API for Shopping입니다. Google Merchant Center와 Google 쇼핑 서비스 자체가 종료된 것은 아닙니다.
Merchant API로 꼭 변경해야 하나요?
쇼핑몰이나 프로그램에서 기존 Content API를 직접 호출했다면 변경해야 합니다. CSV, Google Sheets 등 별도의 데이터 소스를 사용한다면 상황이 다를 수 있습니다.
기존 API 주소에서 v2.1을 v1로만 바꾸면 되나요?
아닙니다. Merchant API는 호스트와 resource name, parent 구조, 일부 데이터 형식과 메서드가 다릅니다.
API Key로 Merchant API를 사용할 수 있나요?
일반적인 Merchant API 인증에는 OAuth 2.0 또는 서비스 계정과 같은 인증 방식이 필요합니다. API Key만 전달하는 방식으로 처리하면 인증 오류가 발생할 수 있습니다.
서비스 계정과 OAuth 중 무엇을 사용해야 하나요?
자체 회사 Merchant Center를 서버에서 자동 관리하는 프로그램이라면 서비스 계정이 편할 수 있고, 여러 고객의 Merchant Center에 접근하는 서비스라면 OAuth 2.0 방식이 적합합니다.
customBatch가 없어졌나요?
Content API의 전용 customBatch 메서드를 그대로 사용할 수 없습니다. 개별 요청의 병렬 처리 또는 Merchant API에서 지원하는 다중 HTTP 요청 방식을 검토해야 합니다.
Shopify도 직접 Merchant API를 수정해야 하나요?
Google 공식 앱처럼 플랫폼 공급자가 상품연동을 관리한다면 일반적으로 판매자가 API 코드를 직접 수정하는 구조는 아닙니다. 대신 앱 버전과 실제 상품 동기화 상태를 확인하는 것이 좋습니다.
WooCommerce에서는 무엇을 확인해야 하나요?
Google 상품을 연결하는 플러그인의 최신 버전과 Merchant API 지원 여부를 확인합니다. 오래된 플러그인은 업데이트나 교체가 필요할 수 있습니다.
Merchant API 전환 후 쇼핑 상품이 줄었습니다.
Merchant Center의 데이터 소스 마지막 갱신 시간, 승인·거부 상품 수, 가격 불일치와 재고 오류부터 확인합니다. 캠페인을 삭제하고 다시 만드는 것은 가장 마지막에 검토하는 편이 좋습니다.
상품 가격과 재고가 업데이트되지 않습니다.
API 호출 로그와 Merchant Center의 실제 데이터 소스를 비교합니다. 다른 피드나 데이터 소스가 같은 상품을 덮어쓰고 있는지도 확인해야 합니다.
마무리
구글 Content API for Shopping 종료는 일반적인 쇼핑몰 사용자에게는 눈에 띄지 않는 변화일 수 있지만 상품과 가격·재고를 API로 자동 관리하는 쇼핑몰에서는 상당히 중요한 변경입니다.
특히 자체 제작 쇼핑몰이나 ERP 연동 프로그램을 사용한다면 shoppingcontent.googleapis.com이나 content/v2.1 같은 기존 호출이 남아 있는지 확인하는 것이 가장 먼저 할 일입니다.
반대로 Shopify 공식 앱이나 파일·Google Sheets 방식으로 상품을 제공하고 있다면 무조건 API 개발부터 할 필요는 없습니다. 현재 Merchant Center의 데이터 소스가 어떤 방식으로 연결돼 있는지부터 확인하는 것이 훨씬 정확합니다.
전환 작업이 끝났다면 API가 성공했다고 끝내지 말고 실제 상품의 가격·재고·신규상품·품절상품을 직접 비교해보는 것을 추천합니다.
제 생각에는 쇼핑몰 API 전환에서 가장 위험한 부분은 시스템이 완전히 멈추는 오류보다 겉으로는 정상인데 가격이나 재고만 예전 값으로 남는 상황입니다. 이런 문제는 발견이 늦을수록 Google 쇼핑 노출과 광고 효율, 고객 신뢰까지 같이 영향을 받을 수 있기 때문입니다.