ব্লগার API: API ব্যবহার করে

ব্লগার API আপনাকে REST API ব্যবহার করে আপনার অ্যাপ্লিকেশনের সাথে ব্লগার সামগ্রীকে একীভূত করতে সক্ষম করে৷ আপনি শুরু করার আগে, আপনাকে অনুমোদন সেট আপ করতে হবে।

ভূমিকা

এই নথিটি এমন ডেভেলপারদের জন্য যারা ব্লগার API এর সাথে ইন্টারঅ্যাক্ট করতে পারে এমন অ্যাপ্লিকেশন লিখতে চান। ব্লগার হল ওয়েবসাইট তৈরি করার একটি হাতিয়ার যা মানুষকে তাদের চিন্তাভাবনাকে চলমান ভিত্তিতে প্রকাশ করতে দেয়।

আপনি যদি ব্লগার ধারণার সাথে অপরিচিত হন, তাহলে কোড করা শুরু করার আগে আপনার শুরু করা পড়া উচিত।

অনুরোধ অনুমোদন এবং আপনার আবেদন সনাক্ত

আপনার অ্যাপ্লিকেশান ব্লগার API-কে পাঠানো প্রতিটি অনুরোধ Google-এ আপনার অ্যাপ্লিকেশন সনাক্ত করতে হবে। আপনার অ্যাপ্লিকেশন সনাক্ত করার দুটি উপায় রয়েছে: একটি OAuth 2.0 টোকেন ব্যবহার করে (যা অনুরোধটি অনুমোদন করে) এবং/অথবা অ্যাপ্লিকেশনটির API কী ব্যবহার করে৷ এই বিকল্পগুলির মধ্যে কোনটি ব্যবহার করবেন তা কীভাবে নির্ধারণ করবেন তা এখানে রয়েছে:

  • যদি অনুরোধটির অনুমোদনের প্রয়োজন হয় (যেমন একজন ব্যক্তির ব্যক্তিগত ডেটার জন্য অনুরোধ), তাহলে আবেদনটিকে অনুরোধের সাথে একটি OAuth 2.0 টোকেন প্রদান করতে হবে। অ্যাপ্লিকেশনটি API কীও সরবরাহ করতে পারে, তবে এটির প্রয়োজন নেই।
  • যদি অনুরোধটির অনুমোদনের প্রয়োজন না হয় (যেমন সর্বজনীন ডেটার জন্য অনুরোধ), তাহলে অ্যাপ্লিকেশনটিকে অবশ্যই API কী বা একটি OAuth 2.0 টোকেন, বা উভয়ই প্রদান করতে হবে - যেটি বিকল্প আপনার জন্য সবচেয়ে সুবিধাজনক।

অনুমোদন প্রোটোকল সম্পর্কে

অনুরোধ অনুমোদন করতে আপনার অ্যাপ্লিকেশন অবশ্যই OAuth 2.0 ব্যবহার করবে। অন্য কোন অনুমোদন প্রোটোকল সমর্থিত হয় না. যদি আপনার অ্যাপ্লিকেশন Google এর সাথে সাইন ইন ব্যবহার করে, তবে অনুমোদনের কিছু দিক আপনার জন্য পরিচালনা করা হয়।

OAuth 2.0 এর মাধ্যমে অনুরোধ অনুমোদন করা হচ্ছে

অ-পাবলিক ব্যবহারকারীর ডেটার জন্য ব্লগার API-এর অনুরোধগুলি একজন প্রমাণীকৃত ব্যবহারকারীর দ্বারা অনুমোদিত হতে হবে।

এই প্রক্রিয়াটি একটি OAuth ক্লায়েন্ট আইডি দিয়ে সহজতর করা হয়।

একটি OAuth ক্লায়েন্ট আইডি পান

অথবা শংসাপত্র পৃষ্ঠায় একটি তৈরি করুন।

