ব্লগার JSON API: শুরু করা

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

এই নথিটি ব্যাখ্যা করে কিভাবে ব্লগার JSON API ব্যবহার করে শুরু করতে হয়।

বিষয়বস্তু

1. ভূমিকা
2. আপনি শুরু করার আগে
   1. একটি Google অ্যাকাউন্ট পান
   2. ব্লগারের সাথে পরিচিত হন
   3. অনুরোধ অনুমোদন এবং আপনার আবেদন সনাক্ত সম্পর্কে জানুন
3. ব্লগার JSON API ব্যাকগ্রাউন্ড
   1. ব্লগার ধারণা
   2. ব্লগার JSON API ডেটা মডেল
   3. ব্লগার JSON API অপারেশন
4. কলিং স্টাইল
   1. বিশ্রাম
5. ডেটা বিন্যাস
   1. JSON

ভূমিকা

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

ব্লগার JSON API ব্লগার ডেটা API- এর সংস্করণ 2.0 প্রসারিত করে। আপনি যদি XML এর পরিবর্তে JSON ফর্ম্যাটে ব্লগার থেকে ডেটা পুনরুদ্ধার করতে চান, তাহলে ব্লগার JSON API ব্যবহার করুন৷ আপনি যদি XML ফর্ম্যাটে ডেটা পুনরুদ্ধার করতে চান, তাহলে ব্লগার ডেটা API ব্যবহার করুন।

ব্লগার JSON API-এর এই সংস্করণটি বর্তমানে শুধুমাত্র পঠনযোগ্য; যাইহোক, আমরা পঠন/লেখার ক্ষমতার পাশাপাশি অন্যান্য ক্ষমতা যোগ করার পরিকল্পনা করছি। ব্লগার হেল্প ফোরামে অন্যান্য বৈশিষ্ট্যের জন্য নির্দ্বিধায় অনুরোধ করুন৷

আপনি শুরু করার আগে

একটি Google অ্যাকাউন্ট পান

আপনার একটি Google অ্যাকাউন্ট সেট আপ আছে তা নিশ্চিত করুন৷ দুর্ঘটনাজনিত ডেটা ক্ষতি থেকে নিজেকে রক্ষা করার জন্য আমরা আপনাকে ডেভেলপমেন্ট এবং পরীক্ষার উদ্দেশ্যে একটি পৃথক Google অ্যাকাউন্ট ব্যবহার করার পরামর্শ দিই। আপনার যদি ইতিমধ্যেই একটি পরীক্ষামূলক অ্যাকাউন্ট থাকে, তাহলে আপনি সম্পূর্ণ প্রস্তুত; আপনি আপনার পরীক্ষার ডেটা সেট আপ করতে, সম্পাদনা করতে বা দেখতে ব্লগার ইউজার ইন্টারফেসে যেতে পারেন।

ব্লগারের সাথে পরিচিত হন

আপনি যদি ব্লগার ধারণার সাথে অপরিচিত হন তবে এই নথিটি পড়ুন এবং কোড শুরু করার আগে ব্যবহারকারী ইন্টারফেসের সাথে পরীক্ষা করুন। এই নথিটি অনুমান করে যে আপনি ব্লগার, ওয়েব প্রোগ্রামিং ধারণা এবং ওয়েব ডেটা ফর্ম্যাটের সাথে পরিচিত৷

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

যখন আপনার অ্যাপ্লিকেশান ব্যক্তিগত ডেটার অনুরোধ করে, অনুরোধটি অবশ্যই একজন প্রমাণীকৃত ব্যবহারকারীর দ্বারা অনুমোদিত হতে হবে যার সেই ডেটাতে অ্যাক্সেস রয়েছে৷

যখন আপনার অ্যাপ্লিকেশান সর্বজনীন ডেটার অনুরোধ করে, তখন অনুরোধটির অনুমোদনের প্রয়োজন হয় না, তবে একটি API কী এর মতো একটি শনাক্তকারীর সাথে থাকা প্রয়োজন৷

কিভাবে অনুরোধ অনুমোদন করতে হয় এবং এপিআই কী ব্যবহার করতে হয় সে সম্পর্কে তথ্যের জন্য, এপিআই ডকুমেন্ট ব্যবহার করে অনুরোধ অনুমোদন এবং আপনার অ্যাপ্লিকেশন সনাক্তকরণ দেখুন।

