このドキュメントでは、Atom 0.1 形式で XML 商品データソースを作成するためのガイドラインを説明します。例に示した標準属性は、正式な Atom 1.0 仕様の中の該当する各セクションにリンクしていますので、コンポーネントに関する追加情報をご覧いただけます。Atom 1.0 に関しましては、その標準自体の詳細の説明は最小限度に抑え、ファイルの例を示すに留めております。
この規格の詳細については、Atom Syndication Format で仕様を確認することをおすすめします。
Atom 1.0 のサンプル ファイルをダウンロードするには、こちらをクリックしてください。
セクション 1: Atom 1.0
Atom 1.0 仕様に基づく 5 つの初歩的な要素として、title（タイトル）、id（id）、link（商品リンク）、summary（概要）、updated（更新）が事前定義されています。これらの要素は Atom 0.1 標準では省略可能ですが、商品データソースでは必須となります。
商品データソースでは、他にも price（価格）や condition（状態）などの必須要素があります。商品アイテムに関するより詳細な情報を含めるために、Google Merchant Center のネームスペースを追加して Atom 1.0 の機能を拡張しました。Google Merchant Center の名前空間を定義すると、「属性」と呼ばれる追加要素を使用できるようになり、商品データソース内のそれぞれの商品に関して提供できる情報量を増やすことができます。
1 つの商品アイテムを含む基本的な Atom 1.0 ドキュメントの例を以下に示します。
<?xml version="1.0"?>
<feed xmlns="http://w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>商品データソースの名前</title> <link href="http://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://example.com/item1-info-page.html" /> <summary>柔らかく着心地の良いこのセーターは保温性も高く、寒い冬の夜におすすめです。</summary>
<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://google.com/images/google_sm.gif</g:image_link> <g:price>2500</g:price> <g:condition>new</g:condition>
</entry> </feed>
この例では、名前空間宣言と 3 つの属性（商品画像リンク [image link]、価格 [price]、状態 [condition]）という、2 つの主要な点が追加されました。
Google Merchant Center の名前空間宣言
Google Merchant Center のネームスペースでのみ定義される属性を使用する場合は、次のネームスペース宣言が必要です。
xmlns:g="http://base.google.com/ns/1.0"
Google Merchant Center の名前空間宣言に加えて、すべての属性タグ内に接頭辞を含める必要もあります。この接頭辞を属性に追加するのは、名前空間内で定義されている属性と Atom 1.0 内で定義されている要素を区別するためです。この名前空間宣言用に選択した接頭辞は「g」です。
<g:image_link>http://google.com/images/google_sm.gif</g:image_link>
Google Merchant Center の名前空間内の属性にはこの接頭辞を含める必要があります。含めない場合、属性とそこで指定された値は無視されます。
属性
商品に特有の関連属性を必要なだけ使用できます。こうした属性を使って追加情報を商品に設定すると、商品が検索結果に表示される可能性が大幅に高まります。さらに Google Merchant Center の名前空間で定義された多くの属性は 1 つの商品の中で複数回使用できます。これにより、商品データソース内の商品に関する情報をより多く追加できます。
セクション 2: 重要なチェックリスト
商品データソースを登録する前に、次のリストに目を通して、ファイルの形式が正しいことを確認しておくことを強くおすすめします。
ファイル名の末尾は拡張子 .xml である必要があります。
Google Merchant Center アカウントに登録した商品データソースのファイル名はファイルに割り当てた名前と一致する必要があります。
名前空間宣言を必ず含めてください。これらの値は表示されている内容と厳密に一致する必要があります。
- Google Merchant Center の名前空間:
xmlns:g="http://base.google.com/ns/1.0" - カスタム属性の名前空間:
xmlns:[接頭辞]="http://base.google.com/cns/1.0"（ファイル内に含めた接頭辞で [接頭辞] を置き換えます）
Google Merchant Center とカスタム Google Merchant Center の属性タグに含まれている接頭辞が、名前空間宣言で定義された接頭辞と一致していることを確認します。
値を含まない属性は削除します。
セクション 3: 最後の注意事項
このドキュメントに含まれているサンプル エントリは、Google Merchant Center の XML 商品データソース作成の基礎がわかりやすくなるように簡略化されています。Atom 1.0 規格または独自の名前空間の中で定義された他の要素が含まれている商品データソースも使用することはできますが、これらの要素に含まれている情報はすべて処理中に無視され、広告や無料商品リスティングには表示されません。現時点では、デフォルトの Atom 1.0 要素と Google Merchant Center およびカスタム Google Merchant Center の名前空間内の属性に含まれるデータのみが処理されます。