У цій статті наведено вказівки зі створення джерела даних про товари у форматі XML за стандартом Atom 1.0. Щоб вам було легше шукати додаткову інформацію про стандартні атрибути, згадані в прикладах, ми додали посилання на відповідні розділи офіційної специфікації Atom 1.0. Зверніть увагу, що ця стаття присвячена не формату Atom 1.0, а створенню джерел даних про товари.
Щоб дізнатися більше про цей стандарт, радимо переглянути специфікації формату синдикації Atom.
Щоб завантажити приклад файлу у форматі 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://w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>Назва вашого джерела даних про товари</title> <link href="http://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://example.com/item1-info-page.html" /> <summary>Цей зручний і м’який светр зігріє вас холодними зимовими вечорами.</summary>
<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://google.com/images/google_sm.gif</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 1.0. Використовуйте префікс "g":
<g:image_link>http://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, збігається з префіксом, визначеним в описі простору імен.
Вилучіть атрибути, для яких не задано значень.
Розділ 3. Кінцева примітка
У цій статті наведено спрощені приклади, що демонструють основи створення XML-файлу джерела даних про товари в Google Merchant Center. Хоча ми приймаємо джерела даних про товари, що містять інші елементи, визначені в стандарті Atom 1.0 або вашому власному просторі імен, будь-які відомості, що містяться в цих елементах, ігноруватимуться під час обробки й не з’являтимуться у ваших оголошеннях або безкоштовно розміщеній інформації про товари. Зараз ми обробляємо лише дані, що містяться в елементах Atom 1.0 за умовчанням, а також у стандартних і спеціальних атрибутах просторів імен Google Merchant Center.