Ниже приведены инструкции по созданию источника XML-данных о товарах в формате Atom 1.0. Чтобы вам было удобнее искать дополнительную информацию о стандартных атрибутах, упомянутых в примерах, мы добавили ссылки на разделы официальной спецификации Atom 1.0. Обратите внимание, что эта статья посвящена не формату Atom 1.0, а созданию источников данных.
Чтобы узнать больше о самом формате, ознакомьтесь с его спецификацией.
Раздел 1. Atom 1.0
Согласно спецификации Atom 1.0, у товара есть пять предопределенных атрибутов: "название", "идентификатор", "ссылка", "краткое описание" и "дата последнего изменения". Они не относятся к обязательным атрибутам обычного источника данных Atom 1.0, однако необходимы при создании источника данных о товарах.
К другим обязательным атрибутам относятся "цена" и "состояние". Чтобы вы могли использовать их, мы добавили в 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>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. Обязательные требования
Прежде чем отправлять источник данных о товарах, убедитесь, что выполняются следующие требования к форматированию:
Файл должен быть в формате XML.
Название файла должно совпадать с названием источника данных, зарегистрированным в аккаунте Google Merchant Center.
Не забудьте добавить объявление пространства имен в следующем формате:
- Для пространства имен Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Для пространства пользовательских имен:
xmlns:[prefix]="http://base.google.com/cns/1.0", где [prefix] заменяется префиксом, который вы указали в файле.
Убедитесь, что все теги атрибутов, в том числе пользовательских, относящихся к пространствам имен Google Merchant Center, содержат префикс "g".
Удалите атрибуты без значений.
Раздел 3. Заключение
Включенные в эту статью примеры были упрощены, чтобы продемонстрировать основы создания источника XML-данных. Обратите внимание, что мы принимаем источники данных, содержащие и другие элементы формата Atom 1.0 или вашего собственного пространства имен. Тем не менее сведения из них не учитываются при обработке источника и не публикуются. Пока мы анализируем только данные, которые содержатся в стандартных элементах формата Atom 1.0, а также в атрибутах в рамках пространств имен Google Merchant Center, в том числе пользовательских.