इस दस्तावेज़ में, ऐटम 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>The name of your product data source</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>Red wool sweater</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Comfortable and soft, this sweater will keep you warm on those cold winter nights.</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 के नेमस्पेस में तय किए गए कई एट्रिब्यूट, एक प्रॉडक्ट के लिए एक से ज़्यादा बार इस्तेमाल किए जा सकते हैं. इससे अपने प्रॉडक्ट डेटा सोर्स में, किसी प्रॉडक्ट के बारे में ज़्यादा जानकारी जोड़ी जा सकती है.
दूसरा सेक्शन: ज़रूरी चेकलिस्ट
अपना प्रॉडक्ट डेटा सोर्स सबमिट करने से पहले, यह पक्का करें कि आपकी फ़ाइल सही तरीके से फ़ॉर्मैट की गई हो. इसके लिए, हमारा सुझाव है कि आप यहां दी गई लिस्ट देख लें:
आपकी फ़ाइल के नाम के आखिर में .xml एक्सटेंशन होना चाहिए.
आपके Google Merchant Center खाते में प्रॉडक्ट डेटा सोर्स की फ़ाइल के लिए रजिस्टर किया गया नाम, फ़ाइल को दिए गए नाम से मेल खाना चाहिए.
नेमस्पेस के एलान शामिल करना न भूलें. ये वैल्यू, दिखाई गई वैल्यू से पूरी तरह से मेल खानी चाहिए.
- Google Merchant Center का नेमस्पेस:
xmlns:g="http://base.google.com/ns/1.0". - कस्टम एट्रिब्यूट का नेमस्पेस:
xmlns:[prefix]="http://base.google.com/cns/1.0", इसमें [prefix] को आपकी फ़ाइल में शामिल प्रीफ़िक्स से बदला जाता है.
इस बात की पुष्टि करें कि Google Merchant Center और इसके कस्टम एट्रिब्यूट टैग में शामिल किया गया प्रीफ़िक्स, नेमस्पेस के एलान में बताए गए प्रीफ़िक्स से मेल खाता है.
उन एट्रिब्यूट को हटाएं जिनमें कोई वैल्यू नहीं दी गई है.
तीसरा सेक्शन: फ़ाइनल नोट
इस दस्तावेज़ में, उदाहरण के तौर पर आसान एंट्री शामिल की गई है. इससे आपको Google Merchant Center का एक्सएमएल प्रॉडक्ट डेटा सोर्स बनाने की बुनियादी बातें समझने में आसानी होगी. हम ऐसे प्रॉडक्ट डेटा सोर्स स्वीकार करते हैं जिनमें ऐटम 0.3 स्टैंडर्ड या आपके अपने नेमस्पेस में तय किए गए दूसरे एलिमेंट शामिल हों. हालांकि, प्रोसेस करते समय इन एलिमेंट में मौजूद किसी भी जानकारी को अनदेखा कर दिया जाएगा. इसके अलावा, यह जानकारी आपकी लिस्टिंग में भी नहीं दिखेगी. फ़िलहाल, हम सिर्फ़ ऐटम 0.3 के डिफ़ॉल्ट एलिमेंट में शामिल डेटा प्रोसेस करेंगे. इसके अलावा, हम Google Merchant Center और इसके कस्टम नेमस्पेस के एट्रिब्यूट में मौजूद डेटा भी प्रोसेस करेंगे.