इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

Blogger API की मदद से, REST API का इस्तेमाल करके, Blogger के कॉन्टेंट को आपके ऐप्लिकेशन के साथ इंटिग्रेट किया जा सकता है. शुरू करने से पहले, आपको अनुमति देने की सुविधा सेट अप करनी होगी.

शुरुआती जानकारी

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

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

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

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

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

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

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

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

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

यह प्रोसेस, OAuth क्लाइंट आईडी की मदद से की जाती है.

या क्रेडेंशियल पेज में जाकर क्रेडेंशियल बनाएं.

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

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

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

Blogger API के लिए, OAuth 2.0 के दायरे की जानकारी यहां दी गई है:

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

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

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

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

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

या क्रेडेंशियल पेज में जाकर क्रेडेंशियल बनाएं.

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

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

ब्लॉग पर काम करना

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

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

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

अनुरोध

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

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

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

जवाब

अनुरोध पूरा होने पर, सर्वर एक एचटीटीपी 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/v3/blogs/2399953",
  "posts": {
    "totalItems": 494,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/posts"
  },
  "pages": {
    "totalItems": 2,
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/2399953/pages"
  },
  "locale": {
    "language": "en",
    "country": "",
    "variant": ""
  }
}

किसी ब्लॉग को उसके यूआरएल की मदद से वापस पाना

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

https://www.googleapis.com/blogger/v3/blogs/byurl?url=blog-url

अनुरोध

https://www.googleapis.com/blogger/v3/blogs/byurl?url=http://code.blogger.com/

जवाब

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

{
 "kind": "blogger#blog",
 "id": "3213900",
 "name": "Blogger Developers Network",
 "description": "The official Blogger Developers Network weblog.",
 "published": "2007-02-09T10:13:10-08:00",
 "updated": "2012-04-15T19:38:01-07:00",
 "url": "http://code.blogger.com/",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900",
 "posts": {
  "totalItems": 55,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts"
 },
 "pages": {
  "totalItems": 1,
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/pages"
 },
 "locale": {
  "language": "en",
  "country": "US",
  "variant": ""
 }
}

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

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

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

अनुरोध

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

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

जवाब

अनुरोध पूरा होने पर, सर्वर एक एचटीटीपी 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/v3/blogs/4967929378133675647",
      "posts": {
        "totalItems": 13,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/posts"
      },
      "pages": {
        "totalItems": 1,
        "selfLink": "https://www.googleapis.com/blogger/v3/blogs/4967929378133675647/pages"
      },
      "locale": {
        "language": "en",
        "country": "",
        "variant": ""
      }
    }
  ]
}

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

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

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

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

अनुरोध

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

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

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

जवाब

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

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAkceVjiYQ0b2SAQ",
  "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/v3/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/v3/blogs/2399953/posts/7706273476706534553/comments"
      }
    },
    {
      "kind": "blogger#post",
      "id": "6069922188027612413",
      elided for readability
    }
  ]
}

कोई विशिष्ट पोस्ट पुनर्प्राप्त करना

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

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

अनुरोध

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

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

जवाब

अनुरोध पूरा होने पर सर्वर, एचटीटीपी 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/v3/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/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

पोस्ट खोजी जा रही है

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

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search?q=query terms

अनुरोध

GET https://www.googleapis.com/blogger/v3/blogs/3213900/posts/search?q=documentation&key=YOUR-API-KEY

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

जवाब

{
  "kind": "blogger#postList",
  "nextPageToken": "CgkIChiAj86CpB8QzJTEAQ",
  "items": [
  {
    "kind": "blogger#post",
    "id": "1387873546480002228",
    "blog": {
      "id": "3213900"
    },
    "published": "2012-03-23T01:58:00-07:00",
    "updated": "2012-03-23T01:58:12-07:00",
    "url": "http://code.blogger.com/2012/03/blogger-documentation-has-moved-to.html",
    "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228",
    "title": "Blogger Documentation has moved to developers.google.com",
    "content": "content elided for readability",
    "author": {
      "id": "16258312240222542576",
      "displayName": "Brett Morgan",
      "url": "http://www.blogger.com/profile/16258312240222542576",
      "image": {
        "url": "https://resources.blogblog.com/img/b16-rounded.gif"
      }
    },
    "replies": {
      "totalItems": "0",
      "selfLink": "https://www.googleapis.com/blogger/v3/blogs/3213900/posts/1387873546480002228/comments"
    }
  },
  ...
  ]
}

पोस्ट जोड़ना

