Blogger JSON API: एपीआई इस्तेमाल करना

अहम जानकारी: हम 30 सितंबर, 2024 से JSON API के वर्शन 2.0 के लिए सहायता बंद कर देंगे. यह पक्का करने के लिए कि सेवाएं काम करती रहें, अपने उन ऐप्लिकेशन को एपीआई के नए वर्शन पर अपडेट करें जो JSON API के 2.0 वर्शन पर निर्भर हैं. नए वर्शन के लिए, बाईं ओर मौजूद नेविगेशन बार में दिए गए लिंक का इस्तेमाल करें.

इस दस्तावेज़ में, RESTful कॉलिंग स्टाइल का इस्तेमाल करके Blogger JSON API की सामान्य सुविधाओं को इस्तेमाल करने का तरीका बताया गया है.

सामग्री

  1. बुनियादी जानकारी
    1. अनुरोधों को अनुमति देना और अपने ऐप्लिकेशन की पहचान करना
  2. ब्लॉग के साथ काम करना
    1. ब्लॉग वापस पाना
    2. किसी उपयोगकर्ता के ब्लॉग वापस लाना
  3. पोस्ट के साथ काम करना
    1. किसी ब्लॉग की पोस्ट वापस लाना
    2. किसी खास पोस्ट को वापस लाना
  4. टिप्पणियों के साथ काम करना
    1. किसी पोस्ट पर की गई टिप्पणियां देखना
    2. किसी खास टिप्पणी को वापस पाना
  5. Pages का इस्तेमाल करना
    1. ब्लॉग के पेज वापस पाना
    2. किसी खास पेज को वापस लाना
  6. उपयोगकर्ताओं के साथ काम करना
    1. किसी उपयोगकर्ता को वापस लाना
  7. स्टैंडर्ड क्वेरी पैरामीटर

परिचय

यह दस्तावेज़ उन डेवलपर के लिए है जो ऐसे ऐप्लिकेशन बनाना चाहते हैं जो Blogger JSON API के साथ इंटरैक्ट कर सकें. Blogger, वेबसाइटें बनाने के लिए एक टूल है. इसकी मदद से, लोग अपने विचारों को लगातार पब्लिश कर सकते हैं.

अगर आपको Blogger के कॉन्सेप्ट के बारे में नहीं पता है, तो कोडिंग शुरू करने से पहले शुरू करना लेख पढ़ें.

अनुरोधों को अनुमति देना और अपने ऐप्लिकेशन की पहचान करना

आपका ऐप्लिकेशन, Blogger JSON API को जो भी अनुरोध भेजता है उसमें Google को आपके ऐप्लिकेशन की पहचान करनी होगी. अपने ऐप्लिकेशन की पहचान करने के दो तरीके हैं: OAuth 2.0 टोकन का इस्तेमाल करना (जो अनुरोध को भी अनुमति देता है) और/या ऐप्लिकेशन की एपीआई कुंजी का इस्तेमाल करना. इनमें से किस विकल्प का इस्तेमाल करना है, यह तय करने का तरीका यहां बताया गया है:

  • अगर अनुरोध को अनुमति की ज़रूरत है, जैसे कि किसी व्यक्ति के निजी डेटा के लिए अनुरोध, तो ऐप्लिकेशन को अनुरोध के साथ OAuth 2.0 टोकन देना होगा. ऐप्लिकेशन में एपीआई पासकोड भी दिया जा सकता है, लेकिन ऐसा करना ज़रूरी नहीं है.
  • अगर अनुरोध के लिए अनुमति की ज़रूरत नहीं है, जैसे कि सार्वजनिक डेटा का अनुरोध, तो ऐप्लिकेशन को एपीआई पासकोड या OAuth 2.0 टोकन या दोनों में से कोई एक देना होगा. आपके लिए जो विकल्प सबसे सही हो उसे चुनें.

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

अनुरोधों को अनुमति देने के लिए, आपके ऐप्लिकेशन में OAuth 2.0 का इस्तेमाल किया जाना चाहिए. अनुमति देने वाले दूसरे प्रोटोकॉल इस्तेमाल नहीं किए जा सकते.

ध्यान दें: फ़िलहाल, Blogger JSON API में डेटा ऐक्सेस (हाइब्रिड) या डोमेन के लिए अनुमति देने (2LO) का अनुरोध करते समय, लॉग इन करने की सुविधा काम नहीं करती.

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

Blogger JSON API को उपयोगकर्ता के ऐसे डेटा के लिए अनुरोध करने के लिए, अनुमति किसी ऐसे उपयोगकर्ता को देनी चाहिए जिसके पास ऐसा करने का अधिकार हो.

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

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

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

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

