このドキュメントでは、Atom 0.3 形式で XML 商品データソースを作成するためのガイドラインを説明します。例に示した標準属性は、正式な Atom 0.3 仕様の中の該当する各セクションにリンクしていますので、コンポーネントに関する追加情報をご覧いただけます。ここでは、Atom 0.3 自体に関する詳しい説明は最小限度に抑え、ファイルの例を示すに留めています。
セクション 1: Atom 0.3
Atom 0.3 仕様に基づいて、title（タイトル）、link（商品リンク）、id（ID）、updated（更新）という、事前定義された 4 つの初歩的な要素があります。これらの要素は Atom 0.3 標準ではオプションですが、商品データソースでは必須になります。
商品データソースでは、price（価格）や condition（状態）などのその他の要素も指定する必要があります。これらの要素や商品に関するより詳細な情報を含めるために、Google Merchant Center の名前空間を追加して Atom 0.3 を拡張しました。Google Merchant Center の名前空間を定義すると、「属性」と呼ばれる追加要素を使用できるようになり、商品データソース内のそれぞれの商品に関して提供できる情報量を増やすことができます。
以下は、1 つの商品が含まれている基本的な Atom 0.3 ドキュメントの例です。
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
xmlns:g="http://base.google.com/ns/1.0"><title>商品データソースの名前</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>赤いウールのセーター</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>柔らかく着心地の良いこのセーターは保温性も高く、寒い冬の夜におすすめです。</summary> <id>tag:google.com,2005-10-15:/support/products</id> <issued>2005-10-13T18:30:02Z</issued> <modified>2005-10-13T18:30:02Z</modified>
<g:image_link>http://www.example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition> </entry> </feed>
この例では、名前空間宣言の追加（3 行目）と 3 つの属性（image link [画像リンク]、proce [画像]、condition [状態]）という、2つの主要な点が追加されました。
Google Merchant Center の名前空間宣言
Google Merchant Center のネームスペースでのみ定義される属性を使用する場合は、次のネームスペース宣言が必要です。
xmlns:g="http://base.google.com/ns/1.0"
Google Merchant Center の名前空間宣言に加えて、すべての属性タグ内に接頭辞を含める必要もあります。この接頭辞を属性に追加するのは、名前空間内で定義されている属性と Atom 0.3 内で定義されている要素とを区別するためです。この名前空間宣言用に選択した接頭辞は「g」です。
<g:image_link>http://www.example.com/image1.jpg</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 0.3 規格または独自の名前空間の中で定義された他の要素が含まれている商品データソースも使用することはできますが、これらの要素に含まれている情報はすべて処理中に無視され、リスティングには表示されません。現時点では、デフォルトの Atom 0.3 要素に含まれるデータと、Google Merchant Center およびカスタム Google Merchant Center の名前空間内の属性に含まれるデータのみが処理されます。