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

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

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

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

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

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

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

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

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

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

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

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

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

OAuth क्लाइंट आईडी पाना

इसके अलावा, क्रेडेंशियल पेज में जाकर खाता बनाया जा सकता है.

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

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

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

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

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

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

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

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

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

कुंजी पाएं

इसके अलावा, क्रेडेंशियल पेज में जाकर खाता बनाया जा सकता है.

एपीआई कुंजी मिलने के बाद, आपका ऐप्लिकेशन सभी अनुरोध यूआरएल के लिए, क्वेरी पैरामीटर 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

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

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

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

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

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

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

जवाब

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

{
  "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..."
}

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

जवाब

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

{
 "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

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

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"
  }
}

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

आप किसी पोस्ट 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..."
}

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

जवाब

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

{
 "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..."
}

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

जवाब

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

{
 "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

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

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

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

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

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

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 के एपीआई में सभी तरीकों और सभी संसाधनों के साथ किया जा सकता है.

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