이 문서는 Atom 1.0 형식에서 XML 제품 데이터 피드를 만드는 가이드라인을 제공합니다. 예시에 나온 구성요소에 대한 추가 정보를 찾는 데 도움이 되도록 표준 속성을 공식 Atom 1.0 사양의 해당 섹션에 연결했습니다. 여기서는 Atom 1.0 파일을 예로 들었지만 Atom 1.0 자체에 대한 정보는 최소한으로만 제공합니다. 이 표준에 대해 자세히 알아보려면 Atom 신디케이션 형식에서 이 사양을 살펴보시기 바랍니다.
Atom 1.0 예시 파일을 다운로드하려면 여기를 클릭하세요.
섹션 1: Atom 1.0
Atom 1.0 사양에 따르면 항목 수준에서 사전에 지정하는 요소는 title[제목], id[ID], link[링크], summary[요약], updated[업데이트] 등 5가지입니다. 이러한 요소는 Atom 1.0 표준에서는 선택사항이지만 제품 데이터 피드를 사용하려면 반드시 필요합니다.
제품 데이터 피드는 또한 price[가격], condition[상태]과 같은 추가 요소를 필요로 합니다. 더 자세한 상품 정보를 포함하기 위해 Google은 Google 판매자 센터 네임스페이스를 추가하여 Atom 1.0의 범위를 넓혔습니다. Google 판매자 센터 네임스페이스를 정의하면 '속성'이라는 추가 요소를 이용하여 피드에서 각 제품에 대해 더 많은 정보를 제공할 수 있습니다.
다음은 단일 상품을 포함하는 기본 Atom 1.0 문서의 예입니다.
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>데이터 피드의 이름</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry>
<title>레드 울 스웨터</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>편안하고 부드러운 스웨터로 추운 겨울 밤을 따뜻하게 보낼 수 있습니다.</summary>
<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>새 상품</g:condition>
</entry> </feed>
이 예시에서 추가된 2가지 중요한 사항은 네임스페이스 선언과 3가지 속성(이미지 링크[image_link], 가격[price], 상태[condition])입니다.
Google 판매자 센터 네임스페이스 선언
Google 판매자 센터 네임스페이스에서만 정의되는 속성을 사용하려면 다음과 같이 네임스페이스를 선언해야 합니다.
xmlns:g="http://base.google.com/ns/1.0"
Google 판매자 센터 네임스페이스 선언과 더불어 판매자는 모든 속성 태그 내에 접두어를 포함해야 합니다. Atom 1.0으로 정의되는 요소와 Google의 네임스페이스를 정의하는 속성을 구별하기 위해 속성에는 이 접두어를 붙여야 합니다. 이 네임스페이스 선언에 사용하는 접두어는 'g'입니다.
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>
Google 판매자 센터 네임스페이스의 속성은 이 접두어를 포함해야 하며 그렇지 않으면 해당 속성 및 속성에 포함된 값은 모두 무시됩니다.
속성
제품의 속성은 관련된 개수만큼 사용할 수 있습니다. 이러한 속성을 사용하여 제품에 관한 추가 정보를 제공하면 제품이 결과에 표시될 확률이 크게 높아집니다. 또한 Google 판매자 센터 네임스페이스에 정의된 많은 속성을 한 제품 내에서 두 번 이상 사용할 수 있습니다. 제품에 대해 사용 가능한 정보를 피드에 더 많이 추가할 수 있습니다.
섹션 2: 중요 체크리스트
피드를 제출하기 전에 다음 목록을 점검하여 파일 형식이 올바른지 반드시 확인해 보세요.
- 파일 이름은 .xml 확장자로 끝나야 합니다.
- Google 판매자 센터 계정에 등록한 피드 파일 이름은 파일에 지정한 이름과 일치해야 합니다.
- 네임스페이스 선언을 포함해야 합니다. 이 값은 표시되는 값과 정확히 일치해야 합니다.
- Google 판매자 센터 네임스페이스:
xmlns:g="http://base.google.com/ns/1.0" - 맞춤 속성 네임스페이스:
xmlns:[prefix]="http://base.google.com/cns/1.0", [prefix]는 파일에 포함된 접두어로 교체됩니다.
- Google 판매자 센터 네임스페이스:
- Google 판매자 센터 및 맞춤설정한 Google 판매자 센터 속성 태그에 포함된 접두어가 네임스페이스 선언에 정의된 접두어와 일치하는지 확인합니다.
- 어떤 값도 포함하지 않은 속성은 삭제합니다.
섹션 3: 최종 참고사항
이 문서에 포함된 샘플 항목은 Google 판매자 센터 XML 데이터 피드를 작성하는 기본 사항을 보다 명확하게 파악할 수 있도록 단순화한 것입니다. Atom 1.0 표준 또는 자신의 네임스페이스에 정의된 다른 요소를 포함하는 피드는 수락되지만 이러한 요소에 포함되어 있는 모든 정보는 처리 중에 무시되므로 광고 또는 무료 제품 목록에 나타나지 않습니다. 현재 Google에서는 기본 Atom 1.0 요소와 Google 판매자 센터 및 맞춤설정한 Google 판매자 센터 네임스페이스의 속성에 포함된 데이터만 처리합니다.