Penting: Ini adalah versi lama halaman ini. Untuk versi terbaru, gunakan link di menu navigasi sebelah 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 library klien, lihat link dari bagian khusus bahasa pemrograman di panduan developer.
Daftar Isi
Audiens
Dokumen ini ditujukan bagi programmer yang ingin menulis aplikasi klien yang dapat berinteraksi dengan Blogger.
Panduan ini adalah dokumen referensi; yang mengasumsikan bahwa Anda memahami konsep yang disajikan dalam panduan developer, dan ide umum di balik protokol Google Data API.
Jenis feed Blogger
Blogger memberikan 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 untuk sindikator dan agregator.
Saat mengirim permintaan yang tidak diautentikasi oleh aplikasi klien, aplikasi akan menerima jenis feed apa pun yang telah ditentukan oleh pemilik blog.
Namun, saat mengirim permintaan yang telah diautentikasi, aplikasi klien akan selalu menerima feed lengkap, terlepas dari apa yang telah ditentukan oleh 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 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 mengetahui informasi selengkapnya, lihat spesifikasi format sindikasi Atom 1.0 dan Atom Publishing Protocol.
Bagian selanjutnya memberikan beberapa catatan khusus tentang penggunaan beberapa elemen standar oleh Blogger.
Entri draf
Draf entri blog 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, berarti entri tersebut bukan
draf.
Tanggal publikasi dan tanggal terbaru
Stempel waktu yang diberikan dalam elemen <published>
Atom standar sesuai dengan "tanggal posting" yang dapat ditetapkan pengguna di GUI Blogger.
Saat klien 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 membiarkan tanggal postingan entri
saja.
Namun, jika klien Anda menentukan nilai untuk elemen <published>
saat membuat atau mengedit entri, Blogger menetapkan tanggal postingan entri ke nilai yang ditentukan. Cara ini berguna untuk tugas seperti mengimpor entri lama dari sistem blogging lain (sekaligus 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 published-min
, published-max
, updated-min
, dan updated-max
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 dua jenis entri tersebut, Blogger menggunakan
elemen <atom:category>
. Elemen ini akan memiliki parameter term
yang mencerminkan apakah entri tersebut ditujukan untuk postingan atau komentar.
Selain itu, penautan entri komentar ke entri postingannya dapat dilakukan 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 dalam
parameter ref
. Kode ini 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>