Penting: Ini adalah versi lama halaman ini. Untuk versi terbaru, gunakan link di menu navigasi samping kiri.
Dokumen ini menyediakan 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 library klien, lihat link dari bagian khusus bahasa pemrograman dalam panduan developer.
Daftar Isi
Audiens
Dokumen ini ditujukan untuk programmer yang ingin menulis aplikasi klien yang dapat berinteraksi dengan Blogger.
Dokumen ini adalah dokumen referensi; dokumen ini mengasumsikan bahwa Anda memahami konsep yang disajikan dalam panduan developer, dan 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 menyediakan feed lengkap atau feed ringkasan kepada penayang dan agregator.
Saat aplikasi klien Anda mengirim permintaan yang tidak diautentikasi untuk feed, aplikasi tersebut 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 spesifikasi format distribusi Atom 1.0 dan Atom Publishing Protocol.
Bagian selanjutnya memberikan beberapa catatan khusus tentang penggunaan Blogger terhadap 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>, Blogger akan menetapkan tanggal posting entri ke
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 elemen <published> saat membuat atau mengedit entri, Blogger akan menetapkan tanggal posting entri ke nilai yang ditentukan. Hal ini dapat berguna
untuk tugas seperti mengimpor entri lama dari sistem blog lain (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 pembaruan terakhir
entri ke waktu server saat ini setiap kali klien Anda memposting atau mengedit
entri.
Anda dapat menggunakan parameter kueri Google Data API published-min,
published-max, updated-min, dan
updated-max standar untuk meminta entri berdasarkan
nilai <published> atau <updated>. Namun,
untuk catatan tentang kueri pada tanggal yang diperbarui, lihat Referensi parameter kueri Blogger.
Menautkan komentar ke postingan
Format ekspor Blogger berisi entri postingan dan komentar dalam satu dokumen feed Atom.
Untuk membedakan antara kedua jenis entri, Blogger menggunakan
elemen <atom:category>. Elemen ini akan memiliki
parameter term yang mencerminkan apakah entri tersebut untuk postingan atau
komentar.
Selain itu, penautan entri komentar ke entri postingan yang terkait
dilakukan 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. URL ini juga ditautkan 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>