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

গুরুত্বপূর্ণ : আমরা 30শে সেপ্টেম্বর, 2024 থেকে v2.0 JSON API-এর জন্য সমর্থন বন্ধ করে দেব। অব্যাহত কার্যকারিতা নিশ্চিত করতে, আপনার অ্যাপ্লিকেশনগুলি আপডেট করুন যেগুলি v2.0 JSON API-এর উপর নির্ভর করে সর্বশেষ API সংস্করণে। সর্বশেষ সংস্করণের জন্য, বাম দিকের ন্যাভিবারে লিঙ্কগুলি ব্যবহার করুন৷

RESTful কলিং শৈলী ব্যবহার করে ব্লগার JSON API-এর সাধারণ বৈশিষ্ট্যগুলি কীভাবে ব্যবহার করবেন তা এই নথিতে বর্ণনা করা হয়েছে৷

বিষয়বস্তু

1. ভূমিকা
   1. অনুরোধ অনুমোদন এবং আপনার আবেদন সনাক্ত
2. ব্লগের সাথে কাজ করা
   1. একটি ব্লগ পুনরুদ্ধার করা হচ্ছে
   2. একজন ব্যবহারকারীর ব্লগ পুনরুদ্ধার করা হচ্ছে
3. পোস্ট নিয়ে কাজ করা
   1. একটি ব্লগের জন্য পোস্ট পুনরুদ্ধার করা হচ্ছে
   2. একটি নির্দিষ্ট পোস্ট পুনরুদ্ধার করা হচ্ছে
4. মন্তব্য নিয়ে কাজ করা
   1. একটি পোস্টের জন্য মন্তব্য পুনরুদ্ধার করা হচ্ছে
   2. একটি নির্দিষ্ট মন্তব্য পুনরুদ্ধার করা হচ্ছে
5. পেজ নিয়ে কাজ করা
   1. একটি ব্লগের জন্য পৃষ্ঠাগুলি পুনরুদ্ধার করা হচ্ছে
   2. একটি নির্দিষ্ট পৃষ্ঠা পুনরুদ্ধার করা হচ্ছে
6. ব্যবহারকারীদের সঙ্গে কাজ
   1. একজন ব্যবহারকারী পুনরুদ্ধার করা হচ্ছে
7. স্ট্যান্ডার্ড ক্যোয়ারী প্যারামিটার

ভূমিকা

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

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

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

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

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

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

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

দ্রষ্টব্য : ব্লগার JSON API বর্তমানে ডেটা অ্যাক্সেস ( হাইব্রিড ) বা ডোমেন-ওয়াইড অথরিটি ডেলিগেশন ( 2LO ) অনুরোধ করার সাথে সাথে লগ ইন করা সমর্থন করে না।

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

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

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

1. আপনি যখন আপনার অ্যাপ্লিকেশন তৈরি করেন, আপনি এটি Google-এর সাথে নিবন্ধন করেন । Google তারপরে আপনার প্রয়োজন হবে এমন তথ্য প্রদান করে, যেমন একটি ক্লায়েন্ট আইডি এবং একটি ক্লায়েন্ট গোপন।
2. Google APIs কনসোলের পরিষেবা ফলকে ব্লগার JSON API সক্রিয় করুন৷ (যদি এটি কনসোলে তালিকাভুক্ত না হয়, তাহলে এই ধাপটি এড়িয়ে যান।)
3. যখন আপনার অ্যাপ্লিকেশনটির ব্যবহারকারীর ডেটাতে অ্যাক্সেসের প্রয়োজন হয়, তখন এটি Google কে অ্যাক্সেসের একটি নির্দিষ্ট সুযোগের জন্য জিজ্ঞাসা করে।
4. Google ব্যবহারকারীর কাছে একটি OAuth ডায়ালগ প্রদর্শন করে, তাদের কিছু ডেটা অনুরোধ করার জন্য আপনার অ্যাপ্লিকেশনটিকে অনুমোদন করতে বলে৷
5. যদি ব্যবহারকারী অনুমোদন করেন, তাহলে Google আপনার অ্যাপ্লিকেশনকে একটি স্বল্পকালীন অ্যাক্সেস টোকেন দেয়।
6. আপনার অ্যাপ্লিকেশন ব্যবহারকারীর ডেটা অনুরোধ করে, অনুরোধে অ্যাক্সেস টোকেন সংযুক্ত করে।
7. যদি Google নির্ধারণ করে যে আপনার অনুরোধ এবং টোকেন বৈধ, এটি অনুরোধ করা ডেটা ফেরত দেয়।

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

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

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

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

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

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

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

একটি API কী অর্জন করতে, APIs কনসোলে যান। পরিষেবা ফলকে, [api_name] সক্রিয় করুন; পরিষেবার শর্তাবলী উপস্থিত হলে, পড়ুন এবং গ্রহণ করুন।

এরপরে, API অ্যাক্সেস প্যানে যান। API কীটি সেই ফলকের নীচের দিকে, "সাধারণ API অ্যাক্সেস" শিরোনামের বিভাগে।

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

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

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

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

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

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

অনুরোধ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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