ব্লগার JSON API ব্যাকগ্রাউন্ড

ব্লগার ধারণা

ব্লগার পাঁচটি মৌলিক ধারণার উপর নির্মিত:

• ব্লগ : API এর মূল ধারণা। একটি ব্লগ পোস্ট এবং পৃষ্ঠা আছে. এটি ব্লগের নাম এবং বর্ণনার মতো ব্লগ মেটা-তথ্যের ধারক।
• পোস্ট : একটি ব্লগ পোস্ট হল প্রকাশযোগ্য আইটেম যা ব্লগ লেখক তৈরি করেছেন। এই তথ্যটি সময়োপযোগী হতে বোঝানো হয়েছে, লেখকরা এখন বিশ্বের কাছে কী প্রকাশ করতে চান তা প্রতিফলিত করে। এটা বোঝা যায় যে সময়ের সাথে সাথে ব্লগ পোস্টের বিষয়বস্তু বয়স বাড়ায় এবং কম প্রাসঙ্গিক হয়ে ওঠে।
• মন্তব্য : একটি মন্তব্য হল সেই জায়গা যেখানে ব্লগ পোস্ট লেখক ছাড়া অন্য লোকেরা লেখক যা লিখেছেন তাতে প্রতিক্রিয়া দেখায়। ইট থেকে তোড়া সবই।
• পৃষ্ঠা : একটি পৃষ্ঠা হল স্থির বিষয়বস্তুর জন্য একটি স্থান, যেমন জীবনী সংক্রান্ত তথ্য, বা ব্যবহারকারীর সাথে যোগাযোগ করার উপায়। এটি সাধারণত নিরবধি তথ্য যা প্রায়শই পরিবর্তিত হয় না।
• ব্যবহারকারী : একজন ব্যবহারকারী হলেন এমন একজন যিনি ব্লগারের সাথে যোগাযোগ করেন, তারা একজন লেখক, একজন প্রশাসক বা শুধুমাত্র একজন পাঠক হিসেবে কাজ করছেন। সর্বজনীন ব্লগের জন্য, পাঠক বেনামী হতে পারে, কিন্তু ব্যক্তিগত ব্লগে একজন পাঠককে অবশ্যই ব্লগার দ্বারা চিহ্নিত করতে হবে।

ব্লগার JSON API ডেটা মডেল

একটি সম্পদ একটি অনন্য শনাক্তকারী সহ একটি পৃথক ডেটা সত্তা। ব্লগার JSON API পাঁচ ধরনের সম্পদে কাজ করে:

• ব্লগ সম্পদ : একটি ব্লগ প্রতিনিধিত্ব করে.
• পোস্ট সম্পদ : একটি পোস্ট প্রতিনিধিত্ব করে; প্রতিটি পোস্ট রিসোর্স একটি ব্লগ রিসোর্সের সন্তান।
• মন্তব্য সম্পদ : একটি নির্দিষ্ট পোস্টে একটি মন্তব্য প্রতিনিধিত্ব করে; প্রতিটি মন্তব্য সম্পদ একটি পোস্ট সম্পদ একটি সন্তান.
• পেজ রিসোর্স : একটি স্ট্যাটিক পেজ রিপ্রেজেন্ট করে; প্রতিটি পেজ রিসোর্স একটি ব্লগ রিসোর্সের সন্তান।
• ব্যবহারকারী সম্পদ : একটি অ-বেনামী ব্যবহারকারীর প্রতিনিধিত্ব করে। এটি একটি পৃষ্ঠা, পোস্ট বা মন্তব্যের লেখক সনাক্ত করতে ব্যবহৃত হয়।

সম্পদের মধ্যে সম্পর্কের ওভারভিউ

ব্লগার JSON API ডেটা মডেলটি সম্পদের গোষ্ঠীর উপর ভিত্তি করে, যাকে বলা হয় সংগ্রহ:

ব্লগ সংগ্রহ

ক ব্লগ সংগ্রহে ব্যবহারকারীর অ্যাক্সেসের অধিকার রয়েছে এমন সমস্ত ব্লগ নিয়ে গঠিত। আপনি ব্যবহারকারী দ্বারা ব্লগ তালিকাভুক্ত করতে পারেন, অথবা ID দ্বারা একটি একক ব্লগ পুনরুদ্ধার করতে পারেন৷

পোস্ট সংগ্রহ

