Atom 1.0 规范

本文将提供在以 Atom 1.0 格式创建 XML 商品数据 Feed 时所需遵循的准则。我们将标准属性与官方 Atom 1.0 规范中的相应章节关联了起来，以便帮助您查找有关示例中各个组成部分的更多信息。虽然我们提供了 Atom 1.0 文件的示例，但对于 Atom 1.0 本身则仅仅提供了最基本的信息。如果您想详细了解这种标准，建议您访问 Atom 供稿格式查看具体规范。

如需下载 Atom 1.0 示例文件，请点击此处。

第 1 节：Atom 1.0

根据 Atom 1.0 规范，在条目一级有五个预定义的元素，即标题 (title)、id、链接 (link)、摘要 (summary) 和更新时间 (updated)。这些元素虽然在 Atom 1.0 标准中是可选元素，但在商品数据 Feed 中却是必需元素。

商品数据 Feed 还要求使用其他元素，如价格和使用情况。为了添加更多商品详细信息，我们通过添加 Google Merchant Center 命名空间对 Atom 1.0 进行了扩展。通过定义 Google Merchant Center 命名空间，您可以使用更多元素（称为“属性”），并增加在 Feed 中提供的关于各商品的信息量。

下面是基本 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>数据 Feed 的名称</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>new</g:condition>
</entry> </feed>

 

此示例中主要添加了两项内容，即命名空间声明和三个属性（图片链接 [image_link]、价格 [price] 和使用情况 [condition]）。

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://www.google.com/images/google_sm.gif</g:image_link>

Google Merchant Center 命名空间中的属性必须包含这种前缀，否则属性和其中包含的值都会被忽略。

属性

您可以根据商品使用任意数量的相关属性。通过使用这些属性提供有关您商品的更多信息，可以大大提高您的商品出现在搜索结果中的机率。此外，Google Merchant Center 命名空间中所定义的许多属性都能在单一商品中多次使用。这样您就能在 Feed 中添加更多有关某种商品的可用信息。

第 2 节：重要检查事项清单

强烈建议您先按以下清单进行通检，然后再提交 Feed，以确保文件格式正确：

1. 文件名末尾必须使用 .xml 扩展名。
2. 您在 Google Merchant Center 帐号中注册的 Feed 文件名必须与您指定给文件的名称一致。
3. 记得要添加命名空间声明。这些值应该与如下所示完全一致。
   1. Google Merchant Center 命名空间：xmlns:g="http://base.google.com/ns/1.0".
   2. 自定义属性命名空间：xmlns:[前缀]="http://base.google.com/cns/1.0"，其中 [前缀] 会替换为您在文件中添加的前缀。
4. 验证添加到 Google Merchant Center 属性标记和自定义 Google Merchant Center 属性标记中的前缀是否都与命名空间声明中定义的前缀一致。
5. 移除不含值的属性。

第 3 节：最后提示

本文中的条目示例经过简化，以便更加清楚地突出有关如何构建 Google Merchant Center XML 数据 Feed 的基础知识。虽然我们接受 Feed 中含有 Atom 1.0 标准或您自己的命名空间中所定义的其他元素，但在处理过程中，这些元素所含的信息都会被系统忽略，因此不会出现在广告或非付费商品详情中。目前，我们仅会处理默认 Atom 1.0 元素所含的数据，以及 Google Merchant Center 和自定义 Google Merchant Center 命名空间中的属性所含的数据。