# GMC(Google Merchant Center) 연동 가이드

## **연동 방식**

* GMC 연동은 고객사 환경에 따라 두 가지 방식 중 선택할 수 있습니다.

<table><thead><tr><th width="111.3828125">구분</th><th width="301.65234375">1. 파일 피드 연동</th><th>2. Merchant API 연동</th></tr></thead><tbody><tr><td>방식</td><td>어드민에 파일 URL 등록<br>(구글·유튜브 쇼핑 등에 사용 중인 Feed URL을 통해 상품을 연동)</td><td>GMC Merchant API 호출 방식으로 정해진 엔드포인트로 전송</td></tr><tr><td>수집 방식</td><td>스케줄 기반 자동 수집</td><td>실시간 연동</td></tr></tbody></table>

{% hint style="info" %}
**API 연동 방식:** Google Merchant API 규격의 요청 body를 그대로 정해진 전용 엔드포인트로 전송하면 됩니다. \
상세 엔드포인트는 하위 안내 문서를 참조해 주세요.
{% endhint %}

### **1. 파일 피드 연동**

#### Step 1. URL 등록 및 스케줄 설정

**관리자 화면에서 URL 등록**

* 관리자 화면의 \[상품 연동 관리 > GMC Feed] 화면에서 연동 설정 버튼을 눌러 아래 항목을 입력합니다. &#x20;
* 자사 서버에 피드 파일을 업로드한 후, 해당 파일의 URL을 관리자 화면에 등록합니다.

<figure><img src="/files/LkAIc1Q0VPVVdGJKkt1W" alt=""><figcaption></figcaption></figure>

**URL 형식 조건**

* `http://` 또는 `https://`를 포함한 완전한 URL이어야 합니다.
* 외부에서 접근 가능한 공개 URL이어야 합니다.
* 최대 파일 크기: 4GB

올바른 URL 예시

```
https://example.com/feed/products.tsv
https://cdn.example.com/gmc/feed.xml
```

잘못된 URL 예시

```
www.example.com/feed.tsv       ← http:// 또는 https:// 누락
/products/feed.tsv             ← 상대 경로 불가
```

#### **스케줄 설정**

연동 스케줄: 매일 정해진 시간에 1회 피드 파일을 자동 수집합니다.

* 오늘 예정된 수집이 아직 완료되지 않은 경우 → 당일부터 반영
* 오늘 예정된 수집이 이미 완료된 경우 → 다음 날 00시 이후부터 반영

{% hint style="info" %}
연동 요청이 집중되는 시간대에는 수집 완료까지 다소 시간이 소요될 수 있습니다. \
안정적인 수집을 위해 새벽 시간대 설정을 권장합니다.
{% endhint %}

#### **즉시 연동**&#x20;

스케줄과 별개로 즉시 수집을 실행할 수 있습니다.

* 제공 횟수: 월 3회&#x20;
* 초기화 주기: 매월 1일 자동 초기화
* 실행 방법: \[상품 연동 관리 > GMC Feed > 즉시 연동] 버튼 클릭

#### **Step 2. 저장 및 활성화**

저장 버튼 클릭 시 URL 유효성 검사가 수행되며 이상이 없으면 연동이 활성화됩니다.

* 우측 상단 토글을 ON 상태로 유지해야 스케줄 연동이 정상 동작합니다.
* 설정 완료 후 화면에서 다음 연동 예정 시각을 확인할 수 있습니다.

<figure><img src="/files/tfPKlKhqNGXSHlLM9GeE" alt=""><figcaption></figcaption></figure>

### **2. Merchant API 연동 방법**

GMC Merchant API 규격의 요청 body를 그대로 전용 엔드포인트로 전송하면 됩니다. 별도의 데이터 변환 없이 GMC API 표준 방식 그대로 사용할 수 있습니다.

{% hint style="info" %}
GMC Merchant API 규격은 [Google 공식 문서](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.productInputs?_gl=1*uzno6q*_up*MQ..*_ga*MTE4OTkwOTY4NC4xNzcyNzEyNzM0*_ga_SM8HXJ53K2*czE3NzI3MTI3MzQkbzEkZzAkdDE3NzI3MTI3NTckajM3JGwwJGgw#ProductInput)를 참고해 주세요.&#x20;
{% endhint %}

**GMC API 엔드포인트**

* 요청 주소: <https://gateway.gelatto.ai>

<table><thead><tr><th width="234.796875">Endpoint</th><th>Method</th><th>Header</th><th></th></tr></thead><tbody><tr><td>/collector/google/products</td><td>POST</td><td>Api-Key: 발급받은 API KEY</td><td>Merchant API 바디와 동일</td></tr><tr><td>/collector/google/products/{productInputsName}</td><td>PATCH</td><td>Api-Key: 발급받은 API KEY</td><td>Merchant API 바디와 동일</td></tr><tr><td>/collector/google/products/{productInputsName}</td><td>DELETE</td><td>Api-Key: 발급받은 API KEY</td><td></td></tr></tbody></table>

***

## FAQ

**Q. 파일 피드 연동 시 사전에 필요한 설정이 있나요?**

구글 쇼핑 규격에 맞는 TSV 또는 XML 피드 파일을 준비합니다. 준비된 피드 파일을 자사 서버에 업로드하고, 외부 접근 가능한 URL을 확인합니다.

* Google Merchant Center 피드 규격을 준수해야 하며 파일 크기는 최대 4GB 입니다.
* 파일은 저희 서버에서 HTTP GET 요청으로 접근 가능해야 합니다.

**Q. 피드 파일이 업데이트될 때마다 URL을 다시 등록해야 하나요?**

아닙니다. URL은 한 번만 등록하면 됩니다. 이후에는 동일한 URL 경로에 파일을 덮어쓰기 업로드하면 스케줄에 따라 최신 파일이 자동으로 수집됩니다.

**Q. 스케줄 연동 시각을 변경하면 언제부터 적용되나요?**

오늘 예정된 수집이 아직 완료되지 않은 경우 당일부터 반영되며, 이미 완료된 경우에는 다음 날부터 적용됩니다.

**Q. API 연동 방식은 어떻게 진행하나요?**

GMC Merchant API 규격 그대로 전용 엔드포인트에 요청하시면 됩니다. GMC 공식 문서를 참고해 주세요.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.genser.ai/more-info/gmc-google-merchant-center.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.