GMC(Google Merchant Center) 연동 가이드
연동 방식
GMC 연동은 고객사 환경에 따라 두 가지 방식 중 선택할 수 있습니다.
방식
어드민에 파일 URL 등록 (구글·유튜브 쇼핑 등에 사용 중인 Feed URL을 통해 상품을 연동)
GMC Merchant API 호출 방식으로 정해진 엔드포인트로 전송
수집 방식
스케줄 기반 자동 수집
실시간 연동
API 연동 방식: Google Merchant API 규격의 요청 body를 그대로 정해진 전용 엔드포인트로 전송하면 됩니다. 상세 엔드포인트는 하위 안내 문서를 참조해 주세요.
1. 파일 피드 연동
Step 1. URL 등록 및 스케줄 설정
관리자 화면에서 URL 등록
관리자 화면의 [상품 연동 관리 > GMC Feed] 화면에서 연동 설정 버튼을 눌러 아래 항목을 입력합니다.
자사 서버에 피드 파일을 업로드한 후, 해당 파일의 URL을 관리자 화면에 등록합니다.
URL 형식 조건
http://또는https://를 포함한 완전한 URL이어야 합니다.외부에서 접근 가능한 공개 URL이어야 합니다.
최대 파일 크기: 4GB
올바른 URL 예시
잘못된 URL 예시
스케줄 설정
연동 스케줄: 매일 정해진 시간에 1회 피드 파일을 자동 수집합니다.
오늘 예정된 수집이 아직 완료되지 않은 경우 → 당일부터 반영
오늘 예정된 수집이 이미 완료된 경우 → 다음 날 00시 이후부터 반영
연동 요청이 집중되는 시간대에는 수집 완료까지 다소 시간이 소요될 수 있습니다. 안정적인 수집을 위해 새벽 시간대 설정을 권장합니다.
즉시 연동
스케줄과 별개로 즉시 수집을 실행할 수 있습니다.
제공 횟수: 월 3회
초기화 주기: 매월 1일 자동 초기화
실행 방법: [상품 연동 관리 > GMC Feed > 즉시 연동] 버튼 클릭
Step 2. 저장 및 활성화
저장 버튼 클릭 시 URL 유효성 검사가 수행되며 이상이 없으면 연동이 활성화됩니다.
우측 상단 토글을 ON 상태로 유지해야 스케줄 연동이 정상 동작합니다.
설정 완료 후 화면에서 다음 연동 예정 시각을 확인할 수 있습니다.
2. Merchant API 연동 방법
GMC Merchant API 규격의 요청 body를 그대로 전용 엔드포인트로 전송하면 됩니다. 별도의 데이터 변환 없이 GMC API 표준 방식 그대로 사용할 수 있습니다.
GMC Merchant API 규격은 Google 공식 문서를 참고해 주세요.
GMC API 엔드포인트
요청 주소: https://gateway.gelatto.ai
/collector/google/products
POST
Api-Key: 발급받은 API KEY
Merchant API 바디와 동일
/collector/google/products/{productInputsName}
PATCH
Api-Key: 발급받은 API KEY
Merchant API 바디와 동일
/collector/google/products/{productInputsName}
DELETE
Api-Key: 발급받은 API KEY
FAQ
Q. 파일 피드 연동 시 사전에 필요한 설정이 있나요?
구글 쇼핑 규격에 맞는 TSV 또는 XML 피드 파일을 준비합니다. 준비된 피드 파일을 자사 서버에 업로드하고, 외부 접근 가능한 URL을 확인합니다.
Google Merchant Center 피드 규격을 준수해야 하며 파일 크기는 최대 4GB 입니다.
파일은 저희 서버에서 HTTP GET 요청으로 접근 가능해야 합니다.
Q. 피드 파일이 업데이트될 때마다 URL을 다시 등록해야 하나요?
아닙니다. URL은 한 번만 등록하면 됩니다. 이후에는 동일한 URL 경로에 파일을 덮어쓰기 업로드하면 스케줄에 따라 최신 파일이 자동으로 수집됩니다.
Q. 스케줄 연동 시각을 변경하면 언제부터 적용되나요?
오늘 예정된 수집이 아직 완료되지 않은 경우 당일부터 반영되며, 이미 완료된 경우에는 다음 날부터 적용됩니다.
Q. API 연동 방식은 어떻게 진행하나요?
GMC Merchant API 규격 그대로 전용 엔드포인트에 요청하시면 됩니다. GMC 공식 문서를 참고해 주세요.
마지막 업데이트
도움이 되었나요?