Penting: Ini adalah versi lama halaman ini. Untuk versi terbaru, gunakan link di menu navigasi samping kiri.
Dokumen ini memberikan dokumentasi referensi mendetail untuk protokol mentah (XML dan HTTP) untuk Blogger Data API.
Dokumen ini tidak berisi informasi tentang library klien bahasa pemrograman. Untuk informasi referensi {i>client-library<i}, lihat link dari bagian khusus bahasa pemrograman dari panduan developer.
Daftar Isi
Audiens
Dokumen ini ditujukan bagi programmer yang ingin menulis aplikasi klien yang dapat berinteraksi dengan Blogger.
Ini adalah dokumen referensi; ia mengasumsikan bahwa Anda memahami konsep yang disajikan dalam panduan developer, dan ide umum di balik Google Data API protokol yang sama.
Jenis feed Blogger
Blogger menyediakan dua representasi konten blog dalam feed: feed lengkap dan feed ringkasan. Feed lengkap berisi postingan blog lengkap, sedangkan feed ringkasan hanya berisi cuplikan singkat dari setiap postingan.
Pemilik blog dapat menentukan, menggunakan setelan GUI, apakah blog menyediakan feed lengkap atau feed ringkasan ke sindikator dan agregator.
Saat aplikasi klien mengirimkan permintaan yang tidak diautentikasi untuk feed, aplikasi akan menerima jenis feed apa pun yang telah ditentukan oleh pemilik blog.
Namun, saat aplikasi klien Anda mengirim permintaan yang diautentikasi, aplikasi tersebut selalu menerima feed lengkap, terlepas dari apa yang telah ditentukan pemilik blog.
Referensi parameter kueri Blogger
Blogger Data API mendukung hampir semua parameter kueri Google Data API standar.
Blogger tidak mendukung parameter q (penelusuran teks) dan
author.
Parameter kueri updated-min dan updated-max
akan diabaikan kecuali jika parameter orderby ditetapkan ke
updated. Misalnya, URL berikut mengambil semua postingan
blog yang telah diperbarui dari 16 Maret 2008 hingga 24 Maret 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
Referensi elemen Blogger
Blogger Data API hanya menggunakan elemen Atom standar; untuk informasi selengkapnya, lihat Atom Spesifikasi format sindikasi 1.0 dan Atom Publishing Protocol.
Selanjutnya, bagian ini memberikan beberapa catatan khusus tentang penggunaan beberapa elemen standar.
Entri draf
Entri blog draf ditandai menggunakan elemen ekstensi <app:draft>
yang ditentukan dalam dokumen Atom Publishing Protocol. Berikut adalah
contoh entri draf:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Jika tidak ada elemen <draft> yang ditentukan, entri tersebut bukan
draf.
Tanggal publikasi dan tanggal diperbarui
Stempel waktu yang diberikan dalam elemen <published> Atom standar
sesuai dengan "tanggal postingan" yang dapat ditetapkan pengguna di
GUI Blogger.
Saat klien membuat entri baru, jika klien tidak menentukan nilai
untuk <published>, maka Blogger menetapkan tanggal postingan entri menjadi
waktu server saat ini. Jika klien Anda mengedit entri, tetapi tidak menentukan nilai <published>, Blogger tidak akan mengubah tanggal posting entri.
Namun, jika klien Anda menentukan nilai untuk
<published> saat membuat atau mengedit entri, lalu
Blogger menetapkan tanggal postingan entri ke nilai yang ditentukan. Hal ini dapat bermanfaat
untuk tugas seperti mengimpor entri lama dari sistem {i>blogging <i}lain (sambil menyimpan
tanggal pembuatan awal).
Blogger menggunakan elemen <updated> Atom standar untuk
menunjukkan kapan entri
terakhir diubah. Klien Anda tidak dapat mengontrol
Nilai <updated>; Blogger selalu menetapkan entri terakhir yang diperbarui
ke waktu server saat ini, kapan pun klien memposting atau mengedit
entri.
Anda dapat menggunakan Google Data API standar published-min,
published-max, updated-min, dan
updated-max parameter kueri untuk meminta entri berdasarkan
Nilai <published> atau <updated>. Namun,
untuk catatan tentang kueri pada tanggal yang diperbarui, lihat Blogger
referensi parameter kueri.
Menautkan komentar ke postingan
Ekspor Blogger
format berisi postingan dan entri komentar dalam satu dokumen feed Atom.
Untuk membedakan antara dua jenis entri, Blogger menggunakan
Elemen <atom:category>. Elemen ini akan memiliki
parameter term yang mencerminkan apakah entri tersebut untuk postingan atau
komentar.
Selain itu, menautkan entri komentar ke entri postingannya akan
dicapai melalui penggunaan Atom Threading Extension. Dalam
contoh di bawah, elemen <thr:in-reply-to> dalam entri
komentar akan mengarah ke postingan menggunakan ID entri postingan dalam
parameter ref. Tag tersebut juga menautkan ke URL HTML postingan melalui
Parameter 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>