डेवलपर की गाइड: प्रोटोकॉल

अहम जानकारी: हम 30 सितंबर, 2024 से Google Data API के वर्शन 2.0 के लिए सहायता बंद कर देंगे. यह पक्का करने के लिए कि सेवाएं काम करती रहें, अपने उन ऐप्लिकेशन को एपीआई के नए वर्शन में अपडेट करें जो Google Data API के v2.0 वर्शन पर निर्भर हैं. नए वर्शन के लिए, बाईं ओर मौजूद नेविगेशन बार में दिए गए लिंक का इस्तेमाल करें. ध्यान दें: कुछ GET अनुरोध (जैसे कि लिस्टिंग पोस्ट), फ़ीड के यूआरएल के तौर पर काम करते रहेंगे. हालांकि, उनके काम करने के तरीके में थोड़े अंतर हैं. ज़्यादा जानकारी के लिए, Blogger सहायता दस्तावेज़ देखें.

Blogger Data API की मदद से, क्लाइंट ऐप्लिकेशन, Google Data API फ़ीड के तौर पर Blogger कॉन्टेंट को देख सकते हैं और उसे अपडेट कर सकते हैं.

आपका क्लाइंट ऐप्लिकेशन, Blogger Data API का इस्तेमाल करके नई ब्लॉग पोस्ट बना सकता है. साथ ही, मौजूदा ब्लॉग पोस्ट में बदलाव कर सकता है या उन्हें मिटा सकता है. इसके अलावा, किसी खास शर्त से मैच होने वाली ब्लॉग पोस्ट के लिए क्वेरी भी कर सकता है.

इस दस्तावेज़ में, Blogger Data API की सुविधाओं के बारे में जानकारी दी गई है. साथ ही, इसमें कच्चे एक्सएमएल और एचटीटीपीएस का इस्तेमाल करके, Data API के बुनियादी इंटरैक्शन के उदाहरण भी दिए गए हैं. इस दस्तावेज़ को पढ़ने के बाद, हो सकता है कि आप क्लाइंट लाइब्रेरी का इस्तेमाल करके, एपीआई के साथ इंटरैक्ट करने के बारे में ज़्यादा जानना चाहें. इसके लिए, डेवलपर गाइड के प्रोग्रामिंग भाषा के हिसाब से बने सेक्शन पढ़ें.

कॉन्टेंट

1. दर्शक
2. शुरू करना
   1. Blogger खाता बनाना
3. अनुरोधों को अनुमति देना
4. किसी वर्शन की जानकारी देना
5. ब्लॉग की सूची हासिल करना
6. पोस्ट बनाना
   1. ब्लॉग पोस्ट पब्लिश करना
   2. ब्लॉग पोस्ट का ड्राफ़्ट बनाना
7. पोस्ट वापस पाना
   1. सभी ब्लॉग पोस्ट वापस लाना
   2. ब्लॉग पोस्ट को फिर से वापस लाना
   3. क्वेरी पैरामीटर का इस्तेमाल करके पोस्ट हासिल करना
8. पोस्ट अपडेट करना
9. पोस्ट मिटाना
10. टिप्पणियां
    1. टिप्पणियां बनाना
    2. टिप्पणियां वापस पाना
    3. टिप्पणियां मिटाना
11. एक्सपोर्ट का फ़ॉर्मैट

ऑडियंस

यह दस्तावेज़ उन प्रोग्रामर के लिए है जो ऐसे क्लाइंट ऐप्लिकेशन लिखना चाहते हैं जो एक्सएमएल और एचटीटीपीएस का इस्तेमाल करके Blogger के साथ इंटरैक्ट कर सकें.

इस दस्तावेज़ में यह माना गया है कि आपको Google Data API प्रोटोकॉल के बारे में सामान्य जानकारी है.

अगर आपने UNIX सिस्टम का इस्तेमाल किया है और आपको कोई कोड लिखे बिना, इस दस्तावेज़ में दिए गए उदाहरणों को आज़माना है, तो आपको UNIX कमांड-लाइन की सुविधाएं curl या wget काम की लग सकती हैं. ज़्यादा जानकारी के लिए, उन सुविधाओं के मैन्युअल पेज देखें.

Blogger Data API के बारे में रेफ़रंस जानकारी के लिए, प्रोटोकॉल रेफ़रंस गाइड देखें.

शुरू करना

Blogger खाता बनाना

टेस्टिंग के लिए, Blogger खाते के लिए साइन अप किया जा सकता है. Blogger, Google खातों का इस्तेमाल करता है. इसलिए, अगर आपके पास पहले से ही Google खाता है, तो आपको कुछ नहीं करना होगा.

अनुरोधों को अनुमति देना