একটি পোস্ট সংগ্রহ একটি নির্দিষ্ট ব্লগ সম্পদের মধ্যে সমস্ত পোস্ট সম্পদ নিয়ে গঠিত।

মন্তব্য সংগ্রহ

একটি মন্তব্য সংগ্রহ একটি নির্দিষ্ট পোস্ট সম্পদের মধ্যে সমস্ত মন্তব্য সম্পদ নিয়ে গঠিত।

পেজ কালেকশন

একটি পেজ কালেকশন একটি নির্দিষ্ট ব্লগ রিসোর্সের মধ্যে থাকা সমস্ত পেজ রিসোর্স নিয়ে গঠিত।

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

একটি ব্যবহারকারী সংগ্রহ ব্লগারে সমস্ত ব্যবহারকারীর সম্পদ নিয়ে গঠিত, এবং এইভাবে তালিকাভুক্ত করা যাবে না। একজন ব্যবহারকারী তাদের নিজস্ব ব্যবহারকারী সম্পদ পুনরুদ্ধার করতে পারে (কিন্তু অন্য কারো নয়) ID দ্বারা, অথবা শনাক্তকারী self ব্যবহার করে।

ব্লগার JSON API অপারেশন

আপনি ব্লগার JSON API-এ সংগ্রহ এবং সংস্থানগুলির জন্য দুটি ভিন্ন পদ্ধতি ব্যবহার করতে পারেন, যেমনটি নিম্নলিখিত টেবিলে বর্ণনা করা হয়েছে।

অপারেশন	বর্ণনা	REST HTTP ম্যাপিং
তালিকা	একটি সংগ্রহের মধ্যে সমস্ত সংস্থান তালিকাভুক্ত করে।	একটি সংগ্রহ URI এ GET ।
পেতে	একটি নির্দিষ্ট সম্পদ পায়।	একটি রিসোর্স ইউআরআই GET ।

নীচের সারণীটি দেখায় যে কোন পদ্ধতিগুলি প্রতিটি সংস্থান প্রকার দ্বারা সমর্থিত। সমস্ত তালিকা এবং ব্যক্তিগত ব্লগে অপারেশন পেতে প্রমাণীকরণ প্রয়োজন।

সম্পদের ধরন	সমর্থিত পদ্ধতি
	তালিকা	পেতে
ব্লগ	হ্যাঁ	হ্যাঁ
পোস্ট	হ্যাঁ	হ্যাঁ
মন্তব্য	হ্যাঁ	হ্যাঁ
পাতা	হ্যাঁ	হ্যাঁ
ব্যবহারকারীদের	না	হ্যাঁ

কলিং শৈলী

API চালু করার বিভিন্ন উপায় রয়েছে:

• সরাসরি বা জাভাস্ক্রিপ্ট থেকে REST ব্যবহার করা (কোন সার্ভার-সাইড কোডের প্রয়োজন নেই)
• ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

বিশ্রাম

REST হল সফ্টওয়্যার আর্কিটেকচারের একটি শৈলী যা ডেটা অনুরোধ এবং পরিবর্তন করার জন্য একটি সুবিধাজনক এবং সামঞ্জস্যপূর্ণ পদ্ধতি প্রদান করে।

REST শব্দটি " রিপ্রেজেন্টেশনাল স্টেট ট্রান্সফার " এর জন্য সংক্ষিপ্ত। Google API-এর প্রসঙ্গে, এটি Google দ্বারা সংরক্ষিত ডেটার উপস্থাপনা পুনরুদ্ধার এবং সংশোধন করার জন্য HTTP ক্রিয়া ব্যবহারকে বোঝায়।

একটি RESTful সিস্টেমে, সম্পদ একটি ডেটা স্টোরে সংরক্ষণ করা হয়; একটি ক্লায়েন্ট একটি অনুরোধ পাঠায় যে সার্ভার একটি নির্দিষ্ট ক্রিয়া সম্পাদন করে (যেমন একটি সংস্থান তৈরি করা, পুনরুদ্ধার করা, আপডেট করা বা মুছে ফেলা), এবং সার্ভার ক্রিয়াটি সম্পাদন করে এবং একটি প্রতিক্রিয়া পাঠায়, প্রায়শই নির্দিষ্ট সংস্থানের উপস্থাপনা আকারে।

