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