Спецификация Atom 1.0

Ниже приведены инструкции по созданию XML-фида данных в формате Atom 1.0. Чтобы вам было удобнее искать дополнительную информацию о стандартных атрибутах, упомянутых в примерах, мы добавили в них ссылки на соответствующие разделы официальной спецификации Atom 1.0. Обратите внимание, что эта статья посвящена не формату Atom 1.0, а созданию фидов данных. Чтобы узнать больше о самом формате, ознакомьтесь с его спецификацией.

Скачать пример файла Atom 1.0

Раздел 1. Atom 1.0

Согласно спецификации Atom 1.0, у товара есть пять предопределенных атрибутов: title (название), id (идентификатор), link (ссылка), summary (описание) и updated (дата последнего изменения). Они не относятся к обязательным атрибутам обычного фида Atom 1.0, однако необходимы при создании фида данных товаров.

К другим обязательным атрибутам относятся price [цена] и condition [состояние]. Чтобы у вас была возможность применять их, мы добавили в Atom 1.0 пространство имен Google Merchant Center. С помощью этих атрибутов вы сможете предоставить подробную и полную информацию о товаре.

Ниже вы найдете пример самого простого документа 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></>
<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>2500</g:price> <g:condition>new</g:condition>
</entry> </feed>

 

Как видно из этого примера, в фиде данных товаров, в отличие от обычного фида Atom 1.0, есть указание на пространство имен, а также три дополнительных атрибута: "ссылка на изображение" [image_link], "цена" [price] и "состояние" [condition].

Указание на пространство имен Google Merchant Center

Чтобы использовать атрибуты, которые есть только в Google Merchant Center, необходимо добавить следующее указание на пространство имен:

xmlns:g="http://base.google.com/ns/1.0"

Также, чтобы отличать атрибуты из нашего пространства имен от стандартных элементов Atom 1.0, следует добавить в каждый тег атрибута специальный префикс – "g":

<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

Без этого префикса значение атрибута из пространства имен Google Merchant Center не будет отображено в фиде.

Атрибуты

Вы можете добавить любое количество атрибутов. Главное, чтобы они точно описывали ваши товары. Чем больше сведений о товаре вы предоставите, тем чаще он будет отображаться в результатах поиска. Кроме того, для большинства атрибутов пространства имен Google Merchant Center можно указывать несколько значений, что позволяет предоставить больше информации о товаре.

Раздел 2. Обязательные требования

Перед отправкой фида настоятельно рекомендуем проверить, правильно ли он отформатирован.

1. Файл должен иметь расширение .xml.
2. Имя файла должно совпадать с названием фида, зарегистрированным в аккаунте Google Merchant Center.
3. Не забудьте добавить объявление пространства имен в следующем формате:
   1. Для пространства имен Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Для пространства пользовательских имен: xmlns:[prefix]="http://base.google.com/cns/1.0", где [prefix] заменяется префиксом, который вы указали в файле.
4. Убедитесь, что все теги атрибутов, в том числе пользовательских, относящихся к пространствам имен Google Merchant Center, содержат префикс "g".
5. Удалите атрибуты без значений.

Раздел 3. Заключение

Включенные в эту статью примеры были упрощены, чтобы продемонстрировать основы создания XML-фида данных. Обратите внимание, что мы принимаем фиды, содержащие другие элементы формата Atom 1.0 или вашего собственного пространства имен, однако информация, указанная в этих элементах, игнорируется в ходе обработки и не публикуется в объявлениях или информации, размещенной бесплатно. Пока мы анализируем только данные, которые содержатся в стандартных элементах формата Atom 1.0, а также в атрибутах в рамках пространств имен Google Merchant Center, в том числе пользовательских.