जब आपका ऐप्लिकेशन, उपयोगकर्ता के ऐसे डेटा का अनुरोध करता है जो सार्वजनिक नहीं है, तो उसमें अनुमति वाला टोकन होना चाहिए. इस टोकन से Google आपके ऐप्लिकेशन की पहचान भी करता है.

अनुमति देने के प्रोटोकॉल के बारे में जानकारी

हमारा सुझाव है कि अनुरोधों को अनुमति देने के लिए, OAuth 2.0 का इस्तेमाल करें.

Blogger GData API, अनुमति देने के पुराने विकल्पों के साथ भी काम करता है. जैसे, OAuth 1.0, AuthSub या ClientLogin. हालांकि, ज़्यादातर मामलों में हमारा सुझाव है कि इन अन्य विकल्पों का इस्तेमाल न करें. अगर आपका ऐप्लिकेशन पहले से ही उन विकल्पों का इस्तेमाल करता है, तो हमारा सुझाव है कि अगर हो सके, तो OAuth 2.0 पर माइग्रेट करें.

अगर आपके ऐप्लिकेशन के लिए अनुमति से जुड़ी कुछ असामान्य शर्तें हैं, जैसे कि डेटा ऐक्सेस करने का अनुरोध करते समय लॉग इन करना (हाइब्रिड) या डोमेन के लिए अनुमति देने का अधिकार (2LO), तो फ़िलहाल OAuth 2.0 टोकन का इस्तेमाल नहीं किया जा सकता. ऐसे मामलों में, आपको OAuth 1.0 टोकन का इस्तेमाल करना होगा.

OAuth 2.0 से अनुरोधों को अनुमति देना

Blogger GData API को उपयोगकर्ता के निजी डेटा के लिए किए गए अनुरोधों को, पुष्टि किए गए उपयोगकर्ता की अनुमति लेनी होगी.

OAuth 2.0 के लिए अनुमति देने की प्रक्रिया या "फ़्लो" अलग-अलग हो सकता है. यह इस बात पर निर्भर करता है कि ऐप्लिकेशन किस तरह का है. सभी तरह के ऐप्लिकेशन के लिए, यहां दी गई सामान्य प्रोसेस लागू होती है:

1. ऐप्लिकेशन बनाने के बाद, उसे Google पर रजिस्टर किया जाता है. इसके बाद, Google आपको क्लाइंट आईडी और क्लाइंट सीक्रेट जैसी जानकारी देगा. इस जानकारी की ज़रूरत आपको बाद में पड़ेगी.
2. जब आपके ऐप्लिकेशन को उपयोगकर्ता के डेटा को ऐक्सेस करने की ज़रूरत होती है, तब वह Google से, डेटा के खास दायरे का अनुरोध करता है.
3. Google, उपयोगकर्ता को OAuth डायलॉग बॉक्स दिखाता है. इसमें उनसे आपके ऐप्लिकेशन को उनके कुछ डेटा को ऐक्सेस करने की अनुमति मांगी जाती है.
4. अगर उपयोगकर्ता इसकी अनुमति दे देता है, तो Google आपके ऐप्लिकेशन को कुछ समय के लिए इस्तेमाल किए जा सकने वाला ऐक्सेस टोकन देता है.
5. आपका ऐप्लिकेशन, ऐक्सेस टोकन को अनुरोध से जोड़कर, उपयोगकर्ता के डेटा को ऐक्सेस करने का अनुरोध करता है.
6. अगर Google को पता चलता है कि आपका अनुरोध और टोकन मान्य है, तो वह आपके ऐप्लिकेशन को अनुरोध किया गया डेटा दिखाता है.

कुछ तरीकों में दूसरे चरण भी शामिल हो सकते हैं, जैसे कि रिफ़्रेश टोकन इस्तेमाल करके, नया ऐक्सेस टोकन पाना. अलग-अलग तरह के ऐप्लिकेशन के लिए डेटा ऐक्सेस करने के तरीकों के बारे में ज़्यादा जानकारी पाने के लिए, Google का OAuth 2.0 दस्तावेज़ पढ़ें.

यहां Blogger GData API के लिए, OAuth 2.0 का इस्तेमाल करके अनुमति के लिए अनुरोध करने के बारे में जानकारी दी गई है:

https://www.blogger.com/feeds/

OAuth 2.0 का इस्तेमाल करके डेटा ऐक्सेस करने का अनुरोध करने के लिए, आपके ऐप्लिकेशन को अनुरोध के तरीके की जानकारी देनी होगी. साथ ही, वह जानकारी भी देनी होगी जो आपको ऐप्लिकेशन रजिस्टर करते समय, Google से मिली थी, जैसे कि क्लाइंट आईडी और/या क्लाइंट सीक्रेट.