OAuth 2.0-এর জন্য অনুমোদন প্রক্রিয়ার বিশদ বিবরণ বা "প্রবাহ" আপনি কোন ধরনের অ্যাপ্লিকেশন লিখছেন তার উপর নির্ভর করে কিছুটা পরিবর্তিত হয়। নিম্নলিখিত সাধারণ প্রক্রিয়া সব ধরনের আবেদনের ক্ষেত্রে প্রযোজ্য:

  1. যখন আপনার অ্যাপ্লিকেশনটির ব্যবহারকারীর ডেটাতে অ্যাক্সেসের প্রয়োজন হয়, তখন এটি Google কে অ্যাক্সেসের একটি নির্দিষ্ট সুযোগের জন্য জিজ্ঞাসা করে।
  2. Google ব্যবহারকারীর কাছে একটি সম্মতি স্ক্রীন প্রদর্শন করে, তাদের কিছু ডেটা অনুরোধ করার জন্য আপনার আবেদনকে অনুমোদন করতে বলে।
  3. যদি ব্যবহারকারী অনুমোদন করেন, তাহলে Google আপনার অ্যাপ্লিকেশনকে একটি স্বল্পকালীন অ্যাক্সেস টোকেন দেয়।
  4. আপনার অ্যাপ্লিকেশন ব্যবহারকারীর ডেটা অনুরোধ করে, অনুরোধে অ্যাক্সেস টোকেন সংযুক্ত করে।
  5. যদি Google নির্ধারণ করে যে আপনার অনুরোধ এবং টোকেন বৈধ, এটি অনুরোধ করা ডেটা ফেরত দেয়।

কিছু প্রবাহে অতিরিক্ত পদক্ষেপ অন্তর্ভুক্ত থাকে, যেমন নতুন অ্যাক্সেস টোকেন অর্জন করতে রিফ্রেশ টোকেন ব্যবহার করে। বিভিন্ন ধরনের অ্যাপ্লিকেশনের জন্য প্রবাহ সম্পর্কে বিস্তারিত তথ্যের জন্য, Google এর OAuth 2.0 ডকুমেন্টেশন দেখুন।

ব্লগার API-এর জন্য এখানে OAuth 2.0 স্কোপের তথ্য রয়েছে:

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

OAuth 2.0 ব্যবহার করে অ্যাক্সেসের অনুরোধ করার জন্য, আপনার অ্যাপ্লিকেশনের সুযোগ তথ্যের প্রয়োজন, সেইসাথে আপনি যখন আপনার আবেদনটি নিবন্ধন করেন তখন Google সরবরাহ করে এমন তথ্য (যেমন ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট)।

টিপ: Google APIs ক্লায়েন্ট লাইব্রেরিগুলি আপনার জন্য কিছু অনুমোদন প্রক্রিয়া পরিচালনা করতে পারে৷ তারা বিভিন্ন প্রোগ্রামিং ভাষার জন্য উপলব্ধ; আরও বিস্তারিত জানার জন্য লাইব্রেরি এবং নমুনা সহ পৃষ্ঠাটি দেখুন।

একটি API কী অর্জন এবং ব্যবহার করা

সর্বজনীন ডেটার জন্য ব্লগার API-এর অনুরোধের সাথে অবশ্যই একটি শনাক্তকারী থাকতে হবে, যা একটি API কী বা একটি অ্যাক্সেস টোকেন হতে পারে৷

একটি চাবি পান

অথবা শংসাপত্র পৃষ্ঠায় একটি তৈরি করুন।

আপনার একটি API কী থাকার পরে, আপনার অ্যাপ্লিকেশনটি সমস্ত অনুরোধের URL-এ ক্যোয়ারী প্যারামিটার key= yourAPIKey যোগ করতে পারে।

API কী ইউআরএল-এ এম্বেড করার জন্য নিরাপদ; এটা কোন এনকোডিং প্রয়োজন নেই.

ব্লগের সাথে কাজ করা

একটি ব্লগ পুনরুদ্ধার করা হচ্ছে

আপনি ব্লগের URI-তে HTTP GET অনুরোধ পাঠিয়ে একটি নির্দিষ্ট ব্লগের জন্য তথ্য পুনরুদ্ধার করতে পারেন। একটি ব্লগের জন্য URI-এর নিম্নলিখিত বিন্যাস রয়েছে:

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

অনুরোধ

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

একটি সর্বজনীন ব্লগ পুনরুদ্ধার করার জন্য একজন ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন নেই৷ একটি পাবলিক ব্লগ অনুরোধের জন্য অ্যাপ্লিকেশনটির Authorization HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; যাইহোক, আপনাকে API কী প্রদান করতে হবে।

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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 দ্বারা একটি ব্লগ পুনরুদ্ধার করা

