গুরুত্বপূর্ণ : এটি এই পৃষ্ঠার একটি পুরানো সংস্করণ। সর্বশেষ সংস্করণের জন্য, বাম দিকের ন্যাভিবারে লিঙ্কগুলি ব্যবহার করুন৷
এই নথিটি ব্লগার ডেটা API-এর জন্য কাঁচা প্রোটোকলের (XML এবং HTTP) জন্য বিস্তারিত রেফারেন্স ডকুমেন্টেশন প্রদান করে।
এই নথিতে প্রোগ্রামিং-ভাষা ক্লায়েন্ট লাইব্রেরি সম্পর্কে তথ্য নেই। ক্লায়েন্ট-লাইব্রেরি রেফারেন্স তথ্যের জন্য, বিকাশকারীর গাইডের প্রোগ্রামিং-ভাষা-নির্দিষ্ট বিভাগগুলির লিঙ্কগুলি দেখুন।
বিষয়বস্তু
শ্রোতা
এই নথিটি এমন প্রোগ্রামারদের জন্য যারা ব্লগারের সাথে ইন্টারঅ্যাক্ট করতে পারে এমন ক্লায়েন্ট অ্যাপ্লিকেশন লিখতে চান।
এটি একটি রেফারেন্স নথি; এটি অনুমান করে যে আপনি বিকাশকারীর গাইডে উপস্থাপিত ধারণাগুলি এবং Google ডেটা API প্রোটোকলের পিছনের সাধারণ ধারণাগুলি বোঝেন৷
ব্লগার ফিড প্রকার
ব্লগার ফিডে ব্লগের বিষয়বস্তুর দুটি উপস্থাপনা প্রদান করে: সম্পূর্ণ ফিড এবং সারাংশ ফিড। একটি সম্পূর্ণ ফিডে সম্পূর্ণ ব্লগ পোস্ট থাকে, যখন একটি সারাংশ ফিডে প্রতিটি পোস্টের একটি ছোট স্নিপেট থাকে।
একটি ব্লগের মালিক GUI সেটিংস ব্যবহার করে নির্দিষ্ট করতে পারেন, ব্লগটি সিন্ডিকেটর এবং অ্যাগ্রিগেটরদের একটি সম্পূর্ণ ফিড বা সারাংশ ফিড সরবরাহ করে কিনা।
যখন আপনার ক্লায়েন্ট অ্যাপ একটি ফিডের জন্য একটি অপ্রমাণিত অনুরোধ পাঠায়, তখন এটি ব্লগের মালিক যে ধরনের ফিড নির্দিষ্ট করেছে তা পায়৷
আপনার ক্লায়েন্ট অ্যাপ যখন একটি প্রমাণীকৃত অনুরোধ পাঠায়, তবে, ব্লগের মালিক যা নির্দিষ্ট করেছেন তা নির্বিশেষে এটি সর্বদা একটি সম্পূর্ণ ফিড পায়।
ব্লগার ক্যোয়ারী প্যারামিটার রেফারেন্স
ব্লগার ডেটা API প্রায় সমস্ত আদর্শ Google ডেটা API ক্যোয়ারী প্যারামিটার সমর্থন করে৷
ব্লগার q (টেক্সট অনুসন্ধান) এবং 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
Blogger elements reference
ব্লগার ডেটা এপিআই শুধুমাত্র স্ট্যান্ডার্ড অ্যাটম উপাদান ব্যবহার করে; আরও তথ্যের জন্য, অ্যাটম 1.0 সিন্ডিকেশন ফর্ম্যাট স্পেসিফিকেশন এবং অ্যাটম পাবলিশিং প্রোটোকল দেখুন।
এই বিভাগের বাকি অংশ ব্লগারের কিছু মানক উপাদানের ব্যবহার সম্পর্কে কয়েকটি নির্দিষ্ট নোট প্রদান করে।
খসড়া এন্ট্রি
অ্যাটম পাবলিশিং প্রোটোকল নথিতে সংজ্ঞায়িত <app:draft> এক্সটেনশন উপাদান ব্যবহার করে একটি খসড়া ব্লগ এন্ট্রি চিহ্নিত করা হয়। Here's an example of a draft entry:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
যদি কোনো <draft> উপাদান নির্দিষ্ট করা না থাকে, তাহলে এন্ট্রিটি খসড়া নয়।
Publication dates and updated dates
স্ট্যান্ডার্ড অ্যাটম <published> উপাদানে দেওয়া টাইমস্ট্যাম্পটি "পোস্টের তারিখ" এর সাথে মিলে যায় যা একজন ব্যবহারকারী ব্লগার GUI-তে সেট করতে পারেন।
When your client creates a new entry, if the client doesn't specify a value for <published> , then Blogger sets the entry's post date to the current server time. যখন আপনার ক্লায়েন্ট একটি এন্ট্রি সম্পাদনা করে কিন্তু একটি <published> মান নির্দিষ্ট করে না, ব্লগার এন্ট্রির পোস্টের তারিখটি একা রেখে দেয়।
However, if your client does specify a value for the <published> element when creating or editing an entry, then Blogger sets the entry's post date to the specified value. এটি অন্য ব্লগিং সিস্টেম থেকে পুরানো এন্ট্রি আমদানি করার মতো কাজের জন্য উপযোগী হতে পারে (মূল তৈরির তারিখগুলি রেখে)।
ব্লগার স্ট্যান্ডার্ড অ্যাটম <updated> উপাদান ব্যবহার করে নির্দেশ করে যে একটি এন্ট্রি শেষবার পরিবর্তন করা হয়েছিল। Your client can't control the <updated> value; যখনই আপনার ক্লায়েন্ট একটি এন্ট্রি পোস্ট বা সম্পাদনা করে তখন ব্লগার সর্বদা এন্ট্রির সর্বশেষ আপডেটের তারিখ বর্তমান সার্ভারের সময় সেট করে।
You can use the standard Google Data API published-min , published-max , updated-min , and updated-max query parameters to request entries based on their <published> or <updated> values. যাইহোক, আপডেট করা তারিখে প্রশ্ন করার বিষয়ে নোটের জন্য, ব্লগার ক্যোয়ারী প্যারামিটার রেফারেন্স দেখুন।
Linking comments to posts
ব্লগার এক্সপোর্ট ফরম্যাটে একটি এটম ফিড নথিতে পোস্ট এবং মন্তব্য এন্ট্রি উভয়ই রয়েছে। দুই ধরনের এন্ট্রির মধ্যে পার্থক্য করার জন্য, ব্লগার <atom:category> উপাদান ব্যবহার করে। এই উপাদানটির একটি term প্যারামিটার থাকবে যা প্রতিফলিত করে যে এন্ট্রিটি একটি পোস্ট বা একটি মন্তব্যের জন্য।
অধিকন্তু, পোস্ট এন্ট্রির সাথে মন্তব্য এন্ট্রিকে লিঙ্ক করা অ্যাটম থ্রেডিং এক্সটেনশন ব্যবহারের মাধ্যমে সম্পন্ন করা হয়। In the example below, the <thr:in-reply-to> element in the comment entry will point to the post by using the post entry identifier in the ref parameter. এটি href প্যারামিটারের মাধ্যমে পোস্টের HTML URL-এর সাথেও লিঙ্ক করে।
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
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>