सलाह: Google API की क्लाइंट लाइब्रेरी, अनुमति देने की कुछ प्रक्रियाएं खुद कर सकती हैं. ये लाइब्रेरी कई प्रोग्रामिंग भाषाओं के लिए उपलब्ध होती हैं. ज़्यादा जानकारी के लिए, लाइब्रेरी और सैंपल वाला पेज देखें.

वर्शन तय करना

Blogger Data API का इस्तेमाल करके भेजे गए हर अनुरोध में, एपीआई के वर्शन 2 की जानकारी होनी चाहिए.

वर्शन नंबर बताने के लिए, GData-Version एचटीटीपी हेडर का इस्तेमाल करें:

GData-Version: 2

इसके अलावा, अगर आपके पास एचटीटीपी हेडर सेट करने का विकल्प नहीं है, तो यूआरएल में v=2 को क्वेरी पैरामीटर के तौर पर सेट किया जा सकता है. हालांकि, जहां भी हो सके वहां एचटीटीपी हेडर का इस्तेमाल करना बेहतर होता है.

ध्यान दें: क्लाइंट लाइब्रेरी, सही वर्शन हेडर अपने-आप उपलब्ध कराती हैं. इसलिए, क्लाइंट लाइब्रेरी का इस्तेमाल करते समय, v=2 क्वेरी पैरामीटर का इस्तेमाल न करें.

ब्लॉग की सूची वापस लाना

Blogger Data API एक ऐसा फ़ीड उपलब्ध कराता है जिसमें किसी उपयोगकर्ता के ब्लॉग की सूची होती है. इस फ़ीड को "मेटाफ़ीड" कहा जाता है.

ब्लॉग की सूची पाने के लिए, यहां दिए गए यूआरएल पर एचटीटीपी GET भेजें:

https://www.blogger.com/feeds/profileID/blogs

यहां प्रोफ़ाइल आईडी, उपयोगकर्ता के प्रोफ़ाइल पेज के यूआरएल में मौजूद नंबर होता है.

ध्यान दें: यूज़र आईडी के लिए default का इस्तेमाल भी किया जा सकता है. इससे Blogger को उस उपयोगकर्ता की ब्लॉग सूची दिखाने के लिए कहा जाता है जिसके क्रेडेंशियल अनुरोध के साथ दिए गए हैं.

मेटाफ़ीड में कोई एंट्री कुछ इस तरह दिख सकती है:

<entry gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'>
  <id>tag:blogger.com,1999:user-userNumber.blog-blogID</id>
  <published>2006-08-02T18:44:43.089-07:00</published>
  <updated>2008-04-17T00:03:33.152-07:00</updated>
  <title>Lizzy's Diary</title>
  <summary type='html'>Being the journal of Elizabeth Bennet</summary>
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/profileID/blogs/blogID' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/' />
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default' />
  ...
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>[e-mail]</email>
  </author>
</entry>

इनमें से हर एलिमेंट का क्या मतलब है, इस बारे में जानने के लिए Google Data APIs प्रोटोकॉल रेफ़रंस दस्तावेज़ या ऐटम 1.0 स्पेसिफ़िकेशन देखें.

अगर किसी वजह से आपका अनुरोध पूरा नहीं हो पाता है, तो हो सकता है कि Blogger कोई दूसरा स्टेटस कोड दिखाए. एचटीटीपी स्टेटस कोड के बारे में ज़्यादा जानकारी, Google Data APIs प्रोटोकॉल रेफ़रंस दस्तावेज़ में भी उपलब्ध है.

पोस्ट बनाना

Blogger Data API की मदद से, नई ब्लॉग एंट्री बनाई और पब्लिश की जा सकती हैं. साथ ही, एंट्री के ड्राफ़्ट भी बनाए जा सकते हैं.

ब्लॉग पोस्ट पब्लिश करना

पुष्टि करने के बाद, नई ब्लॉग एंट्री पब्लिश की जा सकती हैं.

सबसे पहले, पब्लिश करने के लिए पोस्ट का एक्सएमएल वर्शन बनाएं. यह एक्सएमएल, ऐटम <entry> एलिमेंट के तौर पर होना चाहिए. यह ऐसा दिख सकता है:

<entry xmlns='http://www.w3.org/2005/Atom'>
  <title type='text'>Marriage!</title>
  <content type='xhtml'>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p>Mr. Darcy has <em>proposed marriage</em> to me!</p>
      <p>He is the last man on earth I would ever desire to marry.</p>
      <p>Whatever shall I do?</p>
    </div>
  </content>
  <category scheme="http://www.blogger.com/atom/ns#" term="marriage" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
</entry>

