Specifikace formátu Atom 1.0

Tento dokument obsahuje pokyny k vytvoření zdroje dat v XML pro formát Atom 1.0. Na pomoc s nalezením dalších informací o komponentách z našich příkladů jsme do standardních atributů vložili odkazy na odpovídající části v oficiální specifikaci formátu Atom 1.0. Uvádíme sice příklady souborů ve formátu Atom 1.0, avšak o samotném formátu Atom 1.0 příliš mnoho informací neposkytujeme. Pokud o tomto standardu chcete získat další informace, přečtěte si tuto specifikaci ve syndikačním formátu Atom.

Ukázkový soubor ve formátu Atom 1.0 můžete stáhnout kliknutím sem.

Část 1: Atom 1.0

Na základě specifikace formátu Atom 1.0 existuje na základní úrovni pět předem definovaných prvků – ‘název’ [title], ‘id’ [id], ‘shrnutí’ [summary] a ‘aktualizace’ [updated]. Ačkoli jsou tyto prvky ve standardu Atom 1.0 nepovinné, zdroje dat produktů je vyžadují.

Zdroje dat produktů vyžadují vyžaduje také další prvky, jako je price [cena] a condition [stav]. Aby bylo možné uvést o položce více informací, rozšířili jsme formát Atom 1.0 o jmenný prostor služby Google Merchant Center. Vymezení jmenného prostoru služby Google Merchant Center vám umožňuje používat další prvky, které se nazývají atributy. Díky tomu lze o každém produktu ve zdroji dat poskytnout větší množství informací.

Níže je uveden příklad základního dokumentu ve formátu Atom 1.0. Dokument obsahuje jedinou položku:

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"

xmlns:g="http://base.google.com/ns/1.0">
<title>The name of your data feed</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>Červený vlněný svetr</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Tento pohodlný a měkký svetr vás zahřeje o chladných zimních večerech.</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>

 

V tomto příkladu jsou použity dva důležité přidané prvky – deklarace jmenného prostoru a tři atributy (url obrázku [image_link], cena [price] a stav [condition]).

Deklarace jmenného prostoru služby Google Merchant Center

Atributy vymezené pouze ve jmenném prostoru služby Google Merchant Center lze použít jen za předpokladu, že je uvedena následující deklarace oboru názvů.

xmlns:g="http://base.google.com/ns/1.0"

Kromě deklarace jmenného prostoru služby Google Merchant Center musí také každá značka atributu obsahovat zvláštní předponu. Tuto předponu přidáváme k atributům a odlišujeme tak atributy definované v našem oboru názvů od prvků definovaných ve standardu Atom 1.0. Předpona vybraná pro tento obor názvů je „g“:

<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

Pokud atributy ze jmenného prostoru služby Google Merchant Center tuto předponu neobsahují, budou tyto atributy i všechny jejich hodnoty ignorovány.

Atributy

Můžete použít tolik relevantních atributů, kolik jich pro své produkty potřebujete. Uvedete-li doplňující informace o produktech pomocí těchto atributů, výrazně zvýšíte šanci, že se vaše produkty zobrazí ve výsledcích vyhledávání. Řadu atributů stanovených ve jmenném prostoru služby Google Merchant Center lze použít více než jednou u jednoho produktu. Do zdroje tak můžete přidat více dostupných informací o produktu.

Část 2: Kontrolní seznam

Než zdroj odešlete, doporučujeme projít si následující seznam a zkontrolovat, jestli je soubor řádně formátován:

1. Název souboru musí končit příponou .xml.
2. Název souboru zdroje, který zaregistrujete v účtu služby Google Merchant Center, se musí shodovat s názvem přiřazeným souboru.
3. Nezapomeňte uvést deklarace jmenného prostoru. Tyto hodnoty musí přesně odpovídat níže uvedenému:
   1. Jmenný prostor služby Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Jmenný prostor vlastních atributů: xmlns:[prefix]="http://base.google.com/cns/1.0", kde část [prefix] je nahrazen předponou, kterou jste vložili do souboru.
4. Ověřte, zda se předpona uvedená ve značkách atributů služeb Google Merchant Center a Custom Google Merchant Center shoduje s předponou uvedenou v deklaraci jmenného prostoru.
5. Odeberte atributy, které neobsahují žádné hodnoty.

Část 3: Závěrečná poznámka

Příklad záznamu uvedeného v tomto dokumentu byl zjednodušen, aby bylo možné věnovat více pozornosti základům sestavování zdroje dat pro službu Google Merchant Center v jazyce XML. Zdroje, které obsahují jiné prvky definované ve formátu Atom 1.0 nebo ve vlastním oboru názvů, sice přijímáme, ale veškeré informace obsažené v těchto prvcích budou při zpracování ignorovány a v reklamách a neplacených záznamech produktu se nezobrazí. Nyní zpracujeme pouze data obsažená ve výchozích prvcích formátu Atom 1.0 a atributech ve jmenném prostoru služby Google Merchant Center a Custom Google Merchant Center.