Tento dokument obsahuje pokyny na vytváranie zdrojov údajov o výrobkoch XML vo formáte Atom 1.0. Štandardné atribúty sme prepojili s príslušnými sekciami v oficiálnej špecifikácii Atom 1.0, aby ste mohli ľahšie nájsť ďalšie informácie o komponentoch z našich príkladov. Hoci poskytujeme príklady súborov vo formáte Atom 1.0, podrobnostiam o samotnej špecifikácii Atom 1.0 sa venujeme len minimálne.
Ak sa chcete o tomto štandarde dozvedieť viac, odporúčame vám pozrieť si túto špecifikáciu v dokumente The Atom Syndication Format.
Ak si chcete stiahnuť ukážkový súbor vo formáte Atom 1.0, kliknite tu.
1. sekcia: Atom 1.0
Podľa špecifikácie Atom 1.0 existuje na úrovni položky päť preddefinovaných prvkov: name (názov), id (identifikátor), link (odkaz), summary (súhrn) a updated (aktualizované). Hoci sú tieto prvky v štandarde Atom 1.0 nepovinné, v zdrojoch údajov o výrobkoch sa vyžadujú.
Okrem toho musia zdroje údajov o výrobkoch obsahovať aj iné prvky, napríklad cenu a stav. Kvôli uvádzaniu ďalších podrobnejších informácií o položke sme špecifikáciu Atom 1.0 rozšírili o priestor názvov služby Google Merchant Center. Po definovaní priestoru názvov služby Google Merchant Center budete môcť používať aj ďalšie prvky (nazývané atribúty) a zvýšiť objem informácií, ktoré možno uviesť k jednotlivým výrobkom v zdroji údajov o výrobkoch.
Nižšie je uvedený príklad základného dokumentu vo formáte Atom 1.0, ktorý obsahuje len jednu položku:
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>Názov zdroja údajov o výrobkoch</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ý vlnený sveter</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Pohodlný a mäkký sveter, ktorý vás zahreje počas chladných zimných večerov.</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 príklade pribudli dva významné typy prvkov: deklarácia priestoru názvov a tri atribúty (odkaz na obrázok [odkaz_na_obrázok]
, cena [price]
a stav [condition]
).
Deklarácia priestoru názvov služby Google Merchant Center
Ak chcete používať atribúty definované len v priestore názvov služby Google Merchant Center, musíte povinne uviesť nasledujúcu deklaráciu priestoru názvov.
xmlns:g="http://base.google.com/ns/1.0"
Okrem definovania priestoru názvov služby Google Merchant Cente musíte tiež v každom štítku atribútu uviesť predponu. Túto predponu k atribútom pridávame kvôli odlíšeniu atribútov definovaných v priestore názvov od prvkov definovaných v štandarde Atom 1.0. Predpona vybratá pre túto deklaráciu priestoru názvov je „g“:
<g:image_link>
http://www.google.com/images/google_sm.gif</g:image_link>
Atribúty v priestore názvov služby Google Merchant Center musia obsahovať túto predponu, inak budú atribúty a všetky hodnoty, ktoré obsahujú, ignorované.
Atribúty
Použiť môžete toľko relevantných atribútov, koľko ich s vašimi výrobkami súvisí. Uvádzaním ďalších informácií o výrobkoch prostredníctvom týchto atribútov výrazne zvýšite šancu, že sa vaše výrobky zobrazia vo výsledkoch. Mnohé atribúty definované v priestore názvov služby Google Merchant Center sa navyše môžu použiť v rámci jedného výrobku aj viackrát. Vďaka tomu môžete do svojho zdroja údajov o výrobkoch pridať ďalšie dostupné informácie o výrobku.
2. sekcia: dôležitý kontrolný zoznam
Pred odoslaním zdroja údajov o výrobkoch dôrazne odporúčame prejsť si nasledujúci zoznam, aby ste sa uistili, že je súbor správne naformátovaný:
Názov súboru musí mať na konci príponu .xml.
Názov súboru zdroja údajov o výrobkoch zaregistrovaného v účte Google Merchant Center sa musí zhodovať s názvom, ktorý ste dali svojmu súboru.
Nezabudnite uviesť deklarácie priestoru názvov. Tieto hodnoty by sa mali presne zhodovať s tými, ktoré uvádzame nižšie.
- Priestor názvov služby Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0"
. - Vlastný priestor názvov pre atribúty:
xmlns:[prefix]="http://base.google.com/cns/1.0"
, pričom reťazec [prefix] sa nahrádza predponou uvedenou v súbore.
Skontrolujte, či sa predpona v značke atribútu a používateľského atribútu v službe Google Merchant Center zhoduje s predponou definovanou v deklarácii priestoru názvov.
Odstráňte atribúty, ktoré neobsahujú žiadne hodnoty.
3. sekcia: záverečné poznámky
Príklad uvedený v tomto dokumente bol zjednodušený, aby sme sa mohli sústrediť na základy vytvárania zdroja údajov o výrobkoch XML v službe Google Merchant Center. Hoci akceptujeme zdroje údajov o výrobkoch, ktoré obsahujú aj iné prvky definované v štandarde Atom 1.0 alebo vo vašom vlastnom priestore názvov, akékoľvek informácie obsiahnuté v týchto prvkoch budú počas spracúvania ignorované a vo vašich nákupných reklamách ani bezplatných záznamoch o výrobkoch sa nebudú zobrazovať. Momentálne spracúvame len údaje obsiahnuté v predvolených prvkoch definovaných v štandarde Atom 1.0 a v atribútoch v rámci priestoru názvov služby Google Merchant Center a vlastného priestoru názvov služby Google Merchant Center.