Google-এর RESTful API-এ, ক্লায়েন্ট একটি HTTP ক্রিয়া যেমন POST , GET , PUT , বা DELETE ব্যবহার করে একটি ক্রিয়া নির্দিষ্ট করে৷ এটি নিম্নলিখিত ফর্মের একটি বিশ্বব্যাপী-অনন্য URI দ্বারা একটি সংস্থান নির্দিষ্ট করে:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

যেহেতু সমস্ত API সংস্থানগুলিতে অনন্য HTTP- অ্যাক্সেসযোগ্য URI রয়েছে, REST ডেটা ক্যাশিং সক্ষম করে এবং ওয়েবের বিতরণ করা অবকাঠামোর সাথে কাজ করার জন্য অপ্টিমাইজ করা হয়৷

আপনি HTTP 1.1 স্ট্যান্ডার্ড ডকুমেন্টেশনে পদ্ধতির সংজ্ঞাগুলি দরকারী খুঁজে পেতে পারেন; তারা GET , POST , PUT , এবং DELETE এর স্পেসিফিকেশন অন্তর্ভুক্ত করে।

ব্লগার JSON API-এ বিশ্রাম নিন

সমর্থিত ব্লগার অপারেশনগুলি সরাসরি REST HTTP ক্রিয়াতে ম্যাপ করে, যেমনটি ব্লগার JSON API অপারেশনগুলিতে বর্ণিত হয়েছে।

ব্লগার JSON API URI-এর জন্য নির্দিষ্ট বিন্যাস হল:

https://www.googleapis.com/blogger/v2/users/userId
https://www.googleapis.com/blogger/v2/users/self
https://www.googleapis.com/blogger/v2/users/userId/blogs
https://www.googleapis.com/blogger/v2/users/self/blogs

https://www.googleapis.com/blogger/v2/blogs/blogId/posts
https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId
https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments
https://www.googleapis.com/blogger/v2/blogs/blogId/posts/postId/comments/commentId
https://www.googleapis.com/blogger/v2/blogs/blogId/pages
https://www.googleapis.com/blogger/v2/blogs/blogId/pages/pageId

ব্যবহৃত URI-এর সম্পূর্ণ ব্যাখ্যা এবং API-এ প্রতিটি সমর্থিত অপারেশনের ফলাফল ব্লগার JSON API রেফারেন্স নথিতে সংক্ষিপ্ত করা হয়েছে।

ব্লগার JSON API-এ এটি কীভাবে কাজ করে তার কয়েকটি উদাহরণ এখানে দেওয়া হল।

প্রমাণিত ব্যবহারকারীর অ্যাক্সেস অধিকার আছে এমন ব্লগের তালিকা করুন:

GET https://www.googleapis.com/blogger/v2/users/self/blogs?key=YOUR-API-KEY

কোড.blogger.com ব্লগে পোস্টগুলি পান (যার ব্লগ আইডি 3213900 আছে):

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

জাভাস্ক্রিপ্ট থেকে REST

আপনি জাভাস্ক্রিপ্ট থেকে REST ব্যবহার করে, callback ক্যোয়ারী প্যারামিটার এবং একটি কলব্যাক ফাংশন ব্যবহার করে ব্লগার JSON API চালু করতে পারেন। এটি আপনাকে সমৃদ্ধ অ্যাপ্লিকেশন লিখতে দেয় যা কোনো সার্ভার-সাইড কোড না লিখে ব্লগার ডেটা প্রদর্শন করে।

নিম্নলিখিত উদাহরণটি code.blogger.com ব্লগ থেকে একটি পোস্ট পুনরুদ্ধার করে (আপনি আপনার API কী দিয়ে YOUR-API-KEY প্রতিস্থাপন করার পরে)।

<html>
  <head>
    <title>Blogger JSON API Example</title>
  </head>
  <body>
    <div id="content"></div>
    <script>
      function handleResponse(response) {
        document.getElementById("content").innerHTML += "<h1>" + response.title + "</h1>" + response.content;
      }
    </script>
    <script
    src="https://www.googleapis.com/blogger/v2/blogs/3213900/posts/8398240586497962757?callback=handleResponse&key=YOUR-API-KEY"></script>
  </body>
</html>

ডেটা বিন্যাস

JSON

JSON (জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন) হল একটি সাধারণ, ভাষা-স্বাধীন ডেটা ফর্ম্যাট যা নির্বিচারে ডেটা স্ট্রাকচারের একটি সাধারণ পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।