Penting: Kami akan menghentikan dukungan untuk Google Data API v2.0 pada 30 September 2024. Agar dapat terus berfungsi, update aplikasi Anda yang mengandalkan Google Data API v2.0 ke versi API terbaru. Untuk versi terbaru, gunakan link di menu navigasi sebelah kiri. Catatan: meskipun beberapa permintaan GET (seperti postingan listingan) akan terus didukung sebagai URL feed, ada perbedaan kecil dalam perilakunya. Untuk informasi selengkapnya, lihat dokumentasi Bantuan Blogger.
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.
Konten
Audiens
Dokumen ini ditujukan untuk programmer yang ingin menulis aplikasi klien yang dapat berinteraksi dengan Blogger.
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 pendek dari setiap postingan.
Pemilik blog dapat menentukan, menggunakan setelan GUI, apakah blog menyediakan feed lengkap atau feed ringkasan untuk sindikasi dan agregator.
Ketika aplikasi klien Anda mengirimkan permintaan feed yang tidak diautentikasi, aplikasi akan menerima jenis feed apa pun yang telah ditentukan oleh pemilik blog.
Namun, ketika aplikasi klien Anda mengirimkan permintaan yang diautentikasi, aplikasi tersebut 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 author.
Parameter kueri updated-min dan updated-max
diabaikan kecuali 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://www.w3.org/2007/app'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Jika tidak ada elemen <draft> yang ditentukan, entri 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 postingan entri ke
waktu server saat ini. Saat klien Anda mengedit entri, tetapi tidak menentukan
nilai <published>, Blogger akan membiarkan tanggal postingan entri
saja.
Namun, jika klien Anda menentukan nilai untuk
elemen <published> saat membuat atau mengedit entri, maka
Blogger menetapkan tanggal postingan entri ke nilai yang ditentukan. Hal ini dapat berguna untuk tugas-tugas seperti mengimpor entri lama dari sistem blogging lain (dengan tetap mempertahankan tanggal pembuatan aslinya).
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 published-min, published-max, updated-min, dan updated-max Google Data API standar untuk meminta entri berdasarkan nilai <published> atau <updated>-nya. 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 tersebut, 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 miliknya dapat dilakukan melalui penggunaan Atom Threading Extension. Pada contoh di bawah, elemen <thr:in-reply-to> dalam entri komentar akan mengarah ke postingan menggunakan ID entri postingan di parameter ref. Tag ini juga menautkan ke URL HTML postingan melalui parameter href.
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
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 comment</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>