ऐटम 0.3 से जुड़ी खास बातें

इस दस्तावेज़ में, ऐटम 0.3 फ़ॉर्मैट में एक्सएमएल प्रॉडक्ट डेटा फ़ीड बनाने के बारे में दिशा-निर्देश दिए गए हैं. हमने ऐटम 0.3 के आधिकारिक वर्शन में स्टैंडर्ड एट्रिब्यूट को उनसे जुड़े सेक्शन से लिंक किया है, ताकि हम अपने उदाहरणों के कॉम्पोनेंट के बारे में ज़्यादा जानकारी ढूंढने में आपकी मदद कर सकें. हालांकि, हम ऐटम 0.3 फ़ाइलों के उदाहरण देते हैं, लेकिन हम ऐटम 0.3 के बारे में बहुत कम जानकारी देते हैं.

पहला सेक्शन: ऐटम 0.3

ऐटम 0.3 से जुड़ी खास बातों के मुताबिक शुरुआती स्तर पर, पहले से तय किए गए चार एलिमेंट मौजूद होते हैं. इनमें शीर्षक, लिंक, आईडी, और अपडेट शामिल हैं. ऐटम 0.3 के स्टैंडर्ड वर्शन में, इन एलिमेंट की मौजूदगी ज़रूरी नहीं होती. हालांकि, आपके डेटा फ़ीड में इनका मौजूद होना ज़रूरी है.

आपके डेटा फ़ीड के लिए, कीमत और स्थिति जैसे दूसरे एलिमेंट की भी ज़रूरत होती है. इन एलिमेंट को शामिल करने और प्रॉडक्ट के बारे में ज़्यादा जानकारी जोड़ने के लिए, हमने Google Merchant Center का नेमस्पेस जोड़कर, ऐटम 0.3 को बढ़ा दिया है. Google Merchant Center का नेमस्पेस तय करने पर, आप ज़्यादा एलिमेंट यानी कि "एट्रिब्यूट" इस्तेमाल कर सकते हैं. इस तरह, आप फ़ीड में हर प्रॉडक्ट के बारे में ज़्यादा जानकारी दे सकते हैं.

यहां एक प्रॉडक्ट वाले सामान्य ऐटम 0.3 दस्तावेज़ का उदाहरण दिया गया है:

<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"

xmlns:g="http://base.google.com/ns/1.0">

<title>आपके डेटा फ़ीड का नाम</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>लाल रंग का ऊनी स्वेटर</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>आरामदायक और मुलायम, यह स्वेटर सर्दी के मौसम की ठंडी रातों में आपके शरीर को गर्म रखेगा.</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>

इस उदाहरण में दो ज़रूरी चीज़ें जोड़ी गई हैं: नेमस्पेस का एलान करना (तीसरी लाइन में) और इन तीन एट्रिब्यूट को शामिल करना (इमेज का लिंक [image_link], कीमत [price], और स्थिति [condition]).

Google Merchant Center नेमस्पेस का एलान

सिर्फ़ Google Merchant Center के नेमस्पेस में तय किए गए एट्रिब्यूट इस्तेमाल करने पर, नीचे दिए गए नेमस्पेस का एलान करना ज़रूरी होता है.

xmlns:g="http://base.google.com/ns/1.0"

Google Merchant Center के नेमस्पेस के एलान के अलावा, आपको हर एट्रिब्यूट टैग में कोई प्रीफ़िक्स भी शामिल करना होगा. हमारे नेमस्पेस में तय किए गए एट्रिब्यूट को, ऐटम 0.3 में तय किए गए एलिमेंट से अलग करने के लिए, हम इस प्रीफ़िक्स को एट्रिब्यूट में जोड़ते हैं. इस नेमस्पेस का एलान करने के लिए चुना गया प्रीफ़िक्स "g" है:

<g:image_link>http://www.example.com/image1.jpg</g:image_link>

Google Merchant Center के नेमस्पेस के एट्रिब्यूट में, इस प्रीफ़िक्स या एट्रिब्यूट को शामिल करना ज़रूरी है. ऐसा न करने पर, एट्रिब्यूट की वैल्यू को अनदेखा कर दिया जाएगा.

एट्रिब्यूट

आप अपने प्रॉडक्ट के बारे में बताने के लिए, जितने चाहें उतने एट्रिब्यूट इस्तेमाल कर सकते हैं. इन एट्रिब्यूट का इस्तेमाल करके अपने प्रॉडक्ट के बारे में ज़्यादा जानकारी देने पर, खोज के नतीजों में आपके प्रॉडक्ट के दिखने की संभावना काफ़ी बढ़ जाएगी. इसके अलावा, Google Merchant Center के नेमस्पेस में तय किए गए कई एट्रिब्यूट को किसी प्रॉडक्ट के लिए एक से ज़्यादा बार इस्तेमाल किया जा सकता है. इससे आप अपने फ़ीड में, किसी प्रॉडक्ट के लिए ज़्यादा जानकारी जोड़ सकते हैं.

दूसरा सेक्शन: ज़रूरी चेकलिस्ट

अपना फ़ीड सबमिट करने से पहले, यह पक्का कर लें कि आपकी फ़ाइल सही तरीके से फ़ॉर्मैट की गई है. इसके लिए, हमारा सुझाव है कि आप यह सूची ज़रूर देखें:

1. आपका फ़ाइल नाम .xml एक्सटेंशन से खत्म होना चाहिए.
2. आपके Google Merchant Center खाते में रजिस्टर किया गया फ़ीड फ़ाइल नाम उस नाम से मेल खाना चाहिए जो आपने अपनी फ़ाइल को दिया है.
3. नेमस्पेस के एलान को शामिल करना न भूलें. ये वैल्यू दिखाई गई वैल्यू से पूरी तरह से मेल खानी चाहिए.
   1. Google Merchant Center का नेमस्पेस:xmlns:g="http://base.google.com/ns/1.0".
   2. कस्टम एट्रिब्यूट का नेमस्पेस: xmlns:[prefix]="http://base.google.com/cns/1.0", जहां [प्रीफ़िक्स] को आपकी फ़ाइल में शामिल प्रीफ़िक्स से बदला गया है.
4. पुष्टि करें कि Google Merchant Center और Google Merchant Center के कस्टम एट्रिब्यूट टैग में शामिल किया गया प्रीफ़िक्स, नेमस्पेस के एलान में तय किए गए प्रीफ़िक्स से मेल खाता है.
5. उन एट्रिब्यूट को हटाएं जिनमें कोई वैल्यू नहीं है.

तीसरा सेक्शन: फ़ाइनल नोट

इस दस्तावेज़ में, उदाहरण के तौर पर आसान एंट्री शामिल की गई है. इससे, Google Merchant Center का एक्सएमएल डेटा फ़ीड बनाने की बुनियादी बातों को आसानी से समझा जा सकता है. हम ऐसे फ़ीड स्वीकार करते हैं जिनमें ऐटम 0.3 स्टैंडर्ड या आपके नेमस्पेस में तय किए गए दूसरे एलिमेंट शामिल हों. हालांकि, प्रोसेस करते समय इन एलिमेंट में मौजूद किसी भी जानकारी को अनदेखा कर दिया जाएगा. साथ ही, यह जानकारी आपकी लिस्टिंग में नहीं दिखेगी. फ़िलहाल, हम सिर्फ़ ऐटम 0.3 के डिफ़ॉल्ट एलिमेंट में शामिल डेटा और Google Merchant Center और Google Merchant Center के कस्टम नेमस्पेस के एट्रिब्यूट में मौजूद डेटा को प्रोसेस करेंगे.