ध्यान दें: फ़िलहाल, पोस्ट के लिए कस्टम लेखक सेट करने की सुविधा उपलब्ध नहीं है. सभी नई पोस्ट, इस तरह दिखेंगी जैसे उन्हें पुष्टि किए गए मौजूदा उपयोगकर्ता ने बनाया हो.

इस एंट्री को पब्लिश करने के लिए, इसे ब्लॉग पोस्ट के यूआरएल पर इस तरह भेजें. सबसे पहले, application/atom+xml कॉन्टेंट टाइप का इस्तेमाल करके, अपने नए POST अनुरोध के मुख्य हिस्से में Atom <entry> एलिमेंट डालें. इसके बाद, मेटाफ़ीड में ब्लॉग पोस्ट का यूआरएल ढूंढें. इसके लिए, <link> एलिमेंट ढूंढें, जहां rel एट्रिब्यूट का आखिरी हिस्सा #post है. ब्लॉग पोस्ट का यूआरएल, इस एलिमेंट के href एट्रिब्यूट के तौर पर दिया जाता है. यह यूआरएल इस फ़ॉर्मैट में होता है:

https://www.blogger.com/feeds/blogID/posts/default

ध्यान दें: यह यूआरएल, <link rel="service.post"> टैग में मौजूद यूआरएल से मेल खाता है. यह यूआरएल, ब्लॉग के ऐसे वर्शन के <head> सेक्शन में दिखता है जिसे लोग पढ़ सकते हैं.

Blogger, आपकी भेजी गई एंट्री का इस्तेमाल करके एक ब्लॉग पोस्ट बनाता है. इसके बाद, वह <entry> एलिमेंट के तौर पर नई पोस्ट की कॉपी के साथ-साथ एचटीटीपी 201 CREATED स्टेटस कोड दिखाता है. आपको जो एंट्री दिखेगी वह वही होगी जो आपने भेजी थी. हालांकि, इसमें Blogger के जोड़े गए कई एलिमेंट भी शामिल होंगे. जैसे, <id> एलिमेंट.

अगर किसी वजह से आपका अनुरोध पूरा नहीं हो पाता है, तो हो सकता है कि Blogger कोई दूसरा स्टेटस कोड दिखाए. स्टेटस कोड के बारे में जानकारी के लिए, Google Data API प्रोटोकॉल का रेफ़रंस दस्तावेज़ देखें.

ब्लॉग पोस्ट का ड्राफ़्ट बनाना

ड्राफ़्ट पोस्ट, सार्वजनिक पोस्ट की तरह ही बनाई जाती हैं. हालांकि, एंट्री में <app:control> एलिमेंट जोड़ा जाता है, जिससे पता चलता है कि पोस्ट को अभी पब्लिश नहीं किया जाना चाहिए.

इस <app:control> एलिमेंट में, चाइल्ड के तौर पर एक <app:draft> एलिमेंट होना चाहिए:

<app:control xmlns:app='http://www.w3.org/2007/app'>
  <app:draft>yes</app:draft>
</app:control>

पोस्ट को ड्राफ़्ट के तौर पर पहचानने के लिए, <app:draft> एलिमेंट में मौजूद डेटा, yes स्ट्रिंग होना चाहिए.

किसी मौजूदा ड्राफ़्ट ब्लॉग पोस्ट को पब्लिश की गई पोस्ट में बदला जा सकता है. इसके लिए, ड्राफ़्ट पोस्ट को फिर से पाएं, <app:draft> एलिमेंट के डेटा को स्ट्रिंग no पर सेट करें, और फिर पोस्ट को अपडेट करें. पोस्ट वापस पाने और अपडेट करने के बारे में अगले दो सेक्शन में बताया गया है.

ध्यान दें: <app:control> और <app:draft> नेमस्पेस के साथ-साथ, Atom पब्लिशिंग प्रोटोकॉल के बारे में ज़्यादा जानकारी के लिए, आरएफ़सी 5023 देखें.

पोस्ट वापस लाना

इन सेक्शन में, क्वेरी पैरामीटर के साथ और बिना क्वेरी पैरामीटर के, ब्लॉग पोस्ट की सूची पाने का तरीका बताया गया है.

पुष्टि किए बिना, Blogger के सार्वजनिक फ़ीड से क्वेरी की जा सकती है. इसलिए, किसी सार्वजनिक ब्लॉग से ब्लॉग पोस्ट पाने के लिए, आपको अनुमति पैरामीटर सेट करने की ज़रूरत नहीं है.

सभी ब्लॉग पोस्ट वापस लाना

