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 – název, odkaz, ID a přítomnost změn. Ačkoli jsou tyto prvky ve standardu Atom 0.3 nepovinné, zdroje produktových dat je vyžadují.
Zdroj produktových 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 produktových 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 zdroje produktových 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>Tento pohodlný měkký svetr vás zahřeje o chladných zimních večerech.</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>new</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 je možné použít více než jednou u jednoho produktu. Do zdroje produktových dat tak můžete přidat více dostupných informací o produktu.
Část 2: Kontrolní seznam
Před odesláním zdroje produktových dat doporučujeme projít si následující seznam, který pomůže zajistit správné formátování souboru:
Název souboru musí končit příponou .xml.
Název souboru zdroje produktových dat, 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 jmenného prostoru. 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 nahrazena předponou, kterou jste vložili do souboru.
Ověřte, jestli 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 produktových dat pro službu Google Merchant Center v jazyce XML. Ačkoli přijímáme zdroje produktových dat obsahující i další prvky definované ve standardu Atom 0.3 nebo ve vašem vlastním jmenném prostoru, informace, které tyto prvky obsahují, budou při zpracování ignorovány a ve vašich záznamech se zobrazovat nebudou. Teď 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.