Ez a dokumentum útmutatás nyújt az Atom 1.0 formátumú XML-termékadatforrás létrehozásához. A szabványos attribútumokat összekapcsoltuk az Atom 1.0 hivatalos specifikációjának megfelelő szakaszaival, hogy segítsünk megtalálni a példáinkban szereplő összetevőkre vonatkozó további információkat. Habár a példáinkban Atom 1.0 formátumú fájlok szerepelnek, magát az Atom 1.0 rendszert csak érintőlegesen mutatjuk be.
Ha további információra van szüksége erről a szabványról, javasoljuk, hogy tájékozódjon a vonatkozó specifikációról a The Atom Syndication Format dokumentumból (csak angol nyelven).
Atom 1.0 formátumú mintafájl letöltéséhez kattintson ide.
1. szakasz: Atom 1.0
Az Atom 1.0 specifikáció alapján a bejegyzések szintjén öt előre meghatározott elem található – title [megnevezés], id [azonosító], link [link], összefoglaló és frissítve. Bár ezek az elemek az Atom 1.0 szabványban opcionálisak, a termékadatforrásokhoz meg kell adni őket.
A termékadatforrásokhoz további elemek is kötelezők lehetnek (pl. ár [price] és állapot [condition]). Arra az esetre, ha egy tételhez részletesebb információkat szeretne feltüntetni, kibővítettük az Atom 1.0 formátumot a Google Merchant Center-névtér hozzáadásával. A Google Merchant Center névterének meghatározása lehetővé teszi további elemek, úgynevezett „attribútumok” használatát, és növeli az egyes termékekhez a termékadatforrásban megadható információk mennyiségét.
Az alábbi példában egy Atom 1.0 formátumú, egyetlen tételt tartalmazó alapdokumentum látható:
<?xml version="1.0"?>
<táblázat xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>A termékadatforrás neve</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>Piros gyapjúpulóver</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Ez a kényelmes és puha pulóver a hideg téli éjszakákon is melegen tartja.</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>
Ebben a példában a két fő kiegészítés a névtér-deklaráció hozzáadása (a harmadik sorban), valamint három attribútum (képlink [image_link], ár [price] és állapot [condition]) szerepeltetése.
A Google Merchant Center-névtér deklarációja
A kizárólag a Google Merchant Center-névtérben meghatározott attribútumok használatához a következő névtér-deklarációt szükséges megadni.
xmlns:g="http://base.google.com/ns/1.0"
A Google Merchant Center-névtér deklarációja mellett minden attribútumcímkéhez hozzá kell adni egy előtagot. Ezt azért kell megtenni, hogy a saját névterünkben meghatározott attribútumokat megkülönböztessük az Atom 1.0 szabványban meghatározott elemektől. Az ehhez a névtér-deklarációhoz kiválasztott előtag a „g”:
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>
A Google Merchant Center-névtér attribútumainak tartalmaznia kell ezt az előtagot, különben a rendszer figyelmen kívül hagyja az attribútumokat és a hozzájuk kapcsolódó értékeket.
Attribútumok
Szükség szerint bármennyi releváns attribútumot hozzáadhat az adott termékhez. Minél több információt ad meg egy termékhez ezeknek az attribútumoknak a segítségével, annál nagyobb eséllyel fognak megjelenni a termékei a keresési találatokban. Ezenkívül a Google Merchant Center-névtérben meghatározott számos attribútum egynél többször is használható az egyes termékekhez. Ez lehetővé teszi, hogy még több rendelkezésre álló információt adjon meg a termékadatforrásban lévő termékekről.
2. rész: Fontos ellenőrzőlista
A termékadatforrás feltöltése előtt erősen javasolt ellenőrizni az alábbi lista elemeit a fájl megfelelő formázásának biztosítása érdekében:
A fájlnévnek .xml kiterjesztéssel kell végződnie.
A Google Merchant Center-fiókjában regisztrált termékadatforrás fájlnevének meg kell egyeznie a fájlhoz rendelt névvel.
Ne felejtse el megadni a névtér-deklarációkat. Ezeknek az értékeknek pontosan az alább látható módon kell megjelenniük:
- Google Merchant Center-névtér:
xmlns:g="http://base.google.com/ns/1.0". - Egyéni attribútum-névtér:
xmlns:[prefix]="http://base.google.com/cns/1.0", ahol a [prefix] kifejezés helyére a fájlban szereplő előtag kerül.
Ellenőrizze, hogy a Google Merchant Center- és az Egyéni Google Merchant Center-attribútumcímkék előtagjai megfelelnek-e a névtér-deklarációban meghatározott előtagnak.
Az értéket nem tartalmazó attribútumokat távolítsa el.
3. szakasz: Záró megjegyzés
Az ebben a dokumentumban szereplő mintabejegyzést leegyszerűsítettük, hogy jobban kiemeljük a Google Merchant Center XML-termékadatforrásának létrehozásához szükséges alapvető tudnivalókat. Bár befogadjuk az olyan termékadatforrásokat, amelyek az Atom 1.0 szabványban vagy a saját névtérben meghatározott más elemeket is tartalmaznak, az ezekben az elemekben foglalt információkat a rendszer figyelmen kívül hagyja a feldolgozás során, és nem fognak megjelenni a hirdetésekben és a díjmentes termékadatokban. Jelenleg csak az alapértelmezett Atom 1.0 elemekben, valamint a Google Merchant Center szolgáltatás attribútumaiban és az Egyéni Google Merchant Center-névterekben foglalt adatok feldolgozását végezzük el.