https://www.googleapis.com/auth/blogger

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

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

एपीआई पासकोड हासिल करना और उसका इस्तेमाल करना

सार्वजनिक डेटा के लिए Blogger JSON API के अनुरोधों के साथ, एक आइडेंटिफ़ायर होना चाहिए. यह एपीआई पासकोड या पुष्टि करने वाला टोकन हो सकता है.

एपीआई पासकोड पाने के लिए, APIs Console पर जाएं. सेवाओं के पैनल में, [api_name] को चालू करें. अगर सेवा की शर्तें दिखती हैं, तो उन्हें पढ़ें और स्वीकार करें.

इसके बाद, एपीआई ऐक्सेस पैनल पर जाएं. एपीआई पासकोड, उस पैनल के सबसे नीचे मौजूद "सिंपल एपीआई ऐक्सेस" सेक्शन में होता है.

एपीआई पासकोड मिलने के बाद, आपका ऐप्लिकेशन सभी अनुरोध यूआरएल में क्वेरी पैरामीटर key=yourAPIKey जोड़ सकता है.

एपीआई पासकोड को यूआरएल में जोड़ना सुरक्षित है. इसे कोड में बदलने की ज़रूरत नहीं है.

ब्लॉग के साथ काम करना

ब्लॉग वापस लाना

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

https://www.googleapis.com/blogger/v2/blogs/blogId

अनुरोध

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

GET https://www.googleapis.com/blogger/v2/blogs/2399953&key=YOUR-API-KEY

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

Blogger पर निजी ब्लॉग भी होते हैं. इनके लिए पुष्टि करना ज़रूरी होता है.

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड और ब्लॉग का डेटा दिखाता है:

200 OK

