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

Ниже приведены инструкции по созданию XML-фида данных в формате Atom 1.0. Чтобы вам было удобнее искать дополнительную информацию о стандартных атрибутах, упомянутых в примерах, мы добавили в них ссылки на соответствующие разделы официальной спецификации Atom 1.0. Обратите внимание, что эта статья посвящена не формату Atom 1.0, а созданию фидов данных. Чтобы подробнее ознакомиться с форматом, прочитайте его спецификацию: http://www.ietf.org/rfc/rfc4287.txt.

Скачать пример файла 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> </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>2500</g:price> <g:condition>новый</g:condition>
</entry> </feed>

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

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

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

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. Не забудьте добавить объявление пространства имен в следующем формате: xmlns:g="http://base.google.com/ns/1.0" и xmlns:c="http://base.google.com/cns/1.0".
  4. В тексте выше обратите внимание на префикс "g". Убедитесь, что все теги атрибутов, относящихся к пространствам имен Google Merchant Center и Custom Google Merchant Center, содержат такую приставку.
  5. Удалите атрибуты без значений.


Раздел 3. Заключительное примечание

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

Была ли эта статья полезна?
Как можно улучшить эту статью?