उपयोगकर्ता की पोस्ट वापस पाने के लिए, ब्लॉग के फ़ीड यूआरएल पर एचटीटीपी GET अनुरोध भेजें. इसके बाद, Blogger एक फ़ीड दिखाता है, जिसमें सही ब्लॉग एंट्री होती हैं. उदाहरण के लिए, [e-mail] के लिए ब्लॉग पोस्ट की सूची पाने के लिए, Blogger को यह एचटीटीपी अनुरोध भेजें. इसमें blogID की जगह, सही वैल्यू डालना न भूलें:

GET https://www.blogger.com/feeds/blogID/posts/default

इसके बाद, Blogger एक एचटीटीपी 200 OK स्टेटस कोड और स्टैंडर्ड Atom 1.0 फ़ीड दिखाता है. इसमें ब्लॉग पोस्ट शामिल होती हैं.

यहां सिर्फ़ एक पोस्ट वाले ब्लॉग के फ़ीड का उदाहरण दिया गया है. ध्यान दें कि हमने इस उदाहरण में थोड़ा बदलाव किया है, ताकि इसे पढ़ने में लोगों को आसानी हो. खास तौर पर, किसी असली Blogger फ़ीड में असल आईडी और यूआरएल होते हैं.

<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet href="http://www.blogger.com/styles/atom.css"
  type="text/css"?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"D08FQn8-eip7ImA9WxZbFEw."'>
  <id>tag:blogger.com,1999:blog-blogID</id>
  <updated>2008-04-17T00:03:33.152-07:00</updated>
  <title>Lizzy's Diary</title>
  <subtitle type='html'></subtitle>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default' />
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/' />
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>[e-mail]</email>
  </author>
  <generator version='7.00'
    uri='http://www2.blogger.com'>Blogger</generator>
  <entry gd:etag='W/"D0YHRn84eip7ImA9WxZUFk8."'>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <published>2008-04-07T20:25:00.005-07:00</published>
    <updated>2008-04-07T20:25:37.132-07:00</updated>
    <title>Quite disagreeable</title>
    <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
      this evening. I found him quite disagreeable.&lt;/p&gt;</content>
    <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID' />
    <link rel='self' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID' />
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2008/04/quite-disagreeable.html' />
    <author>
      <name>Elizabeth Bennet</name>
      <uri>http://www.blogger.com/profile/profileID</uri>
      <email>[e-mail]</email>
    </author>
  </entry>
</feed>

ब्लॉग पोस्ट को फिर से वापस पाना

अगर आपको कोई ऐसी पोस्ट वापस चाहिए जिसे आपने पहले भी वापस पाया है, तो Blogger को यह बताएं कि वह पोस्ट सिर्फ़ तब भेजे, जब पिछली बार पोस्ट वापस पाने के बाद उसमें कोई बदलाव हुआ हो. इससे, पोस्ट वापस पाने की प्रोसेस को बेहतर बनाया जा सकता है.

इस तरह की शर्तों के साथ डेटा वापस पाने के लिए, एचटीटीपी GET अनुरोध भेजें. इसमें एचटीटीपी If-None-Match हेडर शामिल होना चाहिए. हेडर में, एंट्री का ETag डालें. यह आपको <entry> एलिमेंट के gd:etag एट्रिब्यूट में दिखेगा.

उदाहरण के लिए:

If-None-Match: W/"D08FQn8-eil7ImA9WxZbFEw."

जब Blogger को यह अनुरोध मिलता है, तो वह यह देखता है कि आपने जिस एंट्री का अनुरोध किया है उसमें वही ETag है या नहीं जो आपने बताया है. अगर ETag मैच करते हैं, तो इसका मतलब है कि एंट्री में कोई बदलाव नहीं हुआ है. साथ ही, Blogger एचटीटीपी 304 Not Modified स्टेटस कोड दिखाता है.

अगर ETag मेल नहीं खाते हैं, तो इसका मतलब है कि पिछली बार अनुरोध करने के बाद से, एंट्री में बदलाव किया गया है. ऐसे में, Blogger एंट्री दिखाता है.

ईटीएग के बारे में ज़्यादा जानकारी के लिए, Google Data API की रेफ़रंस गाइड देखें.

क्वेरी पैरामीटर का इस्तेमाल करके पोस्ट हासिल करना

Blogger Data API की मदद से, तय की गई शर्तों से मैच करने वाली एंट्री के सेट का अनुरोध किया जा सकता है. जैसे, किसी तारीख की सीमा में पब्लिश या अपडेट की गई ब्लॉग पोस्ट का अनुरोध करना.

उदाहरण के लिए, तारीख की सीमा की क्वेरी भेजने के लिए, अनुरोध यूआरएल में published-min और published-max पैरामीटर जोड़ें. 16 मार्च, 2008 से 24 मार्च, 2008 के बीच बनाई गई सभी ब्लॉग एंट्री पाने के लिए, ब्लॉग के फ़ीड यूआरएल पर HTTP अनुरोध भेजें:

