इस दस्तावेज़ में, ऐटम 1.0 फ़ॉर्मैट में, एक्सएमएल प्रॉडक्ट डेटा फ़ीड बनाने के दिशा-निर्देश दिए गए हैं. हमने ऐटम 1.0 के आधिकारिक वर्शन में स्टैंडर्ड एट्रिब्यूट को उनसे जुड़े सेक्शन से लिंक किया है, ताकि हम अपने उदाहरणों के कॉम्पोनेंट के बारे में ज़्यादा जानकारी ढूंढने में आपकी मदद कर सकें. हालांकि, हम ऐटम 1.0 फ़ाइलों के उदाहरण देते हैं, लेकिन हम ऐटम 1.0 के बारे में ज़्यादा जानकारी नहीं देते. इस स्टैंडर्ड के बारे में ज़्यादा जानने के लिए, ऐटम सिंडिकेशन फ़ॉर्मैट पर जाएं और इससे जुड़ी खास जानकारी देखें.
ऐटम 1.0 की उदाहरण फ़ाइल डाउनलोड करने के लिए, कृपया यहां क्लिक करें.
पहला सेक्शन: ऐटम 1.0
ऐटम 1.0 की खास बातों के मुताबिक, शुरुआती स्तर पर पहले से तय किए गए पांच एलिमेंट होते हैं - शीर्षक, आईडी, लिंक, खास जानकारी, और अपडेट. हालांकि, ऐटम 1.0 के स्टैंडर्ड वर्शन में इन एलिमेंट का होना ज़रूरी नहीं है, लेकिन प्रॉडक्ट डेटा फ़ीड में इनका होना ज़रूरी है.
प्रॉडक्ट डेटा फ़ीड के लिए कीमत और स्थिति जैसे कुछ दूसरे एलिमेंट की भी ज़रूरत होती है. सामान के बारे में ज़्यादा जानकारी शामिल करने के लिए, हमने Google Merchant Center नेमस्पेस जोड़कर, ऐटम 1.0 को बढ़ा दिया है. Google Merchant Center नेमस्पेस तय करने पर, ज़्यादा "एट्रिब्यूट" एलिमेंट इस्तेमाल किया जा सकता है. इस तरह, किसी फ़ीड में हर सामान के बारे में ज़्यादा जानकारी जोड़ी जा सकती है.
नीचे, सामान्य ऐटम 1.0 दस्तावेज़ का उदाहरण दिया गया है जिसमें एक सामान मौजूद है:
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>The name of your data feed</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>Red wool sweater</title> <id>1a</id> <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>
<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>
इस उदाहरण में दो ज़रूरी चीज़ें जोड़ी गई हैं: नेमस्पेस का एलान करना और इन तीन एट्रिब्यूट को शामिल करना (इमेज का लिंक [image_link]
, कीमत [Price]
, और स्थिति [condition]
).
Google Merchant Center नेमस्पेस का एलान
सिर्फ़ Google Merchant Center के नेमस्पेस में तय किए गए एट्रिब्यूट इस्तेमाल करने पर, नीचे दिए गए नेमस्पेस का एलान करना ज़रूरी होता है.
xmlns:g="http://base.google.com/ns/1.0"
Google Merchant Center नेमस्पेस के एलान के अलावा, आपको हर एट्रिब्यूट टैग में एक प्रीफ़िक्स भी शामिल करना होगा. हमारे नेमस्पेस में बताए गए एट्रिब्यूट को, ऐटम 1.0 में बताए गए एलिमेंट से अलग करने के लिए, हम इस प्रीफ़िक्स को एट्रिब्यूट में जोड़ते हैं. इस नेमस्पेस का एलान करने के लिए चुना गया प्रीफ़िक्स "g" है:
<g:image_link>
http://www.google.com/images/google_sm.gif</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 और Google Merchant Center के कस्टम एट्रिब्यूट टैग में शामिल किया गया प्रीफ़िक्स, नेमस्पेस के एलान में तय किए गए प्रीफ़िक्स से मेल खाता है.
- उन एट्रिब्यूट को हटाएं जिनमें कोई वैल्यू नहीं है.
तीसरा सेक्शन: फ़ाइनल नोट
इस दस्तावेज़ में, नमूने के तौर पर आसान एंट्री शामिल की गई है, ताकि आप Google Merchant Center का एक्सएमएल डेटा फ़ीड बनाने की बुनियादी बातों को आसानी से समझ सकें. हम ऐसे फ़ीड को स्वीकार करते हैं जिनमें ऐटम 1.0 स्टैंडर्ड में या आपके नेमस्पेस में तय किए गए दूसरे एलिमेंट शामिल हों. हालांकि, प्रोसेस करते समय इन एलिमेंट में मौजूद किसी भी जानकारी को अनदेखा कर दिया जाएगा. साथ ही, यह जानकारी आपके विज्ञापनों या मुफ़्त में दिखाई जाने वाली प्रॉडक्ट लिस्टिंग में भी नहीं दिखेगी. फ़िलहाल, हम सिर्फ़ ऐटम 1.0 के डिफ़ॉल्ट एलिमेंट में शामिल डेटा और Google Merchant Center और उसके कस्टम नेमस्पेस के एट्रिब्यूट में मौजूद डेटा को ही प्रोसेस करेंगे.