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

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

कॉन्टेंट

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

सुविधा के बारे में जानकारी

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

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

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

आपका ऐप्लिकेशन, Blogger JSON एपीआई को भेजे जाने वाले हर अनुरोध के लिए, 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 के लिए अनुमति देने की प्रक्रिया या "flow," के बारे में जानकारी अलग-अलग होती है. यह इस बात पर निर्भर करता है कि आप किस तरह का ऐप्लिकेशन लिख रहे हैं. सभी तरह के ऐप्लिकेशन के लिए नीचे दी गई सामान्य प्रक्रिया लागू होती है:

  1. ऐप्लिकेशन बनाने के बाद, उसे Google पर रजिस्टर किया जाता है. इसके बाद, Google आपको क्लाइंट आईडी और क्लाइंट सीक्रेट जैसी जानकारी देगा.
  2. Google API कंसोल के सेवाएं पैनल में, Blogger JSON एपीआई को चालू करें. (अगर यह कंसोल में मौजूद नहीं है, तो यह चरण छोड़ें.)
  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_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 के एपीआई में सभी तरीकों और सभी संसाधनों के साथ किया जा सकता है.

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