У цій статті наведено вказівки зі створення XML-фіду даних про товари у форматі Atom 0.3. Щоб вам було легше шукати додаткову інформацію про стандартні атрибути, згадані в прикладах, ми додали посилання на відповідні розділи офіційної специфікації Atom 0.3. Зверніть увагу, що ця стаття присвячена не формату Atom 0.3, а створенню фідів даних.
Розділ 1. Atom 0.3
У специфікації Atom 0.3 на початковому рівні визначено чотири елементи: title (назва), link (посилання), id (ідентифікатор) і modified (дата й час внесення змін). Вони не є обов’язковими за стандартом Atom 0.3, але необхідні для фідів даних про товари.
Фіди даних про товари мають також містити додаткові елементи, зокрема ціну й стан. Щоб включити ці елементи й іншу докладну інформацію про товар, ми доповнили Atom 0.3 простором імен Google Merchant Center. Завдяки цьому ви зможете використовувати додаткові елементи, так звані "атрибути", і надавати більше інформації про кожний товар у фіді.
Нижче наведено приклад найпростішого документа у форматі 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>250</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"
Окрім цього, у кожний тег атрибута потрібно додати спеціальний префікс, щоб відрізняти атрибути з нашого простору імен від елементів Atom 0.3. Використовуйте префікс "g":
<g:image_link>http://www.example.com/image1.jpg</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:
- Переконайтеся, що префікс, включений у теги стандартних і спеціальних атрибутів Google Merchant Center, збігається з префіксом, визначеним в описі простору імен.
- Вилучіть атрибути, для яких не задано значень.
Розділ 3. Висновок
Включені в цю статтю приклади було спрощено, щоб продемонструвати основи створення фіду даних Google Merchant Center у файлі XML. Хоча ми приймаємо фіди з іншими елементами, визначеними в стандарті Atom 0.3 або у вашому власному просторі імен, будь-яка інформація, яку містять такі елементи, буде ігноруватися під час обробки й не показуватиметься в даних про ваші товари. Зараз ми обробляємо лише дані, що містяться в елементах Atom 0.3 за умовчанням, а також у стандартних і спеціальних атрибутах просторів імен Google Merchant Center.