Ez a dokumentum útmutatás nyújt az Atom 0.3 formátumú XML-termékadatforrás létrehozásához. Az egyes szabványos attribútumokat összekötöttük a hivatalos Atom 0.3 specifikáció nekik megfelelő részeivel, így könnyen találhat további információt a példáinkban szereplő összetevőkről. Habár Atom 0.3 fájlokra mutatunk be példákat, magáról az Atom 0.3-ról csak minimális részleteket közlünk.
1. rész: Atom 0.3
Az Atom 0.3 specifikáció alapján bejegyzésszinten négy előre meghatározott elem van: a title [megnevezés], a link, az id [azonosító] és a modified [módosítva]. Habár ezek az elemek az Atom 0.3 szabvány szerint opcionálisak, a termékadatforrás megköveteli őket.
A termékadatforráshoz további elemek is kötelezők lehetnek (pl. ár [price] és állapot [condition]). Ahhoz, hogy ezek az elemek is bekerüljenek a rendszerbe, és egy termékhez részletesebb információt lehessen feltüntetni, kibővítettük az Atom 0.3 verziót 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élda egy alapszintű, egyetlen terméket tartalmazó Atom 0.3 dokumentumot mutat be:
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
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" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>Piros gyapjópulóver</title> <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> <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>
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 előtagot azért adjuk hozzá az attribútumokhoz, hogy a saját névterünkben meghatározott attribútumokat megkülönböztessük az Atom 0.3-ban meghatározott elemektől. Az ehhez a névtér-deklarációhoz kiválasztott előtag a „g”:
<g:image_link>http://www.example.com/image1.jpg</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. rész: Záró megjegyzés
Az ebben a dokumentumban szereplő példabejegyzést leegyszerűsítettük, hogy jobban kiemeljük a Google Merchant Center XML-termékadatforrás létrehozásához szükséges alapvető tudnivalókat. Bár befogadjuk az olyan termékadatforrásokat, amelyek az Atom 0.3 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 az adatokban. Jelenleg csak az alapértelmezett Atom 0.3 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.