Tento dokument obsahuje pokyny k vytvoření zdroje produktových dat v XML pro formát Atom 0.3. 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 0.3. Uvádíme sice příklady souborů ve formátu Atom 0.3, avšak o samotném formátu Atom 0.3 příliš mnoho informací neposkytujeme.
Část 1: Atom 0.3
Na základě specifikace formátu Atom 0.3 existují na základní úrovni čtyři předem definované prvky – title [název], link [odkaz], id [id] a modified [upraveno]. Ačkoli jsou tyto prvky ve standardu Atom 0.3 nepovinné, pro váš zdroj dat jsou vyžadovány.
Zdroj dat vyžaduje také další prvky, jako je cena a stav. Aby bylo možné tyto prvky přidat a uvést o produktu podrobnější informace, rozšířili jsme formát Atom 0.3 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 0.3. Dokument obsahuje jediný produkt:
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
xmlns:g="http://base.google.com/ns/1.0"><title>Název vašeho zdroje dat </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>Červený vlněný svetr</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Pohodlný a měkký svetr, který vás udrží v teple i za studených zimních nocí.</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>25</g:price> <g:condition>nové</g:condition> </entry> </feed>
V tomto příkladu jsou použity dva důležité přidané prvky – deklarace jmenného prostoru (na třetím řádku) 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 jmenném prostoru od prvků definovaných ve standardu Atom 0.3. Předpona vybraná pro tuto deklaraci jmenného prostoru je „g“:
<g:image_link>http://www.example.com/image1.jpg</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, zda je soubor řádně formátován:
- Název souboru musí končit příponou .xml.
- Název souboru zdroje, který zaregistrujete v účtu služby Google Merchant Center, se musí shodovat s názvem přiřazeným souboru.
- Nezapomeňte uvést deklarace oboru názvů. Tyto hodnoty musí přesně odpovídat níže uvedenému:
- Jmenný prostor služby Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - 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.
- Jmenný prostor služby Google Merchant Center:
- 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.
- 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 standardu Atom 0.3 nebo ve vašem 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 ve vašich zápisech se nezobrazí. Nyní zpracujeme pouze data obsažená mezi výchozími prvky formátu Atom 0.3 a mezi atributy jmenného prostoru služeb Google Merchant Center a Custom Google Merchant Center.