สำคัญ: หน้านี้เป็นหน้าเวอร์ชันเก่า หากต้องการใช้เวอร์ชันล่าสุด ให้ใช้ลิงก์ในแถบนําทางด้านซ้าย
เอกสารนี้มีเอกสารอ้างอิงโดยละเอียดสำหรับโปรโตคอลไฟล์ข้อมูล (XML และ HTTP) ของ Blogger Data API
เอกสารนี้ไม่มีข้อมูลเกี่ยวกับภาษาโปรแกรม ไลบรารีของไคลเอ็นต์ ดูข้อมูลอ้างอิงเกี่ยวกับไลบรารีของไคลเอ็นต์ได้ที่ลิงก์จากส่วนเฉพาะภาษาโปรแกรมของคู่มือสำหรับนักพัฒนาซอฟต์แวร์
เนื้อหา
ผู้ชม
เอกสารนี้มีไว้สำหรับโปรแกรมเมอร์ที่ต้องการเขียนไคลเอ็นต์ แอปพลิเคชันที่โต้ตอบกับบล็อกเกอร์ได้
เป็นเอกสารอ้างอิง โดยมีสมมติฐานว่า ที่แสดงในคู่มือสำหรับนักพัฒนาซอฟต์แวร์ และ แนวคิดทั่วไปที่อยู่เบื้องหลัง Google Data API โปรโตคอล
ประเภทฟีด Blogger
Blogger แสดงเนื้อหาของบล็อกในฟีด 2 แบบคือ ฟีดแบบสมบูรณ์และ ฟีดสรุป ฟีดแบบเต็มจะมีบล็อกโพสต์แบบเต็ม ส่วนฟีดข้อมูลสรุปจะมีเพียงตัวอย่างสั้นๆ ของโพสต์แต่ละรายการ
เจ้าของบล็อกสามารถระบุได้ว่าจะให้ฟีดแบบเต็มหรือฟีดข้อมูลสรุปแก่ผู้จัดจําหน่ายและผู้รวบรวมข้อมูลโดยใช้การตั้งค่า GUI
เมื่อแอปไคลเอ็นต์ส่งคำขอฟีดที่ไม่ได้ตรวจสอบสิทธิ์ แอปจะได้รับ ประเภทของฟีดใดก็ตามที่เจ้าของบล็อกได้ระบุไว้
แต่เมื่อแอปไคลเอ็นต์ส่งคำขอที่ตรวจสอบสิทธิ์แล้ว ระบบจะดำเนินการ จะได้รับฟีดแบบสมบูรณ์ ไม่ว่าเจ้าของบล็อกจะระบุอะไรก็ตาม
ข้อมูลอ้างอิงพารามิเตอร์การค้นหาของ Blogger
Blogger Data API รองรับพารามิเตอร์การค้นหาของ Google Data API มาตรฐานเกือบทั้งหมด
Blogger ไม่รองรับพารามิเตอร์ q (การค้นหาข้อความ) และ
author
พารามิเตอร์การค้นหา updated-min และ updated-max
จะถูกละเว้น เว้นแต่จะตั้งค่าพารามิเตอร์ orderby เป็น
updated ตัวอย่างเช่น URL ต่อไปนี้เรียกข้อมูลบล็อกทั้งหมด
โพสต์ที่ได้รับการอัปเดตจาก 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
Blogger Data API ใช้เฉพาะองค์ประกอบ Atom มาตรฐาน ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดรูปแบบการเผยแพร่ของ Atom 1.0 และโปรโตคอลการเผยแพร่ Atom
ส่วนที่เหลือของส่วนนี้จะแสดงหมายเหตุเฉพาะ 2 รายการเกี่ยวกับการใช้องค์ประกอบมาตรฐานบางอย่างของ Blogger
รายการฉบับร่าง
รายการบล็อกฉบับร่างมีการทำเครื่องหมายโดยใช้ <app:draft>
องค์ประกอบส่วนขยายที่กำหนดไว้ในเอกสาร Atom Publishing Protocol ตัวอย่างรายการฉบับร่างมีดังนี้
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
หากไม่ได้ระบุองค์ประกอบ <draft> รายการก็จะไม่มี
ร่างจดหมาย
วันที่ตีพิมพ์และวันที่ที่อัปเดต
การประทับเวลาที่ระบุใน <published> ของ Atom มาตรฐาน
สอดคล้องกับ "วันที่โพสต์" ที่ผู้ใช้สามารถตั้งค่าในส่วน
GUI ของ Blogger
เมื่อลูกค้าสร้างรายการใหม่ หากลูกค้าไม่ได้ระบุค่า
สำหรับ <published> บล็อกเกอร์จะกำหนดวันที่โพสต์ของรายการเป็น
เวลาของเซิร์ฟเวอร์ปัจจุบัน เมื่อลูกค้าแก้ไขรายการ แต่ไม่ได้ระบุ
<published> ค่า, Blogger จะไม่ใช้วันที่โพสต์ของรายการ
โดดเดี่ยว
อย่างไรก็ตาม หากลูกค้าระบุค่าสำหรับองค์ประกอบ <published> เมื่อสร้างหรือแก้ไขรายการ Blogger จะตั้งค่าวันที่โพสต์ของรายการเป็นค่าที่ระบุ สิ่งนี้อาจมีประโยชน์
สำหรับงานต่างๆ เช่น การนำเข้ารายการเก่าจากระบบบล็อกอื่น (ในขณะที่เก็บ
วันที่สร้างดั้งเดิม)
Blogger ใช้องค์ประกอบ <updated> ของ Atom มาตรฐานเพื่อ
ระบุว่ารายการมีการเปลี่ยนแปลงล่าสุดเมื่อใด ลูกค้าของคุณไม่สามารถควบคุม
<updated> ค่า บล็อกเกอร์จะกำหนดการอัปเดตล่าสุดของรายการเสมอ
วันที่กับเวลาของเซิร์ฟเวอร์ปัจจุบันเมื่อใดก็ตามที่ไคลเอ็นต์ของคุณโพสต์หรือแก้ไข
รายการ
คุณสามารถใช้ Google Data API มาตรฐาน published-min
published-max, updated-min และ
updated-max พารามิเตอร์การค้นหาที่จะขอรายการตาม
<published> หรือ <updated> อย่างไรก็ตาม
สำหรับหมายเหตุเกี่ยวกับการสอบถามวันที่อัปเดต โปรดดูบล็อกเกอร์
การอ้างอิงพารามิเตอร์การค้นหา
การลิงก์ความคิดเห็นกับโพสต์
การส่งออกBlogger
form มีทั้งโพสต์และรายการความคิดเห็นในเอกสารฟีด Atom เดียว
ในการแยกความแตกต่างระหว่างรายการทั้ง 2 ประเภท Blogger จะใช้
องค์ประกอบ <atom:category> องค์ประกอบนี้จะมีพารามิเตอร์ term ที่แสดงว่ารายการนั้นสำหรับโพสต์หรือความคิดเห็น
นอกจากนี้ การลิงก์รายการความคิดเห็นกับรายการโพสต์ที่ความคิดเห็นนั้นอยู่จะทําได้โดยใช้ส่วนขยายชุดข้อความ Atom ใน
ตัวอย่างด้านล่างแสดงองค์ประกอบ <thr:in-reply-to> ในความคิดเห็น
รายการจะชี้ไปยังโพสต์ โดยใช้ตัวระบุรายการโพสต์ใน
พารามิเตอร์ ref และยังเชื่อมโยงกับ URL แบบ HTML ของโพสต์ผ่าน
พารามิเตอร์ href
<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>