আপনি একটি url প্যারামিটার সহ নিম্নলিখিত URI-তে একটি HTTP GET অনুরোধ পাঠিয়ে তার URL ব্যবহার করে একটি ব্লগ পুনরুদ্ধার করতে পারেন:

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

অনুরোধ

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

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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": ""
 }
}

ব্যবহারকারীর ব্লগ পুনরুদ্ধার করা হচ্ছে

আপনি ব্লগ সংগ্রহ URI-তে HTTP 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 HTTP শিরোনাম প্রদান করতে হবে।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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": ""
      }
    }
  ]
}

পোস্ট নিয়ে কাজ করা

একটি ব্লগ থেকে পোস্ট পুনরুদ্ধার করা হচ্ছে

আপনি পোস্ট সংগ্রহ URI-তে একটি GET অনুরোধ পাঠিয়ে একটি প্রদত্ত ব্লগ থেকে পোস্টের একটি তালিকা পুনরুদ্ধার করতে পারেন। একটি পোস্ট সংগ্রহের জন্য URI-এর নিম্নলিখিত বিন্যাস রয়েছে:

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

অনুরোধ

এখানে একটি উদাহরণ:

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

একটি সর্বজনীন ব্লগ পুনরুদ্ধার করার জন্য একজন ব্যবহারকারীর প্রমাণীকরণের প্রয়োজন নেই৷ একটি পাবলিক ব্লগ অনুরোধের জন্য অ্যাপ্লিকেশনটির Authorization HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; যাইহোক, আপনাকে API কী প্রদান করতে হবে।

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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
    }
  ]
}

একটি নির্দিষ্ট পোস্ট পুনরুদ্ধার করা হচ্ছে

আপনি পোস্ট রিসোর্স URI-তে একটি GET অনুরোধ পাঠিয়ে ব্লগ থেকে একটি নির্দিষ্ট পোস্ট পুনরুদ্ধার করতে পারেন। একটি পোস্ট সংস্থানের জন্য URI-এর নিম্নলিখিত বিন্যাস রয়েছে:

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 HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; যাইহোক, আপনাকে API কী প্রদান করতে হবে।

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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 অনুসন্ধান ক্যোয়ারী প্যারামিটার সহ পোস্ট অনুসন্ধান URI-তে একটি 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 HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; যাইহোক, আপনাকে API কী প্রদান করতে হবে।

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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 বডি সহ পোস্ট সংগ্রহের URI-তে একটি 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..."
}

একটি পোস্ট তৈরি করতে আপনাকে অবশ্যই প্রমাণীকরণ করতে হবে।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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"
 }
}

একটি পোস্ট মুছে ফেলা হচ্ছে

আপনি পোস্ট রিসোর্স URI-তে 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 */

একটি পোস্ট মুছে ফেলার জন্য আপনাকে অবশ্যই প্রমাণীকরণ করতে হবে।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 200 OK স্ট্যাটাস কোড দিয়ে সাড়া দেয়।

এর পথ ধরে একটি পোস্ট পুনরুদ্ধার করা হচ্ছে

আপনি একটি path প্যারামিটার সহ পোস্ট বাইপাথ URI-এ একটি GET অনুরোধ পাঠিয়ে একটি ব্লগ থেকে একটি পোস্ট পুনরুদ্ধার করতে পারেন৷ পাথ অনুরোধ দ্বারা একটি পোস্টের জন্য URI নিম্নলিখিত বিন্যাস আছে:

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 HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; যাইহোক, আপনাকে API কী প্রদান করতে হবে।

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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 বডি সহ পোস্ট রিসোর্স URI-তে একটি 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..."
}

একটি পোস্ট আপডেট করার জন্য আপনাকে অবশ্যই প্রমাণীকরণ করতে হবে।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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"
 }
}

প্যাচ শব্দার্থবিদ্যা সহ একটি পোস্ট আপডেট করা হচ্ছে

আপনি পোস্ট রিসোর্স URI-তে 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..."
}

একটি পোস্ট আপডেট করার জন্য আপনাকে অবশ্যই প্রমাণীকরণ করতে হবে।

প্রতিক্রিয়া