GET https://www.blogger.com/feeds/blogID/posts/default?published-min=2008-03-16T00:00:00&published-max=2008-03-24T23:59:59

GET अनुरोध भेजने पर, Blogger एचटीटीपी 200 OK स्टेटस कोड और एक फ़ीड दिखाता है. इस फ़ीड में, आपकी बताई गई तारीख की सीमा में बनाई गई ब्लॉग पोस्ट शामिल होती हैं.

updated-min और updated-max पैरामीटर का इस्तेमाल, किसी तय सीमा में अपडेट की गई सभी ब्लॉग एंट्री पाने के लिए भी किया जा सकता है. हालांकि, ध्यान दें कि जब तक orderby पैरामीटर को भी updated पर सेट नहीं किया जाता, तब तक इन पैरामीटर को अनदेखा किया जाता है.

Blogger Data API में ये क्वेरी पैरामीटर काम करते हैं:

alt

दिखाया जाने वाला फ़ीड टाइप, जैसे कि atom (डिफ़ॉल्ट) या rss.

/category

फ़ीड के नतीजों को फ़िल्टर करने के लिए, कैटगरी (इन्हें लेबल भी कहा जाता है) तय करता है. उदाहरण के लिए, https://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie से, Fritz और Laurie, दोनों लेबल वाली एंट्री मिलती हैं.

max-results

ज़्यादा से ज़्यादा कितनी एंट्री दिखानी हैं.

orderby

एंट्री को दिखाने का क्रम, जैसे कि lastmodified (डिफ़ॉल्ट), starttime या updated.

published-min, published-max

प्रवेश के पब्लिकेशन की तारीखों की सीमाएं.

start-index

पेजिंग के लिए, खोजे गए पहले नतीजे का इंडेक्स, जो 1 से शुरू होता है.

updated-min, updated-max

डेटा अपडेट करने की तारीखों की सीमा. जब तक orderby पैरामीटर को updated पर सेट नहीं किया जाता, तब तक इन क्वेरी पैरामीटर को अनदेखा किया जाता है.

पाथ

किसी पोस्ट का स्थायी लिंक पाथ. उदाहरण के लिए, जिस पोस्ट का यूआरएल http://buzz.blogger.com/2011/08/bloggers-fresh-new-look.html है उसका पेर्मलिंक पाथ /2011/08/bloggers-fresh-new-look.html है.

q

पूरे टेक्स्ट की क्वेरी स्ट्रिंग. इससे, किसी ब्लॉग में ऐसी पोस्ट खोजी जा सकती हैं जो किसी क्वेरी से मैच करती हों.

क्वेरी पैरामीटर के बारे में ज़्यादा जानने के लिए, Blogger Data API रेफ़रंस गाइड और Google Data API रेफ़रंस गाइड देखें.

पोस्ट अपडेट करना

किसी मौजूदा ब्लॉग पोस्ट को अपडेट करने के लिए, सबसे पहले वह एंट्री पाएं जिसे अपडेट करना है. इसके बाद, उसमें बदलाव करें. इसके बाद, पोस्ट के बदलाव करने के यूआरएल पर, मैसेज के मुख्य हिस्से में अपडेट की गई एंट्री के साथ PUT अनुरोध भेजें. पक्का करें कि आपने PUT जो एंट्री डाली है उसमें <id> की वैल्यू, मौजूदा एंट्री के <id> से पूरी तरह मैच करती हो.

बदलाव करने के लिए यूआरएल, इस एंट्री में हाइलाइट किया गया है:

<entry gd:etag='W/"CUYDSXo8fSp7ImA9WB9UFkU."'>
  <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
  <published>2006-11-08T18:10:00.000-08:00</published>
  <updated>2006-11-08T18:10:14.954-08:00</updated>
  <title type='text'>Quite disagreeable</title>
  <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
    this evening. I found him quite disagreeable.&lt;/p&gt;</content>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default/postID'>
  </link>
  <link rel='edit' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
  </link>
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Bingley" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
  <author>
    <name>Elizabeth Bennet</name>
    <email>[e-mail]</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
</entry>

