Penting: Ini adalah versi lama halaman ini. Untuk versi terbaru, gunakan link di menu navigasi sebelah kiri.
Dokumen ini memberikan dokumentasi referensi yang mendetail untuk protokol mentah (XML dan HTTP) untuk Blogger Data API.
Dokumen ini tidak berisi informasi tentang library klien dalam bahasa pemrograman. Untuk informasi referensi library klien, lihat link dari bagian khusus bahasa pemrograman di panduan developer.
Daftar Isi
Audiens
Dokumen ini ditujukan untuk programmer yang ingin menulis aplikasi klien yang dapat berinteraksi dengan Blogger.
Ini adalah dokumen referensi; dengan asumsi bahwa Anda memahami konsep yang disajikan dalam panduan developer, serta ide-ide umum di balik protokol Google Data API.
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 tersebut menyediakan feed lengkap atau feed ringkasan untuk sintaksis dan agregator.
Saat aplikasi klien Anda mengirimkan permintaan feed yang tidak diautentikasi, aplikasi tersebut akan menerima jenis feed apa pun yang telah ditentukan pemilik blog.
Namun, saat aplikasi klien Anda mengirimkan permintaan yang diautentikasi, aplikasi tersebut akan selalu menerima feed lengkap, terlepas dari hal 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
diabaikan kecuali jika parameter orderby
ditetapkan ke updated
. Misalnya, URL berikut mengambil semua postingan blog
yang telah diperbarui dari tanggal 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 spesifikasi format sindikasi Atom 1.0 dan Protokol Penerbitan Atom.
Bagian lainnya memberikan beberapa catatan spesifik tentang penggunaan beberapa elemen standar oleh Blogger.
Entri draf
Entri draf blog ditandai menggunakan elemen ekstensi <app:draft>
yang ditentukan dalam dokumen Protokol Penerbitan Atom. 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, entrinya bukan
draf.
Tanggal publikasi dan tanggal pembaruan
Stempel waktu yang diberikan dalam elemen <published>
Atom standar
sesuai dengan "tanggal postingan" yang dapat disetel oleh pengguna di
GUI Blogger.
Saat klien Anda membuat entri baru, jika klien tidak menentukan nilai untuk <published>
, Blogger akan menetapkan tanggal postingan entri ke waktu server saat ini. Saat klien mengedit entri tetapi tidak menentukan nilai
<published>
, Blogger tidak akan memasukkan
tanggal postingan entri.
Namun, jika klien Anda menentukan nilai untuk
elemen <published>
saat membuat atau mengedit entri, Blogger akan menyetel tanggal postingan entri ke nilai yang ditentukan. Hal ini dapat berguna untuk tugas-tugas seperti mengimpor entri lama dari sistem blogging lainnya (sambil mempertahankan tanggal pembuatan asli).
Blogger menggunakan elemen <updated>
Atom standar untuk
menunjukkan kapan entri terakhir diubah. Klien Anda tidak dapat mengontrol
nilai <updated>
; Blogger selalu menetapkan tanggal entri terakhir
diperbarui ke waktu server saat ini setiap kali klien Anda memposting atau mengedit
entri.
Anda dapat menggunakan parameter kueri Google Data API standar seperti published-min
, published-max
, updated-min
, dan updated-max
untuk meminta entri berdasarkan nilai <published>
atau <updated>
miliknya. Namun,
untuk catatan tentang pembuatan kueri pada tanggal yang diperbarui, lihat Referensi
parameter kueri Blogger.
Menautkan komentar ke postingan
Format
ekspor Blogger berisi entri komentar dan postingan dalam satu dokumen feed Atom.
Untuk membedakan antara dua jenis entri ini, Blogger menggunakan
elemen <atom:category>
. Elemen ini akan memiliki parameter term
yang mencerminkan apakah entri adalah postingan atau komentar.
Selain itu, menautkan entri komentar ke entri postingan yang disertakan akan diselesaikan melalui penggunaan Ekstensi Threading Atom. Pada
contoh di bawah, elemen <thr:in-reply-to>
dalam entri
komentar akan mengarah ke postingan menggunakan ID entri postingan di
parameter ref
. URL ini juga tertaut 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>