अहम जानकारी: यह इस पेज का पुराना वर्शन है. नए वर्शन के लिए, बाईं ओर के नेवबार में दिए गए लिंक इस्तेमाल करें.
इस दस्तावेज़ में, Blogger Data API के लिए रॉ प्रोटोकॉल (एक्सएमएल और एचटीटीपी) के बारे में ज़्यादा जानकारी दी गई है.
इस दस्तावेज़ में, प्रोग्रामिंग भाषा की क्लाइंट लाइब्रेरी के बारे में जानकारी नहीं है. क्लाइंट-लाइब्रेरी की रेफ़रंस जानकारी के लिए, डेवलपर की गाइड में प्रोग्रामिंग भाषा के हिसाब से बने सेक्शन में दिए गए लिंक देखें.
विषय सूची
दर्शक
यह दस्तावेज़ उन प्रोग्रामर के लिए है जो Blogger के साथ इंटरैक्ट कर सकने वाले क्लाइंट ऐप्लिकेशन लिखना चाहते हैं.
यह एक रेफ़रंस दस्तावेज़ है. इसमें माना जाता है कि आप डेवलपर की गाइड में दिए गए कॉन्सेप्ट और Google Data API प्रोटोकॉल में दिए गए सामान्य आइडिया को समझते हैं.
Blogger फ़ीड के टाइप
Blogger, फ़ीड में ब्लॉग का दो तरह का कॉन्टेंट दिखाता है: पूरा फ़ीड और समरी फ़ीड. पूरे फ़ीड में पूरी ब्लॉग पोस्ट होती हैं, जबकि खास जानकारी वाले फ़ीड में हर पोस्ट का सिर्फ़ एक छोटा स्निपेट होता है.
ब्लॉग का मालिक जीयूआई सेटिंग का इस्तेमाल करके यह तय कर सकता है कि ब्लॉग, सिंडिकेटर और एग्रीगेटर को पूरा फ़ीड उपलब्ध कराएगा या खास जानकारी वाला फ़ीड.
जब आपका क्लाइंट ऐप्लिकेशन किसी फ़ीड के लिए, बिना पुष्टि वाला अनुरोध भेजता है, तो उसे ब्लॉग के मालिक के बताए गए किसी भी तरह का फ़ीड मिलता है.
हालांकि, जब आपका क्लाइंट ऐप्लिकेशन, पुष्टि किया गया अनुरोध भेजता है, तो उसे हमेशा पूरा फ़ीड मिलता है. इससे कोई फ़र्क़ नहीं पड़ता कि ब्लॉग के मालिक ने क्या बताया है.
Blogger के क्वेरी पैरामीटर के बारे में जानकारी
Blogger Data API, करीब सभी स्टैंडर्ड Google Data API क्वेरी पैरामीटर के साथ काम करता है.
Blogger में q (टेक्स्ट खोज) और author पैरामीटर काम नहीं करते.
जब तक orderby पैरामीटर को updated पर सेट नहीं किया जाता, तब तक updated-min और updated-max क्वेरी पैरामीटर को अनदेखा किया जाता है. उदाहरण के लिए, नीचे दिया गया यूआरएल उन सभी ब्लॉग पोस्ट को फिर से शामिल करता है जिन्हें 16 मार्च, 2008 से लेकर 24 मार्च, 2008 तक अपडेट किया गया है:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
Blogger के एलिमेंट का रेफ़रंस
Blogger Data API सिर्फ़ स्टैंडर्ड ऐटम एलिमेंट का इस्तेमाल करता है. ज़्यादा जानकारी के लिए, ऐटम 1.0 के सिंडिकेशन फ़ॉर्मैट की खास बातें और ऐटम पब्लिशिंग प्रोटोकॉल देखें.
इस सेक्शन के बाकी हिस्से में, Blogger के कुछ स्टैंडर्ड एलिमेंट के इस्तेमाल से जुड़ी कुछ खास बातें बताई गई हैं.
ड्राफ़्ट एंट्री
ड्राफ़्ट ब्लॉग एंट्री को ऐटम पब्लिशिंग प्रोटोकॉल दस्तावेज़ में बताए गए <app:draft> एक्सटेंशन एलिमेंट का इस्तेमाल करके मार्क किया गया है. यहां ड्राफ़्ट एंट्री का एक उदाहरण दिया गया है:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
अगर कोई <draft> एलिमेंट तय नहीं किया गया है, तो इसका मतलब है कि एंट्री ड्राफ़्ट नहीं है.
पब्लिकेशन और अपडेट की गई तारीखें
स्टैंडर्ड ऐटम <published> एलिमेंट में दिया गया टाइमस्टैंप, "पोस्ट करने की तारीख" को दिखाता है, जिसे उपयोगकर्ता Blogger GUI में सेट कर सकते हैं.
अगर आपका क्लाइंट नई एंट्री बनाता है और <published> के लिए कोई वैल्यू नहीं बताता है, तो Blogger एंट्री की तारीख को सर्वर के मौजूदा समय पर सेट कर देता है. जब आपका क्लाइंट किसी एंट्री में बदलाव करता है, लेकिन <published> की वैल्यू नहीं बताता, तो Blogger एंट्री को पोस्ट करने की तारीख अकेले छोड़ देता है.
हालांकि, अगर आपका क्लाइंट कोई एंट्री बनाते या उसमें बदलाव करते समय <published> एलिमेंट के लिए कोई वैल्यू तय करता है, तो Blogger, एंट्री की पोस्ट की तारीख को बताई गई वैल्यू पर सेट कर देता है. यह किसी अन्य ब्लॉगिंग सिस्टम से पुरानी एंट्री इंपोर्ट करने (कॉन्टेंट बनाने की मूल तारीख को बनाए रखते हुए) जैसे कामों में काम आ सकता है.
Blogger, स्टैंडर्ड ऐटम <updated> एलिमेंट का इस्तेमाल करके बताता है कि किसी एंट्री को आखिरी बार कब बदला गया था. आपका क्लाइंट <updated> वैल्यू को कंट्रोल नहीं कर सकता. जब भी आपका क्लाइंट कोई एंट्री पोस्ट करता है या उसमें बदलाव करता है, तो Blogger, एंट्री की पिछली बार अपडेट होने की तारीख को हमेशा मौजूदा सर्वर समय पर सेट करता है.
<published> या <updated> की वैल्यू के आधार पर एंट्री का अनुरोध करने के लिए, स्टैंडर्ड Google Data API published-min, published-max, updated-min, और updated-max क्वेरी पैरामीटर का इस्तेमाल किया जा सकता है. हालांकि,
अपडेट की गई तारीखों के बारे में क्वेरी करने से जुड़ी ज़रूरी जानकारी के लिए, Blogger
के क्वेरी पैरामीटर का रेफ़रंस देखें.
टिप्पणियों को पोस्ट से लिंक करना
Blogger के एक्सपोर्ट फ़ॉर्मैट में एक ही ऐटम फ़ीड दस्तावेज़ में पोस्ट और टिप्पणी, दोनों तरह की एंट्री होती हैं.
इन दो तरह की एंट्री में अंतर करने के लिए, Blogger <atom:category> एलिमेंट का इस्तेमाल करता है. इस एलिमेंट में एक term पैरामीटर होगा, जिससे पता चलेगा कि यह एंट्री किसी पोस्ट के लिए है या टिप्पणी के लिए.
इसके अलावा, टिप्पणी वाली जिस पोस्ट की एंट्री है उससे लिंक करने की प्रोसेस को ऐटम थ्रेडिंग एक्सटेंशन का इस्तेमाल करके पूरा किया जा सकता है. नीचे दिए गए उदाहरण में, टिप्पणी एंट्री में मौजूद <thr:in-reply-to> एलिमेंट, ref पैरामीटर में पोस्ट एंट्री आइडेंटिफ़ायर का इस्तेमाल करके पोस्ट पर ले जाएगा. यह href पैरामीटर के ज़रिए, पोस्ट के एचटीएमएल यूआरएल से भी लिंक करता है.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
xmlns:thr="http://purl.org/syndication/thread/1.0">
...
<-- A blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID</id>
<content type="html">This is my first post</content>
<link rel="alternate" type="text/html"
href="http://blogName.blogspot.com/2007/04/first-post.html">
</link>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#post"/>
...
</entry>
<-- A comment to the blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
<content type="html">This is my first commment</content>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#comment"/>
<thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html"
ref="tag:blogger.com,1999:blog-blogID.post-postID"
type="text/html"/>
...
</entry>
</feed>