যদি অনুরোধটি সফল হয়, সার্ভার একটি HTTP 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"
 }
}

মন্তব্য নিয়ে কাজ করছি

একটি পোস্টের জন্য মন্তব্য পুনরুদ্ধার করা হচ্ছে

আপনি মন্তব্য সংগ্রহ URI-তে একটি GET অনুরোধ পাঠিয়ে একটি পোস্টের জন্য মন্তব্যের একটি তালিকা পুনরুদ্ধার করতে পারেন। মন্তব্য সংগ্রহের জন্য URI-এর নিম্নলিখিত বিন্যাস রয়েছে:

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 HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; তবে, আপনাকে API কী প্রদান করতে হবে৷

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধটি সফল হলে, সার্ভার একটি HTTP 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
    }
  ]
}

একটি নির্দিষ্ট মন্তব্য পুনরুদ্ধার করা হচ্ছে

আপনি মন্তব্য সংস্থান URI-তে একটি GET অনুরোধ পাঠিয়ে একটি পোস্ট থেকে একটি নির্দিষ্ট মন্তব্য পুনরুদ্ধার করতে পারেন। একটি মন্তব্য সংস্থানের জন্য URI-এর নিম্নলিখিত বিন্যাস রয়েছে:

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 HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; তবে, আপনাকে API কী প্রদান করতে হবে৷

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধটি সফল হলে, সার্ভার একটি HTTP 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"
    }
  }
}

পেজ নিয়ে কাজ করা

একটি ব্লগের জন্য পৃষ্ঠাগুলি পুনরুদ্ধার করা হচ্ছে

আপনি পৃষ্ঠা সংগ্রহ URI-তে একটি GET অনুরোধ পাঠিয়ে ব্লগের জন্য পৃষ্ঠাগুলির একটি তালিকা পুনরুদ্ধার করতে পারেন। একটি পৃষ্ঠা সংগ্রহের জন্য URI-এর নিম্নলিখিত বিন্যাস রয়েছে:

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

অনুরোধ

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

"একজন ব্যবহারকারীকে একটি সর্বজনীন ব্লগ পুনরুদ্ধার করার জন্য প্রমাণীকরণের প্রয়োজন নেই৷ অ্যাপ্লিকেশনটিতে একটি সর্বজনীন ব্লগ অনুরোধের জন্য Authorization HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; তবে, আপনাকে API কী প্রদান করতে হবে৷

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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"
        }
      }
    }
  ]
}

একটি নির্দিষ্ট পৃষ্ঠা পুনরুদ্ধার করা হচ্ছে

আপনি পৃষ্ঠাগুলির সংস্থান URI-তে একটি GET অনুরোধ পাঠিয়ে একটি ব্লগ থেকে একটি নির্দিষ্ট পৃষ্ঠা পুনরুদ্ধার করতে পারেন৷ একটি পৃষ্ঠার জন্য URI রিসোর্সের নিম্নলিখিত বিন্যাস রয়েছে:

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 HTTP শিরোনাম অন্তর্ভুক্ত করার প্রয়োজন নেই; তবে, আপনাকে API কী প্রদান করতে হবে৷

ব্লগারের ব্যক্তিগত ব্লগও রয়েছে, যার জন্য প্রমাণীকরণ প্রয়োজন।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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"
    }
  }
}

ব্যবহারকারীদের সঙ্গে কাজ

একজন ব্যবহারকারী পুনরুদ্ধার করা হচ্ছে

আপনি ব্যবহারকারীদের রিসোর্স ইউআরআই-এর কাছে একটি HTTP 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 HTTP শিরোনাম প্রদান করতে হবে।

প্রতিক্রিয়া

অনুরোধ সফল হলে, সার্ভার একটি HTTP 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"
  }
}

স্ট্যান্ডার্ড ক্যোয়ারী প্যারামিটার

নিম্নলিখিত ক্যোয়ারী প্যারামিটারগুলি ব্লগার API-এর সমস্ত পদ্ধতি এবং সমস্ত সংস্থানগুলির সাথে ব্যবহার করা যেতে পারে৷

সমস্ত ব্লগার API অপারেশনে প্রযোজ্য কোয়েরি প্যারামিটার সিস্টেম প্যারামিটারে নথিভুক্ত করা হয়।