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

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

इस दस्तावेज़ में, 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 का इस्तेमाल होना चाहिए का इस्तेमाल करें. अनुमति देने वाले दूसरे प्रोटोकॉल इस्तेमाल नहीं किए जा सकते.

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

एपीआई पासकोड पाने के लिए, एपीआई कंसोल पर जाएं. सेवाओं में पैनल में, [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

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

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 */

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

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 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

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

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

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

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

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

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

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

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