> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/reference/gmc-feed-url.md).

# GMC Feed URL 설정 가이드

GMC(Google Merchant Center) Feed URL 확인하는 방법에 대해 안내합니다.

## **URL만 찾으면 되는 경우**

피드 파일이 어디에 저장되어 있는지에 따라 URL 형태가 다릅니다.

#### **방법 1: Google Merchant Center에서 확인**

1. [Google Merchant Center](https://merchants.google.com/) 로그인
2. 좌측 메뉴 제품 → 피드 이동
3. 등록된 피드 항목 클릭 후 가져오기 URL 확인 및 복사

{% hint style="info" %}
GMC Feed 목록에서 `Content API` 라고 표시된 항목은 파일 URL이 아닙니다. \
파일 형식으로 등록된 항목에서만 가져오기 URL을 확인할 수 있습니다.
{% endhint %}

#### **방법 2: 개발팀에 문의**

피드 파일은 보통 아래 중 한 곳에 저장되어 있습니다.

* 쇼핑몰 서버 내 특정 경로에 정적 파일로 생성되는 경우
* AWS S3, Google Cloud Storage 등 외부 파일 서버(오브젝트 스토리지)에 업로드되는 경우
* 별도 API 엔드포인트로 동적으로 생성되는 경우

저장 위치에 따라 Feed URL 형태가 다릅니다.

<table><thead><tr><th width="222.97265625">저장 방식</th><th>Feed URL 예시</th></tr></thead><tbody><tr><td>쇼핑몰 서버 내 정적 파일</td><td><code>https://www.yourshop.com/feed/products.xml</code></td></tr><tr><td>AWS S3</td><td><code>https://s3.ap-northeast-2.amazonaws.com/bucket-name/feed/products.tsv</code></td></tr><tr><td>CloudFront (CDN) 경유</td><td><code>https://cdn.yourshop.com/feed/products.txt</code></td></tr><tr><td>API 엔드포인트</td><td><code>https://api.yourshop.com/v1/feed/google</code></td></tr></tbody></table>

개발팀에 아래와 같이 문의해 주세요.

> "Google Merchant Center 연동에 사용 중인 피드 파일 URL이 어떻게 되나요? S3나 CDN 등 외부 파일 서버를 사용 중이라면 해당 공개 URL도 함께 알려주세요."

***

## **처음 만드는 경우**

GMC Feed 파일을 개발팀에서 직접 구현해야 합니다. gelatto는 아래 세 가지 형식을 지원합니다.&#x20;

<table><thead><tr><th width="97.08984375">형식</th><th width="474.3828125">특징</th><th>확장자 예시</th></tr></thead><tbody><tr><td><strong>XML</strong></td><td>구조화된 태그 형식, 계층적 데이터 표현 가능</td><td><code>products.xml</code></td></tr><tr><td><strong>TSV</strong></td><td>탭 구분 텍스트, 용량 작고 처리 빠름</td><td><code>products.tsv</code></td></tr><tr><td><strong>TXT</strong></td><td>TSV와 동일한 탭 구분 형식, 확장자만 다름</td><td><code>products.txt</code></td></tr></tbody></table>

#### **필수 필드**

포함되어야 하는 내용은 파일 형식과 관계없이 동일합니다.

<table><thead><tr><th width="219.20703125">필드명</th><th width="194.53125">설명</th><th>예시</th></tr></thead><tbody><tr><td><code>id</code></td><td>상품 고유 ID</td><td><code>PRD_001</code></td></tr><tr><td><code>title</code></td><td>상품명</td><td><code>[브랜드] 반팔 티셔츠 화이트 L</code></td></tr><tr><td><code>description</code></td><td>상품 설명</td><td><code>레드 커튼은 옅은 회색 배경에 다양한 색상의 꽃들이 풍성하게 그려진 홈데코 패브릭 커튼입니다.</code></td></tr><tr><td><code>price</code></td><td>판매가 (통화 포함)</td><td><code>29000 KRW</code></td></tr><tr><td><code>link</code></td><td>상품 상세 URL</td><td><code>https://www.yourshop.com/product/1</code></td></tr><tr><td><code>image_link</code></td><td>대표 이미지 URL</td><td><code>https://cdn.yourshop.com/img/1.jpg</code></td></tr><tr><td><code>brand</code></td><td>브랜드명</td><td><code>gelatto</code></td></tr><tr><td><code>availability</code></td><td>재고 상태</td><td><code>in_stock</code>, <code>out_of_stock</code></td></tr></tbody></table>

{% hint style="info" %}
[Google 공식 문서](https://support.google.com/merchants/answer/7052112#product_category)를 참고해 주세요.
{% endhint %}

#### **선택 필드 (권장)**

<table><thead><tr><th width="379.93359375">필드명</th><th>설명</th></tr></thead><tbody><tr><td><code>google_product_category</code></td><td>Google 제품 카테고리</td></tr><tr><td><code>sale_price</code></td><td>할인가</td></tr><tr><td><code>mobile_link</code></td><td>모바일 상품 URL</td></tr><tr><td><code>additional_image_link</code></td><td>추가 이미지 URL</td></tr><tr><td><code>color</code></td><td>컬러 (패션에서는 특히 권장)</td></tr><tr><td><code>size</code></td><td>사이즈 (패션에서는 특히 권장)</td></tr><tr><td><code>gtin</code></td><td>국제 상품 번호 (바코드)</td></tr><tr><td><code>mpn</code></td><td>제조사 상품 번호</td></tr></tbody></table>

**XML 샘플**

```xml
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>My Shop Feed</title>
    <link>https://www.yourshop.com</link>
    <item>
      <g:id>PRD_001</g:id>
      <g:title>[브랜드] 반팔 티셔츠 화이트 L</g:title>
      <g:price>29000 KRW</g:price>
      <g:link>https://www.yourshop.com/product/1</g:link>
      <g:image_link>https://cdn.yourshop.com/img/1.jpg</g:image_link>
      <g:google_product_category>의류 및 액세서리 &gt; 의류</g:google_product_category>
      <g:shipping>
        <g:country>KR</g:country>
        <g:price>3000 KRW</g:price>
      </g:shipping>
    </item>
  </channel>
</rss>
```

**TSV / TXT 샘플**

```
id	title	price	link	image_link	google_product_category	shipping
PRD_001	[브랜드] 반팔 티셔츠 화이트 L	29000 KRW	https://www.yourshop.com/product/1	https://cdn.yourshop.com/img/1.jpg	의류 및 액세서리 > 의류	KR:::3000 KRW
PRD_002	[브랜드] 슬랙스 블랙 M	49000 KRW	https://www.yourshop.com/product/2	https://cdn.yourshop.com/img/2.jpg	의류 및 액세서리 > 의류	KR:::0 KRW
```

#### **개발팀 구현 체크리스트**

* 전체 상품을 지원 형식(XML / TSV / TXT) 중 하나로 출력하는 엔드포인트 구현
* TSV / TXT: 컬럼값 내 탭(`\t`), 개행(`\n`) 문자 제거 또는 공백 치환
* 파일 URL이 외부에서 HTTP/HTTPS로 접근 가능한지 확인

***

## **GMC Feed URL 정상 여부 확인**

브라우저 주소창에 Feed URL을 직접 입력했을 때 파일 데이터가 표시되면 정상입니다.

* 정상: 브라우저에서 XML 또는 탭 구분 텍스트 데이터가 표시됨

***

## **자주 묻는 질문**

<details>

<summary><strong>Q. XML, TSV, TXT 중 어떤 형식을 사용해야 하나요?</strong></summary>

세 형식 모두 지원합니다. 이미 GMC에 연동 중인 파일이 있다면 해당 형식을 그대로 사용하시면 됩니다. 새로 만드는 경우라면 용량이 작고 처리가 빠른 TSV 또는 TXT를 권장합니다.

</details>

<details>

<summary><strong>Q. TSV / TXT 컬럼값에 탭이나 줄바꿈이 포함된 경우 어떻게 처리하나요?</strong></summary>

탭(`\t`)과 개행(`\n`, `\r`) 문자는 반드시 공백( ) 처리 또는 제거 후 출력해야 합니다. 포함된 경우 파싱 오류로 해당 상품이 무효 처리됩니다.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.genser.ai/reference/gmc-feed-url.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.