अहम जानकारी: यह इस पेज का पुराना वर्शन है. नए वर्शन के लिए, बाईं ओर मौजूद नेविगेशन बार में दिए गए लिंक का इस्तेमाल करें.
यह दस्तावेज़, रॉ प्रोटोकॉल (एक्सएमएल और एचटीटीपी) के बारे में Blogger के डेटा एपीआई के बारे में ज़्यादा जानकारी देने वाला दस्तावेज़ देता है.
इस दस्तावेज़ में प्रोग्रामिंग भाषा की क्लाइंट लाइब्रेरी के बारे में जानकारी नहीं होती. क्लाइंट-लाइब्रेरी के बारे में जानकारी के लिए, डेवलपर की डेवलपर गाइड के प्रोग्रामिंग-भाषा के हिसाब से सेक्शन देखें.
कॉन्टेंट
दर्शक
यह दस्तावेज़ उन प्रोग्रामर के लिए है जो Blogger के साथ इंटरैक्ट करने वाले क्लाइंट ऐप्लिकेशन लिखना चाहते हैं.
यह एक रेफ़रंस दस्तावेज़ है; यह मानता है कि आप डेवलपर की गाइड में दिए गए कॉन्सेप्ट और Google डेटा एपीआई प्रोटोकॉल के पीछे के सामान्य आइडिया को समझते हैं.
Blogger फ़ीड के प्रकार
Blogger, फ़ीड में ब्लॉग कॉन्टेंट को दो तरीकों से दिखाता है: पूरा फ़ीड और खास जानकारी वाले फ़ीड. पूरे फ़ीड में पूरी ब्लॉग पोस्ट होती हैं. वहीं, खास जानकारी वाले फ़ीड में, हर पोस्ट का एक छोटा स्निपेट शामिल होता है.
किसी ब्लॉग के मालिक को GUI सेटिंग का इस्तेमाल करके यह बताना होगा कि ब्लॉग में पूरा फ़ीड दिया जा सकता है या नहीं. साथ ही, सिंडिकेट और एग्रीगेटर के लिए खास जानकारी वाला फ़ीड भी दिया जा सकता है.
जब आपका क्लाइंट ऐप्लिकेशन किसी फ़ीड के लिए, बिना पुष्टि वाला अनुरोध भेजता है, तो उसे उस तरह का फ़ीड मिलता है जो ब्लॉग के मालिक ने बताया है.
हालांकि, जब आपका क्लाइंट ऐप्लिकेशन पुष्टि करने का अनुरोध भेजता है, तो उसे हमेशा पूरा फ़ीड मिलता है. भले ही, ब्लॉग के मालिक ने कुछ भी बताया हो.
Blogger क्वेरी पैरामीटर रेफ़रंस
Blogger डेटा एपीआई करीब-करीब सभी स्टैंडर्ड Google डेटा एपीआई क्वेरी पैरामीटर के साथ काम करता है.
Blogger में q (टेक्स्ट खोज) और
author पैरामीटर काम नहीं करते.
updated-min और updated-max क्वेरी पैरामीटर को तब तक अनदेखा किया जाता है, जब तक orderby पैरामीटर कोupdated पर सेट नहीं किया जाता. उदाहरण के लिए, नीचे दिया गया यूआरएल उन सभी ब्लॉग पोस्ट को फिर से हासिल करता है जिन्हें 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 के डेटा एपीआई में सिर्फ़ ऐटम के सामान्य एलिमेंट का इस्तेमाल किया जाता है. ज़्यादा जानकारी के लिए, ऐटम 1.0 सिंडिकेशन फ़ॉर्मैट की खास जानकारी और ऐटम पब्लिशिंग प्रोटोकॉल देखें.
इस भाग के बाकी हिस्से में ब्लॉगर के लिए कुछ खास नोट और कुछ स्टैंडर्ड एलिमेंट के इस्तेमाल के बारे में बताया गया है.
ड्राफ़्ट एंट्री
ड्राफ़्ट ब्लॉग एंट्री को, ऐटम पब्लिशिंग प्रोटोकॉल के दस्तावेज़ में बताए गए <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 डेटा एपीआई 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>