अहम जानकारी: आने वाले समय में भी एक्सपोर्ट किए गए एक्सएमएल फ़ाइल का इस्तेमाल किया जा सके, इसके लिए पक्का करें कि अपडेट की गई एंट्री को PUT करते समय, Blogger से एंट्री को वापस लाने के समय मौजूद सभी एक्सएमएल को सुरक्षित रखा जाए. ऐसा न करने पर, जब हम नए आइटम लागू करेंगे और फ़ीड में <new-awesome-feature> एलिमेंट शामिल करेंगे, तो आपका क्लाइंट उन्हें वापस नहीं भेजेगा और आपके उपयोगकर्ताओं को ये आइटम नहीं दिखेंगे. Google Data API की क्लाइंट लाइब्रेरी, इस प्रोसेस को सही तरीके से मैनेज करती हैं. इसलिए, अगर इनमें से किसी लाइब्रेरी का इस्तेमाल किया जा रहा है, तो आपको कुछ करने की ज़रूरत नहीं है.

ध्यान दें: फ़िलहाल, पोस्ट से जुड़े लेखक के डेटा में बदलाव नहीं किया जा सकता.

समस्या हल करने के लिए सलाह: कुछ फ़ायरवॉल, एचटीटीपी PUT मैसेज को ब्लॉक करते हैं. इस समस्या से बचने के लिए, POST अनुरोध में X-HTTP-Method-Override: PUT हेडर शामिल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Data API प्रोटोकॉल के बुनियादी सिद्धांत वाला दस्तावेज़ देखें.

पोस्ट मिटाना

किसी पोस्ट को मिटाने के लिए, पोस्ट के बदलाव करने वाले यूआरएल पर DELETE अनुरोध भेजें. यह वही यूआरएल है जिसका इस्तेमाल पोस्ट अपडेट करने के लिए किया जाता है.

समस्या हल करने के लिए सलाह: कुछ फ़ायरवॉल, एचटीटीपी DELETE मैसेज को ब्लॉक करते हैं. इस समस्या से बचने के लिए, POST अनुरोध में X-HTTP-Method-Override: DELETE हेडर शामिल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Data API प्रोटोकॉल के बुनियादी सिद्धांत वाला दस्तावेज़ देखें.

टिप्पणियां

Blogger Data API की मदद से, टिप्पणियां बनाई जा सकती हैं, उन्हें वापस पाया जा सकता है, और उन्हें मिटाया जा सकता है. टिप्पणियों को अपडेट नहीं किया जा सकता. यह सुविधा वेब इंटरफ़ेस में भी उपलब्ध नहीं है.

टिप्पणियां बनाना

टिप्पणी पोस्ट करने के लिए, यहां दिए गए उदाहरण की तरह कोई Atom <entry> एलिमेंट बनाएं:

  <entry xmlns='http://www.w3.org/2005/Atom'>
    <title type="text">This is my first comment</title>
    <content type="html">This is my first comment</content>
  </entry>

इस टिप्पणी को पब्लिश करने के लिए, application/atom+xml कॉन्टेंट टाइप का इस्तेमाल करके, अपने Atom <entry> एलिमेंट को नए POST अनुरोध के मुख्य हिस्से में डालें. इसके बाद, सही Blogger यूआरएल पर POST अनुरोध भेजें:

POST https://www.blogger.com/feeds/blogID/postID/comments/default

ध्यान दें: फ़िलहाल, सिर्फ़ उस ब्लॉग पर टिप्पणी की जा सकती है जिसका मालिकाना हक पुष्टि किए गए उपयोगकर्ता के पास है.

ध्यान दें: फ़िलहाल, टिप्पणियों के लिए कस्टम लेखक सेट करने की सुविधा उपलब्ध नहीं है. सभी नई टिप्पणियां, इस तरह दिखेंगी जैसे कि उन्हें पुष्टि किए गए मौजूदा उपयोगकर्ता ने बनाया हो.

टिप्पणियां वापस लाना

किसी पोस्ट की टिप्पणियां पाने के लिए, इस पोस्ट के टिप्पणियों वाले फ़ीड के यूआरएल पर GET भेजें:

GET https://www.blogger.com/feeds/blogID/postID/comments/default

इसके अलावा, ब्लॉग के टिप्पणियों वाले फ़ीड के यूआरएल का इस्तेमाल करके, सभी पोस्ट की टिप्पणियां देखी जा सकती हैं:

GET https://www.blogger.com/feeds/blogID/comments/default

इन अनुरोधों से, टिप्पणियों का ऐसा फ़ीड मिलता है जो इस तरह दिखता है:

<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet href="http://www.blogger.com/styles/atom.css"
  type="text/css"?>
