머천트 센터 API로 상품 리뷰 올리는 법

결론부터 말하면 이렇다. 구글 머천트 센터의 상품 리뷰 데이터 소스가 이제 API로도 업로드된다. 얼마 전까지 고객센터 문서에는 "API는 상품 리뷰 데이터 소스에 아직 지원되지 않는다"고 적혀 있었는데, 이 문구가 최근 "API로 상품 리뷰를 추가한다"로 바뀌었다. 리뷰 데이터를 손으로 올리거나 파트너 업체를 거쳐야 했던 판매자에게는 반가운 변화다.

이 글은 무엇이 달라졌는지, 어떻게 신청하고 쓰는지, 그리고 이미 쓰고 있는 리뷰 스키마 마크업과는 어떤 관계인지 짧게 정리한다.

정확히 뭐가 바뀌었나?

리뷰 데이터를 화면에서 하나씩 올리지 않고, Merchant API 호출로 대량 등록·갱신할 수 있게 됐다. 지금까지는 상품 리뷰 데이터 소스를 만들 때 머천트 센터 화면에서 직접 파일을 올리거나, 구글이 인증한 제3의 리뷰 애그리게이터를 거치는 방법뿐이었다.

이번 변경으로 개발 리소스가 있는 판매자는 자체 시스템에서 리뷰를 수집해 바로 API로 밀어 넣을 수 있다. 문서 개편은 지난 8월 하순에서 9월 중순 사이에 이뤄졌고, 이 소식은 9월 18일 서치 엔진 라운드테이블을 통해 알려졌다.

리뷰 데이터를 다루는 방식 자체가 "수동 업로드 중심"에서 "API 자동화 가능"으로 넘어간 것이 이번 변경의 핵심이다.

어떻게 신청하고 쓰나?

먼저 상품 평점(Product Ratings) 프로그램에 가입하고, 구글의 승인을 받아야 API를 쓸 수 있다. 문서가 API를 지원한다고 밝혔다고 해서 누구나 바로 호출할 수 있는 것은 아니다.

절차는 아래 순서로 진행된다.

순서	해야 할 일
1	머천트 센터에서 Product Ratings 프로그램 가입, 활성 리뷰 피드 준비
2	Shopping API 지원 양식으로 신청, 구글 담당자의 수동 검토·승인 대기
3	승인 후 Merchant API의 datasource.create로 리뷰 데이터 소스 생성
4	수 분 뒤 반영 확인(요청은 기존 리소스를 통째로 덮어쓰는 방식)

리뷰 데이터 소스에는 리뷰어 정보(아이디·닉네임·익명 여부), 평점(최소·최대·실제 점수), 상품 식별자(GTIN·MPN·SKU), 리뷰 본문과 작성일, 장단점 목록까지 폭넓은 속성이 들어간다. 다만 요청 한 번에 리소스 전체가 덮어써지므로, 속성을 빠짐없이 채우지 않으면 기존 데이터가 사라질 수 있다는 점을 주의해야 한다.

리뷰 스키마 마크업과는 뭐가 다른가?

리뷰 스키마 마크업은 내 웹사이트 페이지 안에 심는 구조화 데이터이고, 이번 API는 머천트 센터에 직접 리뷰 데이터를 공급하는 별도 경로다. 둘은 경쟁 관계가 아니라 서로 다른 채널로 같은 목적, 즉 검색결과와 쇼핑 노출에서 별점을 보여주는 데 쓰인다.

사이트에 Review·AggregateRating 구조화 데이터를 이미 심어 뒀다면 그대로 유지하면 된다. 여기에 더해 머천트 센터 쪽 리뷰 데이터 소스까지 API로 자동화해 두면, 사이트 구조화 데이터와 쇼핑 피드 양쪽에서 리뷰 신호가 일관되게 관리된다.

두 경로의 데이터가 서로 다른 숫자를 보여주면 신뢰도가 떨어진다. 같은 상품이라면 사이트 리뷰 개수·평점과 머천트 센터 리뷰 데이터가 일치하도록 맞추는 것이 중요하다.

지금 뭘 준비해야 하나?

개발 리소스가 있다면 지금 신청 양식부터 넣어 두는 것이 순서다. 승인까지 시간이 걸릴 수 있으므로 미리 움직이는 편이 유리하다. 준비할 항목은 다음과 같다.

• 머천트 센터에서 Product Ratings 프로그램 가입 여부 확인
• 기존 리뷰 데이터(리뷰어·평점·본문)를 API 필드에 맞춰 정리
• 사이트 리뷰 스키마와 상품 식별자(GTIN·SKU)를 통일
• 이미 머천트 API로 전환을 마쳤다면, 같은 인증 체계를 그대로 활용

개발 인력이 없는 소규모 판매자라면 서두를 필요는 없다. 화면에서 직접 올리는 방식과 인증된 애그리게이터 경로는 그대로 유지되므로, API는 규모가 크고 리뷰 데이터가 자주 바뀌는 판매자에게 특히 유용한 선택지로 보면 된다.

리뷰 데이터와 상품 피드를 함께 정돈하는 작업은 생각보다 챙길 항목이 많습니다. 이루웹은 이커머스 홈페이지 제작부터 상품·리뷰 데이터 최적화까지 함께 검토해 드리고 있습니다. 이루웹의 다른 서비스도 살펴보시고, 궁금한 점은 문의 남겨 주시기 바랍니다.