अहम जानकारी: हम 30 सितंबर, 2024 से, Google Data API के 2.0 वर्शन के साथ काम करना बंद कर देंगे. काम करते रहने के लिए, उन ऐप्लिकेशन को अपडेट करें जो v2.0 Google Data API का इस्तेमाल करके, एपीआई के नए वर्शन पर काम करते हैं. सबसे नए वर्शन के लिए, बाईं ओर के नेविगेशन बार में दिए गए लिंक का इस्तेमाल करें. ध्यान दें: कुछ जीईटी अनुरोध (जैसे कि लिस्टिंग पोस्ट), फ़ीड के यूआरएल के तौर पर काम करते रहेंगे. हालांकि, उनके काम करने के तरीके में मामूली अंतर होगा. ज़्यादा जानकारी के लिए, Blogger के सहायता केंद्र का दस्तावेज़ देखें.
इस दस्तावेज़ में Blogger Data API के लिए रॉ प्रोटोकॉल (एक्सएमएल और एचटीटीपी) के बारे में ज़्यादा जानकारी देने वाला दस्तावेज़ दिया गया है.
इस दस्तावेज़ में प्रोग्रामिंग-भाषा की क्लाइंट लाइब्रेरी के बारे में जानकारी नहीं है. क्लाइंट-लाइब्रेरी के लिए रेफ़रंस जानकारी के लिए, डेवलपर की गाइड में प्रोग्रामिंग की भाषा वाले सेक्शन में दिए गए लिंक देखें.
विषय सूची
दर्शक
यह दस्तावेज़ उन प्रोग्रामर के लिए है जो ऐसे क्लाइंट ऐप्लिकेशन लिखना चाहते हैं जो Blogger से इंटरैक्ट कर सकें.
यह एक पहचान दस्तावेज़ है. इसमें यह माना जाता है कि आपको डेवलपर की गाइड में बताए गए सिद्धांतों और Google Data API प्रोटोकॉल से जुड़े सामान्य आइडिया की समझ है.
Blogger फ़ीड के टाइप
Blogger, फ़ीड में ब्लॉग कॉन्टेंट को दो तरह से दिखाता है: पूरे फ़ीड और खास जानकारी वाले फ़ीड. पूरे फ़ीड में सभी ब्लॉग पोस्ट मौजूद होती हैं, जबकि समरी फ़ीड में हर पोस्ट का सिर्फ़ एक छोटा स्निपेट होता है.
ब्लॉग का मालिक जीयूआई सेटिंग का इस्तेमाल करके यह बता सकता है कि ब्लॉग, सिंडिकेटर और एग्रीगेटर को पूरा फ़ीड उपलब्ध कराता है या समरी फ़ीड.
जब आपका क्लाइंट ऐप्लिकेशन, किसी फ़ीड के लिए बिना पुष्टि वाला अनुरोध भेजता है, तो उसे ब्लॉग के मालिक की ओर से तय किए गए किसी भी तरह के फ़ीड मिल जाते हैं.
जब आपका क्लाइंट ऐप्लिकेशन पुष्टि किया गया अनुरोध भेजता है, तो उसे हमेशा पूरा फ़ीड मिलता है. इससे कोई फ़र्क़ नहीं पड़ता कि ब्लॉग के मालिक ने क्या बताया है.
Blogger क्वेरी पैरामीटर का रेफ़रंस
Blogger Data API करीब-करीब सभी स्टैंडर्ड Google Data API क्वेरी पैरामीटर के साथ काम करता है.
Blogger पर 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 सिंडिकेशन फ़ॉर्मैट की खास बातें और ऐटम पब्लिशिंग प्रोटोकॉल देखें.
इस हिस्से के बाकी हिस्से में, कुछ स्टैंडर्ड एलिमेंट के इस्तेमाल के बारे में कुछ खास जानकारी दी गई है.
ड्राफ़्ट एंट्री
एक ड्राफ़्ट ब्लॉग एंट्री को ऐटम पब्लिशिंग प्रोटोकॉल दस्तावेज़ में बताए गए <app:draft>
एक्सटेंशन एलिमेंट का इस्तेमाल करके मार्क किया जाता है. यहां ड्राफ़्ट एंट्री का एक उदाहरण दिया गया है:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
अगर कोई <draft> एलिमेंट नहीं दिया गया है, तो इसका मतलब है कि एंट्री, ड्राफ़्ट नहीं है.
पब्लिकेशन की तारीखें और अपडेट की गई तारीखें
स्टैंडर्ड ऐटम <published> एलिमेंट में दिया गया टाइमस्टैंप, "पोस्ट करने की तारीख" से मेल खाता है, जिसे उपयोगकर्ता Blogger जीयूआई में सेट कर सकता है.
जब आपका क्लाइंट नई एंट्री बनाता है और क्लाइंट <published> के लिए कोई वैल्यू नहीं तय करता है, तो Blogger एंट्री पोस्ट करने की तारीख को सर्वर के मौजूदा समय पर सेट कर देता है. जब आपका क्लाइंट किसी एंट्री में बदलाव करता है, लेकिन <published> वैल्यू नहीं देता है, तो Blogger एंट्री पोस्ट करने की तारीख को सिर्फ़
ही छोड़ देता है.
हालांकि, अगर आपका क्लाइंट एंट्री बनाते या उसमें बदलाव करते समय, <published> एलिमेंट के लिए कोई वैल्यू तय करता है, तो Blogger एंट्री पोस्ट करने की तारीख को तय की गई वैल्यू पर सेट कर देता है. यह किसी दूसरे ब्लॉगिंग सिस्टम से पुरानी एंट्री इंपोर्ट करने (मूल कॉन्टेंट बनाने की तारीखों को बनाए रखते हुए) जैसे कामों के लिए मददगार हो सकता है.
Blogger, स्टैंडर्ड ऐटम <updated> एलिमेंट का इस्तेमाल यह बताने के लिए करता है कि किसी एंट्री को पिछली बार कब बदला गया था. आपका क्लाइंट <updated> वैल्यू को कंट्रोल नहीं कर सकता. Blogger हमेशा एंट्री की आखिरी बार अपडेट की गई तारीख को सर्वर के मौजूदा समय पर सेट करता है. ऐसा तब होता है, जब आपका क्लाइंट किसी एंट्री को पोस्ट करता है या उसमें बदलाव करता है.
स्टैंडर्ड Google Data API published-min,
published-max, updated-min, और
updated-max क्वेरी पैरामीटर का इस्तेमाल करके, उनकी <published> या <updated> वैल्यू के आधार पर एंट्री का अनुरोध किया जा सकता है. हालांकि,
अपडेट की गई तारीखों के बारे में क्वेरी करने की जानकारी के लिए, 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/opensearch/1.1/"
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 comment</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>