এই নথিটি ব্লগার ডেটা API-এর জন্য কাঁচা প্রোটোকলের (XML এবং HTTP) জন্য বিস্তারিত রেফারেন্স ডকুমেন্টেশন প্রদান করে।
এই নথিতে প্রোগ্রামিং-ভাষা ক্লায়েন্ট লাইব্রেরি সম্পর্কে তথ্য নেই। ক্লায়েন্ট-লাইব্রেরি রেফারেন্স তথ্যের জন্য, বিকাশকারীর গাইডের প্রোগ্রামিং-ভাষা-নির্দিষ্ট বিভাগগুলির লিঙ্কগুলি দেখুন।
বিষয়বস্তু
শ্রোতা
এই নথিটি এমন প্রোগ্রামারদের জন্য যারা ব্লগারের সাথে ইন্টারঅ্যাক্ট করতে পারে এমন ক্লায়েন্ট অ্যাপ্লিকেশন লিখতে চান।
এটি একটি রেফারেন্স নথি; এটি অনুমান করে যে আপনি বিকাশকারীর গাইডে উপস্থাপিত ধারণাগুলি এবং Google ডেটা API প্রোটোকলের পিছনের সাধারণ ধারণাগুলি বোঝেন৷
ব্লগার ফিড প্রকার
ব্লগার ফিডে ব্লগের বিষয়বস্তুর দুটি উপস্থাপনা প্রদান করে: সম্পূর্ণ ফিড এবং সারাংশ ফিড। একটি সম্পূর্ণ ফিডে সম্পূর্ণ ব্লগ পোস্ট থাকে, যখন একটি সারাংশ ফিডে প্রতিটি পোস্টের একটি ছোট স্নিপেট থাকে।
একটি ব্লগের মালিক GUI সেটিংস ব্যবহার করে নির্দিষ্ট করতে পারেন, ব্লগটি সিন্ডিকেটর এবং অ্যাগ্রিগেটরদের একটি সম্পূর্ণ ফিড বা সারাংশ ফিড সরবরাহ করে কিনা।
যখন আপনার ক্লায়েন্ট অ্যাপ একটি ফিডের জন্য একটি অপ্রমাণিত অনুরোধ পাঠায়, তখন এটি ব্লগের মালিক যে ধরনের ফিড নির্দিষ্ট করেছে তা পায়৷
আপনার ক্লায়েন্ট অ্যাপ যখন একটি প্রমাণীকৃত অনুরোধ পাঠায়, তবে, ব্লগের মালিক যা নির্দিষ্ট করেছেন তা নির্বিশেষে এটি সর্বদা একটি সম্পূর্ণ ফিড পায়।
ব্লগার ক্যোয়ারী প্যারামিটার রেফারেন্স
ব্লগার ডেটা API প্রায় সমস্ত আদর্শ Google ডেটা API ক্যোয়ারী প্যারামিটার সমর্থন করে৷
ব্লগার author প্যারামিটার সমর্থন করে না।
updated-min এবং updated-max ক্যোয়ারী প্যারামিটার উপেক্ষা করা হয় যদি না orderby প্যারামিটার updated হয়। উদাহরণস্বরূপ, নিম্নলিখিত ইউআরএলটি 16 মার্চ, 2008 থেকে 24 মার্চ, 2008 পর্যন্ত আপডেট করা সমস্ত ব্লগ পোস্ট পুনরুদ্ধার করে:
http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated
ব্লগার উপাদান রেফারেন্স
ব্লগার ডেটা এপিআই শুধুমাত্র স্ট্যান্ডার্ড অ্যাটম উপাদান ব্যবহার করে; আরও তথ্যের জন্য, অ্যাটম 1.0 সিন্ডিকেশন ফর্ম্যাট স্পেসিফিকেশন এবং অ্যাটম পাবলিশিং প্রোটোকল দেখুন।
এই বিভাগের বাকি অংশ ব্লগারের কিছু মানক উপাদানের ব্যবহার সম্পর্কে কয়েকটি নির্দিষ্ট নোট প্রদান করে।
খসড়া এন্ট্রি
অ্যাটম পাবলিশিং প্রোটোকল নথিতে সংজ্ঞায়িত <app:draft> এক্সটেনশন উপাদান ব্যবহার করে একটি খসড়া ব্লগ এন্ট্রি চিহ্নিত করা হয়। এখানে একটি খসড়া এন্ট্রির একটি উদাহরণ:
<entry xmlns:app='http://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
যদি কোনো <draft> উপাদান নির্দিষ্ট করা না থাকে, তাহলে এন্ট্রিটি খসড়া নয়।
প্রকাশনার তারিখ এবং আপডেট তারিখ
স্ট্যান্ডার্ড অ্যাটম <published> উপাদানে দেওয়া টাইমস্ট্যাম্পটি "পোস্টের তারিখ" এর সাথে মিলে যায় যা একজন ব্যবহারকারী ব্লগার GUI-তে সেট করতে পারেন।
যখন আপনার ক্লায়েন্ট একটি নতুন এন্ট্রি তৈরি করে, ক্লায়েন্ট যদি <published> -এর জন্য একটি মান নির্দিষ্ট না করে, তাহলে ব্লগার বর্তমান সার্ভারের সময়ে এন্ট্রির পোস্টের তারিখ সেট করে। যখন আপনার ক্লায়েন্ট একটি এন্ট্রি সম্পাদনা করে কিন্তু একটি <published> মান নির্দিষ্ট করে না, ব্লগার এন্ট্রির পোস্টের তারিখটি একা রেখে দেয়।
যাইহোক, যদি আপনার ক্লায়েন্ট একটি এন্ট্রি তৈরি বা সম্পাদনা করার সময় <published> উপাদানটির জন্য একটি মান নির্দিষ্ট করে, তাহলে ব্লগার নির্দিষ্ট মানের সাথে এন্ট্রির পোস্টের তারিখ সেট করে। এটি অন্য ব্লগিং সিস্টেম থেকে পুরানো এন্ট্রি আমদানি করার মতো কাজের জন্য উপযোগী হতে পারে (মূল তৈরির তারিখগুলি রেখে)।
ব্লগার স্ট্যান্ডার্ড অ্যাটম <updated> উপাদান ব্যবহার করে নির্দেশ করে যে একটি এন্ট্রি শেষবার পরিবর্তন করা হয়েছিল। আপনার ক্লায়েন্ট <updated> মান নিয়ন্ত্রণ করতে পারে না; যখনই আপনার ক্লায়েন্ট একটি এন্ট্রি পোস্ট বা সম্পাদনা করে তখন ব্লগার সর্বদা এন্ট্রির সর্বশেষ আপডেটের তারিখ বর্তমান সার্ভারের সময় সেট করে।
আপনি স্ট্যান্ডার্ড Google Data API published-min , published-max , updated-min , এবং updated-max ক্যোয়ারী প্যারামিটার ব্যবহার করে তাদের <published> বা <updated> মানগুলির উপর ভিত্তি করে এন্ট্রির অনুরোধ করতে পারেন। যাইহোক, আপডেট করা তারিখে প্রশ্ন করার বিষয়ে নোটের জন্য, ব্লগার ক্যোয়ারী প্যারামিটার রেফারেন্স দেখুন।
পোস্টে মন্তব্য লিঙ্ক করা
ব্লগার এক্সপোর্ট ফরম্যাটে একটি এটম ফিড নথিতে পোস্ট এবং মন্তব্য এন্ট্রি উভয়ই রয়েছে। দুই ধরনের এন্ট্রির মধ্যে পার্থক্য করার জন্য, ব্লগার <atom:category> উপাদান ব্যবহার করে। এই উপাদানটির একটি term প্যারামিটার থাকবে যা প্রতিফলিত করে যে এন্ট্রিটি একটি পোস্ট বা একটি মন্তব্যের জন্য।
অধিকন্তু, পোস্ট এন্ট্রির সাথে মন্তব্য এন্ট্রিকে লিঙ্ক করা অ্যাটম থ্রেডিং এক্সটেনশন ব্যবহারের মাধ্যমে সম্পন্ন করা হয়। নীচের উদাহরণে, মন্তব্য এন্ট্রিতে <thr:in-reply-to> উপাদানটি ref প্যারামিটারে পোস্ট এন্ট্রি শনাক্তকারী ব্যবহার করে পোস্টের দিকে নির্দেশ করবে। এটি href প্যারামিটারের মাধ্যমে পোস্টের HTML URL-এর সাথেও লিঙ্ক করে।
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
xmlns:thr="http://purl.org/syndication/thread/1.0">
...
<-- A blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID</id>
<content type="html">This is my first post</content>
<link rel="alternate" type="text/html"
href="http://blogName.blogspot.com/2007/04/first-post.html">
</link>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#post"/>
...
</entry>
<-- A comment to the blog post entry -->
<entry>
<id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
<content type="html">This is my first commment</content>
<category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/blogger/2008/kind#comment"/>
<thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html"
ref="tag:blogger.com,1999:blog-blogID.post-postID"
type="text/html"/>
...
</entry>
</feed>