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

У цій статті наведено вказівки зі створення 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, але необхідні для фідів із даними про товар.

Фіди даних про товари мають також містити додаткові елементи, як-от ціну та стан. За допомогою таких додаткових елементів, або атрибутів, ви можете надавати докладнішу інформацію про товари. Щоб у вас була можливість застосовувати ці атрибути, ми додали в 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>25</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://www.google.com/images/google_sm.gif</g:image_link>

Без цього префікса значення атрибута з простору імен Google Merchant Center не відображатиметься у фіді.

Атрибути

Ви можете додавати скільки завгодно атрибутів. Що більше інформації про товар ви надасте, то частіше він показуватиметься в результатах пошуку. Крім того, для багатьох атрибутів простору імен Google Merchant Center можна вказувати кілька значень. Завдяки цьому ви можете додавати більше корисних відомостей про товар у фіді.

Розділ 2. Важливий контрольний список

Перш ніж надсилати фід, радимо вам ретельно перевірити форматування файлу за наведеним нижче контрольним списком.

1. Назва файлу має закінчуватися розширенням .xml.
2. Назва файлу фіду, який ви реєструєте в обліковому записі Google Merchant Center, має збігатися з назвою вашого файлу.
3. Не забудьте включити вказівки на простори імен. Ці значення мають бути точно такими, як указано нижче.
   1. Простір імен Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Простір імен спеціальних атрибутів: xmlns:[prefix]="http://base.google.com/cns/1.0", де [prefix] потрібно замінити префіксом із вашого файлу.
4. Переконайтеся, що префікс, включений у теги стандартних і спеціальних атрибутів Google Merchant Center, збігається з префіксом, визначеним в описі простору імен.
5. Вилучіть атрибути, для яких не задано значень.

Розділ 3. Кінцева примітка

У цій статті наведено спрощені приклади, що демонструють основи створення фіду даних Google Merchant Center у файлі XML. Зверніть увагу, що ми приймаємо фіди з іншими елементами формату Atom 1.0 або вашого власного простору імен, однак інформація, указана в цих елементах, ігнорується під час обробки та не відображається в оголошеннях або інформації про товари, розміщеній безкоштовно. Наразі ми обробляємо лише дані, що містяться в елементах Atom 1.0 за умовчанням, а також у стандартних і спеціальних атрибутах просторів імен Google Merchant Center.