आप पोस्ट JSON बॉडी के साथ पोस्ट कलेक्शन यूआरआई को POST अनुरोध भेजकर ब्लॉग के लिए पोस्ट जोड़ सकते हैं:

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

अनुरोध

POST https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
  "kind": "blogger#post",
  "blog": {
    "id": "8070105920543249955"
  },
  "title": "A new post",
  "content": "With <b>exciting</b> content..."
}

पोस्ट बनाने के लिए आपकी पुष्टि होनी ज़रूरी है.

जवाब

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "A new post",
 "content": "With <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

पोस्ट मिटाना

आप पोस्ट संसाधन यूआरआई को DELETE अनुरोध भेजकर किसी ब्लॉग की पोस्ट मिटा सकते हैं:

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

अनुरोध

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

DELETE https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058
Authorization: /* OAuth 2.0 token here */

किसी पोस्ट को मिटाने के लिए, आपकी पुष्टि होना ज़रूरी है.

जवाब

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

किसी पोस्ट को उसके पाथ से फिर से पाना

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

https://www.googleapis.com/blogger/v3/blogs/blogId/posts/bypath?path=post-path

अनुरोध

https://www.googleapis.com/blogger/v3/blogs/2399953/posts/bypath?path=/2011/08/latest-updates-august-1st.html&key=YOUR-API-KEY

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

जवाब

{
  "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/v3/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/v3/blogs/2399953/posts/7706273476706534553/comments"
  }
}

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

आप पोस्ट JSON बॉडी के साथ पोस्ट संसाधन यूआरआई को PUT अनुरोध भेजकर ब्लॉग के लिए पोस्ट अपडेट कर सकते हैं:

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

अनुरोध

PUT https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "kind": "blogger#post",
 "id": "3445355871727114160",
 "blog": {
  "id": "8070105920543249955"
 },
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post_20.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content..."
}

पोस्ट अपडेट करने के लिए, आपकी पुष्टि होनी ज़रूरी है.

जवाब

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With really <b>exciting</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

पैच सिमेंटिक्स के साथ पोस्ट अपडेट करना

आप पोस्ट JSON बॉडी के साथ पोस्ट संसाधन यूआरआई को PATCH अनुरोध भेजकर, पैच सिमेंटिक्स के साथ पोस्ट को अपडेट कर सकते हैं:

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

अनुरोध

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

PATCH https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/3445355871727114160
Authorization: /* OAuth 2.0 token here */
Content-Type: application/json

{
 "content": "With absolutely <b>fabulous</b> content..."
}

पोस्ट अपडेट करने के लिए, आपकी पुष्टि होनी ज़रूरी है.

जवाब

{
 "kind": "blogger#post",
 "id": "6819100329896798058",
 "blog": {
  "id": "8070105920543249955"
 },
 "published": "2012-05-20T20:08:00-07:00",
 "updated": "2012-05-20T20:08:35-07:00",
 "url": "http://brettmorgan-test2.blogspot.com/2012/05/new-post.html",
 "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058",
 "title": "An updated post",
 "content": "With absolutely <b>fabulous</b> content...",
 "author": {
  "id": "16258312240222542576",
  "displayName": "Brett Morgan",
  "url": "http://www.blogger.com/profile/16258312240222542576",
  "image": {
   "url": "https://resources.blogblog.com/img/b16-rounded.gif"
  }
 },
 "replies": {
  "totalItems": "0",
  "selfLink": "https://www.googleapis.com/blogger/v3/blogs/8070105920543249955/posts/6819100329896798058/comments"
 }
}

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

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

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

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

अनुरोध

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

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

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

जवाब

अनुरोध पूरा होने पर, सर्वर एक एचटीटीपी 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/v3/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/v3/blogs/blogId/posts/postId/comments/commentId

अनुरोध

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

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

जवाब

अनुरोध पूरा होने पर, सर्वर एचटीटीपी 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/v3/blogs/2399953/posts/6069922188027612413/comments/9200761938824362519",
  "content": "elided",
  "author": {
    "id": "530579030283",
    "displayName": "elided",
    "url": "elided",
    "image": {
      "url": "elided"
    }
  }
}

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

ब्लॉग के लिए पेजों को पाना

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

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

अनुरोध

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

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

जवाब

अनुरोध पूरा होने पर, सर्वर एक एचटीटीपी 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/v3/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/v3/blogs/blogId/pages/pageId

अनुरोध

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

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

जवाब

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

अनुरोध

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

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

जवाब

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

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

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

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

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