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

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

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

विषय सूची

  1. शुरुआती जानकारी
    1. अनुरोधों को अनुमति देना और अपने ऐप्लिकेशन की पहचान करना
  2. ब्लॉग पर काम करना
    1. किसी ब्लॉग को वापस लाना
    2. किसी उपयोगकर्ता का ब्लॉग फिर से पाना
  3. पोस्ट के साथ काम करना
    1. किसी ब्लॉग के लिए पोस्ट पाना
    2. कोई खास पोस्ट वापस पाना
  4. टिप्पणियों की मदद से काम करना
    1. किसी पोस्ट के लिए टिप्पणियां वापस पाना
    2. कोई खास टिप्पणी वापस पाना
  5. पेजों पर काम करना
    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 एपीआई, डेटा ऐक्सेस (हाइब्रिड) या पूरे डोमेन पर अधिकार देने (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 को किए जाने वाले अनुरोधों के साथ एक आइडेंटिफ़ायर होना ज़रूरी है. यह आइडेंटिफ़ायर, एपीआई पासकोड या पुष्टि करने वाला टोकन हो सकता है.

एपीआई पासकोड पाने के लिए, एपीआई कंसोल पर जाएं. सेवा पैनल में, [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 अनुरोध भेजकर, ब्लॉग से किसी खास पेज को वापस पाया जा सकता है. पेज संसाधन का यूआरआई इस फ़ॉर्मैट में होता है:

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 के सभी एपीआई की कार्रवाइयों पर लागू होने वाले क्वेरी पैरामीटर को सिस्टम पैरामीटर में दर्ज किया गया है.