<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearch/1.1/'
    xmlns:gd='http://schemas.google.com/g/2005'
    gd:etag='W/"CUYMQ348fyp7ImA9WB9UFkU."'>
  <id>tag:blogger.com,1999:blog-blogID.postpostID..comments</id>
  <updated>2007-12-14T17:46:22.077-08:00</updated>
  <title>Comments on Lizzy's Diary: Quite disagreeable</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/postID/comments/default' />
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/postID/comments/default' />
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html' />
  <author>
    <name>Elizabeth Bennet</name>
    <uri>http://www.blogger.com/profile/profileID</uri>
    <email>[e-mail]</email>
  </author>
  <generator version='7.00'
    uri='http://www.blogger.com'>Blogger</generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <entry gd:etag='W/"CUYCQX47eSp7ImA9WB9UFkU."'>
    <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
    <published>2007-12-14T17:46:00.001-08:00</published>
    <updated>2007-12-14T17:46:00.001-08:00</updated>
    <title>Darcy FTW!</title>
    <content type='html'>Darcy FTW!</content>
    <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' />
    <link rel='self' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/postID/comments/default/commentID' />
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html?showComment=1197683160001#ccommentID'
      title='' />
    <author>
      <name>Elizabeth Bennet</name>
      <uri>http://www.blogger.com/profile/profileID</uri>
      <email>[e-mail]</email>
    </author>
    <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0'
      href='http://blogName.blogspot.com/2007/12/quite-disagreeable_5283.html'
      ref='tag:blogger.com,1999:blog-blogID.post-postID'
      source='http://www.blogger.com/feeds/blogID/posts/default/postID'
      type='text/html' />
  </entry>
</feed>

टिप्पणियां मिटाना

किसी टिप्पणी को मिटाने के लिए, टिप्पणी में बदलाव करने के यूआरएल पर DELETE अनुरोध भेजें. यह यूआरएल, ऊपर दिए गए टिप्पणियों के फ़ीड में हाइलाइट किया गया है.

एक्सपोर्ट फ़ॉर्मैट

Blogger, उपयोगकर्ताओं को Blogger एक्सपोर्ट फ़ाइल का इस्तेमाल करके, अपने ब्लॉग एक्सपोर्ट और इंपोर्ट करने की सुविधा देता है. इस एक्सपोर्ट फ़ाइल में, एक ब्लॉग की सभी पोस्ट और टिप्पणियां शामिल होती हैं. एक्सपोर्ट की गई फ़ाइल का फ़ॉर्मैट, वही Atom फ़ॉर्मैट होता है जिसके बारे में पोस्ट और टिप्पणियों को वापस पाने के सेक्शन में बताया गया है. इस एक्सपोर्ट फ़ाइल में, एक ही दस्तावेज़ में पोस्ट फ़ीड और टिप्पणियों के फ़ीड का कॉन्टेंट शामिल होगा.

एक्सपोर्ट फ़ॉर्मैट का इस्तेमाल करके, ब्लॉग डेटा को एक्सपोर्ट या इंपोर्ट करने के लिए, ब्लॉग के सेटिंग पेज पर जाएं. Data API का इस्तेमाल करके, किसी ब्लॉग की एक्सपोर्ट फ़ाइल वापस पाने के लिए, इस यूआरएल का इस्तेमाल करें:

GET https://www.blogger.com/feeds/blogID/archive

एक्सपोर्ट की गई फ़ाइल को इंपोर्ट करने के लिए, यहां दिए गए यूआरएल पर POST अनुरोध करें. अनुरोध के डेटा के तौर पर, एक्सपोर्ट की गई फ़ाइल का कॉन्टेंट और कॉन्टेंट टाइप के तौर पर application/atom+xml डालें:

POST https://www.blogger.com/feeds/blogID/archive/full

ऊपर दिए गए यूआरएल में, क्वेरी पैरामीटर काम नहीं करते. दोनों अनुरोधों में पुष्टि की जानकारी भी होनी चाहिए. साथ ही, सिर्फ़ ब्लॉग एडमिन इन फ़ीड यूआरएल का इस्तेमाल करके ब्लॉग को इंपोर्ट/एक्सपोर्ट कर पाएंगे.

ध्यान दें: अगर आपने Blogger से अपनी एक्सपोर्ट फ़ाइल बनाई है, तो फ़िलहाल पोस्ट और टिप्पणी की एंट्री के क्रम से जुड़ी एक पाबंदी है. Blogger एक्सपोर्ट फ़ाइल में सबसे पहले सभी पोस्ट और फिर सभी टिप्पणियां दिखेंगी. पोस्ट और टिप्पणी की एंट्री को एक-दूसरे के बीच में डालने की अनुमति तब तक है, जब तक टिप्पणी की एंट्री उस पोस्ट के बाद आती है जिस पर टिप्पणी की गई है.

एक्सपोर्ट फ़ाइल में Blogger, एटम फ़ॉर्मैट का इस्तेमाल कैसे करता है, इस बारे में ज़्यादा जानने के लिए, प्रोटोकॉल रेफ़रंस गाइड देखें.

वापस सबसे ऊपर जाएं