{
  "kind": "blogger#blog",
  "id": "2399953",
  "name": "Blogger Buzz",
  "description": "The Official Buzz from Blogger at Google",
  "published": "2007-04-23T22:17:29.261Z",
  "updated": "2011-08-02T06:01:15.941Z",
  "url": "http://buzz.blogger.com/",
  "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

किसी उपयोगकर्ता के ब्लॉग वापस लाना

ब्लॉग कलेक्शन के यूआरआई पर एचटीटीपी GET अनुरोध भेजकर, किसी उपयोगकर्ता के ब्लॉग की सूची देखी जा सकती है:

https://www.googleapis.com/blogger/v2/users/userId/blogs

अनुरोध

यहां GET अनुरोध का एक उदाहरण दिया गया है, जिसमें उपयोगकर्ता के ब्लॉग की सूची दी गई है:

GET https://www.googleapis.com/blogger/v2/users/self/blogs
Authorization: /* OAuth 2.0 token here */

ध्यान दें: उपयोगकर्ता को अपने ब्लॉग की सूची दिखाने के लिए पुष्टि करनी होगी. इसलिए, आपको GET अनुरोध के साथ Authorization एचटीटीपी हेडर देना होगा.

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड के साथ जवाब देता है. साथ ही, उपयोगकर्ता के ब्लॉग की पूरी सूची दिखाता है:

200 OK

{
  "kind": "blogger#blogList",
  "items": [
    {
      "kind": "blogger#blog",
      "id": "4967929378133675647",
      "name": "Brett's Test Blawg",
      "description": "",
      "published": "2010-10-06T23:33:31.662Z",
      "updated": "2011-08-08T06:50:02.005Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/",
      "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

पोस्ट के साथ काम करना

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

किसी ब्लॉग से पोस्ट की सूची पाने के लिए, पोस्ट के कलेक्शन के यूआरआई पर GET अनुरोध भेजें. पोस्ट के कलेक्शन का यूआरआई इस फ़ॉर्मैट में होता है:

https://www.googleapis.com/blogger/v2/blogs/blogId/posts

अनुरोध

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

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts&key=YOUR-API-KEY

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

Blogger पर निजी ब्लॉग भी होते हैं. इनके लिए पुष्टि करना ज़रूरी होता है.

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड और पोस्ट की सूची के साथ जवाब देता है:

200 OK

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "prevPageToken": "CgkIChDBwrK3mCYQ0b2SAQ",
  "items": [
    {
      "kind": "blogger#post",
      "id": "7706273476706534553",
      "blog": {
        "id": "2399953"
      },
      "published": "2011-08-01T19:58:00.000Z",
      "updated": "2011-08-01T19:58:51.947Z",
      "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
      "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts/7706273476706534553",
      "title": "Latest updates, August 1st",
      "content": "elided for readability",
      "author": {
        "id": "401465483996",
        "displayName": "Brett Wiltshire",
        "url": "http://www.blogger.com/profile/01430672582309320414",
        "image": {
          "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
         }
      },
      "replies": {
        "totalItems": "0",
        "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

किसी खास पोस्ट को वापस लाना

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

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId

अनुरोध

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

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/7706273476706534553&key=YOUR-API-KEY

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

Blogger पर निजी ब्लॉग भी होते हैं. इनके लिए पुष्टि करना ज़रूरी होता है.

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड और पोस्ट का कॉन्टेंट दिखाता है:

200 OK

{
  "kind": "blogger#post",
  "id": "7706273476706534553",
  "blog": {
    "id": "2399953"
  },
  "published": "2011-08-01T19:58:00.000Z",
  "updated": "2011-08-01T19:58:51.947Z",
  "url": "http://buzz.blogger.com/2011/08/latest-updates-august-1st.html",
  "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts/7706273476706534553",
  "title": "Latest updates, August 1st",
  "content": "elided for readability",
  "author": {
    "id": "401465483996",
    "displayName": "Brett Wiltshire",
    "url": "http://www.blogger.com/profile/01430672582309320414",
    "image": {
      "url": "http://4.bp.blogspot.com/_YA50adQ-7vQ/S1gfR_6ufpI/AAAAAAAAAAk/1ErJGgRWZDg/S45/brett.png"
    }
  },
  "replies": {
    "totalItems": "0",
    "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts/7706273476706534553/comments"
  }
}

टिप्पणियों के साथ काम करना

किसी पोस्ट पर की गई टिप्पणियां वापस पाना

किसी पोस्ट पर की गई टिप्पणियों की सूची पाने के लिए, टिप्पणियों के कलेक्शन के यूआरआई पर GET अनुरोध भेजें. टिप्पणियों के कलेक्शन का यूआरआई, इस फ़ॉर्मैट में होता है:

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments

अनुरोध

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

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments&key=YOUR-API-KEY

सार्वजनिक ब्लॉग से टिप्पणियां पाने के लिए, उपयोगकर्ता को पुष्टि करने की ज़रूरत नहीं होती. इसलिए, आपको इस GET अनुरोध के साथ Authorization एचटीटीपी हेडर नहीं देना होगा. हालांकि, अगर आपने वह हेडर नहीं दिया है, तो आपको एपीआई पासकोड देना होगा.

Blogger पर निजी ब्लॉग भी होते हैं. इनके लिए पुष्टि करना ज़रूरी होता है.

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड और टिप्पणियों की सूची के साथ जवाब देता है:

200 OK

{
  "kind": "blogger#commentList",
  "nextPageToken": "CgkIFBDwjvDXlyYQ0b2SARj9mZe9n8KsnlQ",
  "prevPageToken": "CgkIFBisvMGRlyYQ0b2SARj9mZe9n8KsnlQ",
  "items": [
    {
       "kind": "blogger#comment",
       "id": "9200761938824362519",
       "post": {
         "id": "6069922188027612413"
       },
       "blog": {
         "id": "2399953"
       },
       "published": "2011-07-28T19:19:57.740Z",
       "updated": "2011-07-28T21:29:42.015Z",
       "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
       "content": "elided",
       "author": {
         "id": "530579030283",
         "displayName": "elided",
         "url": "elided",
         "image": {
           "url": "elided"
         }
       }
    },
    {
      "kind": "blogger#comment",
      "id": "400101178920857170",
      elided for readability
    }
  ]
}

किसी खास टिप्पणी को वापस पाना

किसी पोस्ट से किसी खास टिप्पणी को वापस पाने के लिए, टिप्पणियों के संसाधन के यूआरआई पर GET अनुरोध भेजें. टिप्पणियों वाले संसाधन का यूआरआई इस फ़ॉर्मैट में होता है:

https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments/commentId

अनुरोध

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

GET https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519&key=YOUR-API-KEY

सार्वजनिक ब्लॉग से टिप्पणियां पाने के लिए, उपयोगकर्ता को पुष्टि करने की ज़रूरत नहीं होती. इसलिए, आपको इस GET अनुरोध के साथ Authorization एचटीटीपी हेडर नहीं देना होगा. हालांकि, अगर आपने वह हेडर नहीं दिया है, तो आपको एपीआई पासकोड देना होगा.

Blogger पर निजी ब्लॉग भी होते हैं. इनके लिए पुष्टि करना ज़रूरी होता है.

जवाब

अगर अनुरोध पूरा हो जाता है, तो सर्वर एचटीटीपी 200 OK स्टेटस कोड और टिप्पणी का डेटा दिखाता है:

200 OK

{
  "kind": "blogger#comment",
  "id": "9200761938824362519",
  "post": {
    "id": "6069922188027612413"
  },
  "blog": {
    "id": "2399953"
  },
  "published": "2011-07-28T19:19:57.740Z",
  "updated": "2011-07-28T21:29:42.015Z",
  "selfLink": "https://www.googleapis.com/blogger/v2/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

पेजों के साथ काम करना

किसी ब्लॉग के पेज वापस लाना

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

https://www.googleapis.com/blogger/v2/blogs/blogId/pages

अनुरोध

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

GET https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages&key=YOUR-API-KEY

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

Blogger पर निजी ब्लॉग भी होते हैं. इनके लिए पुष्टि करना ज़रूरी होता है.

जवाब

अगर अनुरोध पूरा हो जाता है, तो सर्वर एचटीटीपी 200 OK स्टेटस कोड और पेजों की सूची के साथ जवाब देता है:

200 OK

{
  "kind": "blogger#pageList",
  "items": [
    {
      "kind": "blogger#page",
      "id": "273541696466681878",
      "blog": {
        "id": "4967929378133675647"
      },
      "published": "2011-07-14T16:16:00.000Z",
      "updated": "2011-07-14T16:16:23.602Z",
      "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
      "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages/273541696466681878",
      "title": "Static Content",
      "content": "elided for readability",
      "author": {
        "id": "901569848744",
        "displayName": "brett",
        "url": "http://www.blogger.com/profile/16258312240222542576",
        "image": {
          "url": "https://resources.blogblog.com/img/b16-rounded.gif"
        }
      }
    }
  ]
}

किसी खास पेज को वापस लाना

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

https://www.googleapis.com/blogger/v2/blogs/blogId/pages/pageId

अनुरोध

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

GET https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages/273541696466681878&key=YOUR-API-KEY

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

Blogger पर निजी ब्लॉग भी होते हैं. इनके लिए पुष्टि करना ज़रूरी होता है.

जवाब

अगर अनुरोध पूरा हो जाता है, तो सर्वर एचटीटीपी 200 OK स्टेटस कोड और पेज का डेटा दिखाकर जवाब देता है:

200 OK

{
  "kind": "blogger#page",
  "id": "273541696466681878",
  "blog": {
    "id": "4967929378133675647"
  },
  "published": "2011-07-14T16:16:00.000Z",
  "updated": "2011-07-14T16:16:23.602Z",
  "url": "http://brettmorgan-test-blawg.blogspot.com/p/static-content.html",
  "selfLink": "https://www.googleapis.com/blogger/v2/blogs/4967929378133675647/pages/273541696466681878",
  "title": "Static Content",
  "content": "elided for readability",
  "author": {
    "id": "901569848744",
    "displayName": "brett",
    "url": "http://www.blogger.com/profile/16258312240222542576",
    "image": {
      "url": "https://resources.blogblog.com/img/b16-rounded.gif"
    }
  }
}

उपयोगकर्ताओं के साथ काम करना

किसी उपयोगकर्ता को वापस लाना

उपयोगकर्ताओं के संसाधन के यूआरआई पर एचटीटीपी GET अनुरोध भेजकर, उपयोगकर्ता की जानकारी हासिल की जा सकती है:

https://www.googleapis.com/blogger/v2/users/userId

अनुरोध

यहां GET अनुरोध का एक उदाहरण दिया गया है, जिसमें उपयोगकर्ता के ब्लॉग की सूची दी गई है:

GET https://www.googleapis.com/blogger/v2/users/self
Authorization: /* OAuth 2.0 token here */

ध्यान दें: अपनी जानकारी दिखाने के लिए, उपयोगकर्ता की पुष्टि ज़रूरी है. इसलिए, आपको GET अनुरोध के साथ Authorization एचटीटीपी हेडर देना होगा.

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड और उपयोगकर्ता के ब्लॉग की सूची के लिंक के साथ जवाब देता है:

200 OK

{
  "kind": "blogger#user",
  "id": "901569848744",
  "selfLink": "https://www.googleapis.com/blogger/v2/users/901569848744",
  "blogs": {
    "selfLink": "https://www.googleapis.com/blogger/v2/users/901569848744/blogs"
  }
}

स्टैंडर्ड क्वेरी पैरामीटर

नीचे दिए गए क्वेरी पैरामीटर का इस्तेमाल, Blogger API के सभी तरीकों और सभी संसाधनों के साथ किया जा सकता है.

Blogger API के सभी ऑपरेशन पर लागू होने वाले क्वेरी पैरामीटर, सिस्टम पैरामीटर में दिए गए हैं.