Panduan Developer: Protokol

Penting: Ini adalah versi lama halaman ini. Untuk versi terbaru, gunakan link di menu navigasi sebelah kiri.

Blogger Data API memungkinkan aplikasi klien melihat dan memperbarui konten Blogger dalam bentuk feed Google Data API.

Aplikasi klien Anda dapat menggunakan Blogger Data API untuk membuat postingan blog baru, mengedit atau menghapus postingan blog yang sudah ada, dan membuat kueri untuk postingan blog yang sesuai dengan kriteria tertentu.

Selain menyediakan beberapa latar belakang tentang kemampuan Blogger Data API, dokumen ini memberikan contoh interaksi Data API dasar menggunakan XML dan HTTP mentah. Setelah membaca dokumen ini, Anda mungkin ingin mempelajari lebih lanjut cara berinteraksi dengan API menggunakan library klien kami dengan membaca bagian khusus bahasa pemrograman dari panduan developer ini.

Daftar Isi

  1. Penonton
  2. Memulai
    1. Membuat akun Blogger
  3. Mengautentikasi ke layanan Blogger
    1. Autentikasi proxy AuthSub
    2. Autentikasi nama pengguna/sandi ClientLogin
  4. Mengambil daftar blog
  5. Membuat postingan
    1. Memublikasikan postingan blog
    2. Membuat draf postingan blog
  6. Mengambil postingan
    1. Mengambil semua postingan blog
    2. Mengambil postingan menggunakan parameter kueri
  7. Memperbarui postingan
  8. Menghapus postingan
  9. Komentar
    1. Membuat komentar
    2. Mengambil komentar
    3. Menghapus komentar
  10. Format ekspor

Audiens

Dokumen ini ditujukan untuk programmer yang ingin menulis aplikasi klien yang dapat berinteraksi dengan Blogger menggunakan XML dan HTTP.

Dokumen ini mengasumsikan bahwa Anda memahami ide-ide umum di balik protokol Google Data API.

Jika Anda menggunakan sistem UNIX dan ingin mencoba contoh dalam dokumen ini tanpa menulis kode, utilitas baris perintah UNIX curl atau wget mungkin berguna untuk Anda; untuk informasi lebih lanjut, lihat halaman manual untuk utilitas tersebut.

Untuk informasi referensi Blogger Data API, lihat Panduan referensi protokol.

Memulai

Membuat akun Blogger

Anda dapat mendaftar ke akun Blogger untuk tujuan pengujian. Blogger menggunakan Akun Google, jadi jika Anda sudah memiliki Akun Google, berarti Anda sudah siap.

Mengautentikasi ke layanan Blogger

Anda dapat mengakses feed publik dan pribadi menggunakan Blogger Data API. Feed publik tidak memerlukan autentikasi apa pun, tetapi bersifat hanya baca. Jika Anda ingin mengubah blog, klien Anda perlu melakukan autentikasi sebelum meminta feed pribadi. Autentikasi dapat dilakukan menggunakan salah satu dari dua pendekatan berikut: autentikasi proxy AuthSub atau autentikasi nama pengguna/sandi ClientLogin.

Untuk informasi selengkapnya tentang autentikasi dengan Google Data API secara umum, lihat dokumentasi autentikasi.

Sebagian besar sampel di bagian berikutnya pada dokumen ini mengasumsikan bahwa Anda memberikan autentikasi yang sesuai.

Autentikasi proxy AuthSub

Autentikasi proxy AuthSub digunakan oleh aplikasi web yang perlu mengautentikasi pengguna ke Akun Google. Operator situs dan kode klien tidak memiliki akses ke nama pengguna dan sandi untuk pengguna Blogger; sebagai gantinya, klien mendapatkan token AuthSub khusus yang memungkinkan klien untuk bertindak atas nama pengguna tertentu. Untuk mengetahui informasi yang lebih detail, lihat dokumentasi AuthSub.

Saat pertama kali mengunjungi aplikasi Anda, pengguna belum diautentikasi. Dalam hal ini, Anda perlu menampilkan beberapa informasi dan link yang mengarahkan pengguna ke halaman Google untuk mengautentikasi permintaan Anda agar dapat mengakses blog mereka.

Parameter kueri berikut disertakan di URL AuthSubRequest:

berikutnya
URL halaman tempat Google akan mengalihkan pengguna setelah autentikasi.
cakupan
Menunjukkan bahwa aplikasi meminta token untuk mengakses feed Blogger. String cakupan yang digunakan adalah http://www.blogger.com/feeds/ (tentu saja dienkode ke URL).
aman
Menunjukkan apakah klien meminta token aman.
sesi
Menunjukkan apakah token yang ditampilkan dapat ditukarkan dengan token multi-penggunaan (sesi).

URL AuthSubRequest mungkin terlihat seperti ini:

https://www.google.com/accounts/AuthSubRequest?scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F&session=1&secure=0&next=http%3A%2F%2Fwww.example.com%2Fwelcome.html

Pengguna mengikuti link ke situs Google dan mengautentikasi ke Akun Google mereka.

Setelah pengguna melakukan autentikasi, sistem AuthSub akan mengalihkan mereka ke URL yang Anda tentukan dalam parameter kueri next dari URL AuthSubRequest. Sistem AuthSub menambahkan token autentikasi ke URL tersebut, sebagai nilai parameter kueri token. Contoh:

http://www.example.com/welcome.html?token=yourAuthToken

Nilai token ini mewakili token AuthSub satu kali pakai. Dalam contoh ini, karena session=1 ditentukan, token ini dapat ditukarkan dengan token sesi AuthSub dengan memanggil layanan AuthSubSessionToken dengan token sekali pakai di header Authorization, seperti berikut:

GET /accounts/AuthSubSessionToken HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: AuthSub token="yourAuthToken"
User-Agent: Java/1.5.0_06
Host: www.google.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive

Respons layanan AuthSubSessionToken mencakup header Token yang berisi token sesi dan header Expiration yang menunjukkan berapa lama token akan tetap valid.

Aplikasi Anda kemudian dapat menggunakan nilai token sesi di header Authorization interaksi berikutnya dengan Blogger.

Berikut adalah contoh permintaan HTTP, yang berisi token tidak aman, yang mungkin Anda kirim ke Blogger:

GET /feeds/blogID/blogs/posts/defaults HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: AuthSub token="yourSessionToken"
User-Agent: Java/1.5.0_06
Host: www.blogger.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive

Autentikasi nama pengguna/sandi ClientLogin

Gunakan autentikasi ClientLogin jika klien Anda adalah klien mandiri yang tidak diinstal (seperti aplikasi desktop). Untuk meminta token autentikasi menggunakan mekanisme ClientLogin, kirim permintaan POST ke URL berikut:

https://www.google.com/accounts/ClientLogin

Isi POST harus berisi kumpulan parameter kueri yang terlihat seperti parameter yang diteruskan oleh formulir HTML, menggunakan jenis konten application/x-www-form-urlencoded. Parameter tersebut adalah:

Email
Alamat email pengguna.
Kode sandi
Sandi pengguna.
layanan
Nama layanan Blogger adalah blogger. (Untuk nama layanan lainnya, lihat daftar nama layanan.)
jenisAkun
Nilai ini harus selalu ditetapkan ke GOOGLE saat menggunakan Blogger API. Kegagalan untuk menetapkan parameter ini akan mencegah akses oleh pengguna yang juga memiliki akun G Suite.
source
Mengidentifikasi aplikasi klien Anda. Harus berupa companyName-applicationName-versionID. Contoh menggunakan nama exampleCo-exampleApp-1.

Untuk informasi selengkapnya tentang parameter, lihat dokumen Authentication untuk Aplikasi yang Diinstal.

Jika permintaan autentikasi gagal, server akan menampilkan kode status HTTP 403 Forbidden.

Jika berhasil, server akan menampilkan kode status HTTP 200 OK, ditambah tiga kode alfanumerik panjang dalam isi respons: SID, LSID, dan Auth. Nilai Auth adalah token otorisasi yang akan Anda kirim ke Blogger dengan setiap permintaan berikutnya, jadi simpan salinan nilai tersebut. Anda dapat mengabaikan nilai SID dan LSID.

Karena semua permintaan ke feed pribadi memerlukan autentikasi, Anda harus menetapkan header Authorization di semua interaksi berikutnya dengan Blogger, menggunakan format berikut:

Authorization: GoogleLogin auth=yourAuthToken

yourAuthToken adalah string Auth yang ditampilkan oleh permintaan ClientLogin.

Untuk informasi selengkapnya tentang autentikasi ClientLogin, termasuk contoh permintaan dan respons, lihat dokumentasi Autentikasi untuk Aplikasi yang Terinstal.

Catatan: Gunakan token yang sama untuk semua permintaan di sesi tertentu; jangan dapatkan token baru untuk setiap permintaan Blogger.

Catatan: Seperti yang dijelaskan dalam dokumentasi ClientLogin, permintaan autentikasi mungkin gagal dan meminta verifikasi CAPTCHA. Jika Anda ingin Google mengeluarkan dan menangani verifikasi CAPTCHA, kirimkan pengguna ke https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger (bukan ke URL penanganan CAPTCHA yang diberikan dalam dokumentasi ClientLogin).

Mengambil daftar blog

Blogger Data API menyediakan feed yang mencantumkan blog untuk pengguna tertentu; feed tersebut dikenal sebagai "metafeed."

Kirim GET HTTP ke URL berikut untuk mengambil daftar blog:

http://www.blogger.com/feeds/userID/blogs

Catatan: Anda juga dapat mengganti default dengan ID pengguna, yang memberi tahu Blogger untuk menampilkan daftar blog untuk pengguna yang kredensialnya menyertai permintaan.

Entri dalam metafeed dapat terlihat seperti ini:

<entry>
  <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
  <published>2006-08-02T18:44:43.089-07:00</published>
  <updated>2006-11-08T18:10:23.020-08:00</updated>
  <title type='text'>Lizzy's Diary</title>
  <summary type='html'>Being the journal of Elizabeth Bennet</summary>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/'>
  </link>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://www.blogger.com/feeds/userID/blogs/blogID'>
  </link>
  <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/userID/blogs/blogID'>
  </link>
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
</entry>

Untuk mengetahui informasi tentang arti setiap elemen tersebut, lihat dokumen Referensi Protokol Google Data API atau spesifikasi Atom 1.0.

Jika permintaan Anda gagal karena beberapa alasan, Blogger dapat menampilkan kode status yang berbeda. Informasi selengkapnya tentang kode status HTTP juga tersedia dalam dokumen Referensi Protokol Google Data API.

Membuat postingan

Dengan Blogger Data API, Anda dapat membuat dan memublikasikan entri blog baru, serta membuat draf entri.

Memublikasikan postingan blog

Setelah mengautentikasi, Anda dapat memublikasikan entri blog baru.

Pertama, buat representasi XML postingan yang akan dipublikasikan. XML ini harus berbentuk elemen <entry> Atom, yang mungkin terlihat seperti ini:

<entry xmlns='http://www.w3.org/2005/Atom'>
  <title type='text'>Marriage!</title>
  <content type='xhtml'>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p>Mr. Darcy has <em>proposed marriage</em> to me!</p>
      <p>He is the last man on earth I would ever desire to marry.</p>
      <p>Whatever shall I do?</p>
    </div>
  </content>
  <category scheme="http://www.blogger.com/atom/ns#" term="marriage" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
</entry>

Catatan: Menyetel penulis kustom untuk postingan saat ini tidak didukung. Semua postingan baru akan muncul seolah-olah dibuat oleh pengguna yang saat ini terautentikasi.

Untuk memublikasikan entri ini, kirimkan ke URL postingan blog sebagai berikut. Pertama, tempatkan elemen <entry> Atom Anda dalam isi permintaan POST baru, menggunakan jenis konten application/atom+xml. Kemudian, temukan URL postingan blog di metafeed dengan mencari elemen <link> tempat atribut rel diakhiri dengan #post. URL postingan blog diberikan sebagai atribut href milik elemen ini, yang dalam format ini:

http://www.blogger.com/feeds/blogID/posts/default

Catatan: URL ini sama dengan URL dalam tag <link rel="service.post"> yang muncul di bagian <head> pada blog versi yang dapat dibaca manusia.

Blogger membuat postingan blog menggunakan entri yang Anda kirim, kemudian menampilkan kode status HTTP 201 CREATED, beserta salinan postingan baru dalam bentuk elemen <entry>. Entri yang ditampilkan sama dengan yang Anda kirim, tetapi juga berisi berbagai elemen yang ditambahkan oleh Blogger, seperti elemen <id>.

Jika permintaan Anda gagal karena beberapa alasan, Blogger dapat menampilkan kode status yang berbeda. Untuk informasi tentang kode status, lihat Dokumen referensi protokol Google Data API.

Membuat postingan blog draf

Postingan draf dibuat dengan cara yang sama seperti postingan publik, tetapi dengan elemen <app:control> yang ditambahkan ke entri yang menunjukkan bahwa postingan belum boleh dipublikasikan.

Elemen <app:control> ini harus berisi satu elemen <app:draft> sebagai turunan:

<app:control xmlns:app='http://purl.org/atom/app#'>
  <app:draft>yes</app:draft>
</app:control>

Data yang terdapat dalam elemen <app:draft> harus berupa string yes agar postingan dapat dikenali sebagai draf.

Anda dapat mengubah postingan blog draf yang sudah ada menjadi postingan yang dipublikasikan dengan mengambil postingan draf, menyetel data elemen <app:draft> ke string no, lalu memperbarui postingan tersebut. Pengambilan dan pembaruan postingan dibahas di dua bagian berikutnya.

Catatan: Untuk informasi selengkapnya tentang Protokol Publikasi Atom, termasuk namespace <app:control> dan <app:draft>, lihat RFC 5023.

Mengambil postingan

Bagian berikut ini menjelaskan cara mengambil daftar postingan blog, dengan dan tanpa parameter kueri.

Anda dapat mengajukan kueri feed publik Blogger tanpa autentikasi. Oleh karena itu, Anda tidak perlu menetapkan parameter Otorisasi saat mengambil postingan blog dari blog publik.

Mengambil semua postingan blog

Untuk mengambil postingan pengguna, kirim permintaan GET HTTP ke URL feed blog. Blogger kemudian menampilkan feed yang berisi entri blog yang sesuai. Misalnya, untuk mendapatkan daftar postingan blog bagi liz@gmail.com, kirim permintaan HTTP berikut ke Blogger (tentu saja dengan nilai yang sesuai blogID):

GET http://www.blogger.com/feeds/blogID/posts/default

Blogger kemudian menampilkan kode status HTTP 200 OK dan feed Atom 1.0 standar yang berisi postingan blog.

Berikut adalah contoh feed untuk blog yang hanya memiliki satu postingan. Perhatikan bahwa kami sedikit mengedit contoh ini agar sedikit lebih mudah dibaca oleh manusia. Secara khusus, feed Blogger yang sebenarnya berisi ID dan URL yang sebenarnya.

<feed xmlns='http://www.w3.org/2005/Atom'>
  <id>tag:blogger.com,1999:blog-blogID</id>
  <updated>2006-11-08T18:10:23.020-08:00</updated>
  <title type='text'>Lizzy's Diary</title>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/index.html'>
  </link>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default'>
  </link>
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
  <generator version='7.00' uri='http://www2.blogger.com'>Blogger</generator>
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <published>2006-11-08T18:10:00.000-08:00</published>
    <updated>2006-11-08T18:10:14.954-08:00</updated>
    <title type='text'>Quite disagreeable</title>
    <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
      this evening. I found him quite disagreeable.&lt;/p&gt;</content>
    <link rel='alternate' type='text/html'
      href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
    </link>
    <link rel='self' type='application/atom+xml'
      href='http://blogName.blogspot.com/feeds/posts/default/postID'>
    </link>
    <link rel='edit' type='application/atom+xml'
      href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
    </link>
    <author>
      <name>Elizabeth Bennet</name>
      <email>noreply@blogger.com</email>
      <uri>http://www.blogger.com/profile/profileID</uri>
    </author>
  </entry>
</feed>

Mengambil postingan menggunakan parameter kueri

Blogger Data API memungkinkan Anda meminta serangkaian entri yang cocok dengan kriteria yang ditentukan, seperti meminta postingan blog yang dipublikasikan atau diperbarui dalam rentang tanggal tertentu.

Misalnya, untuk mengirim kueri rentang tanggal, tambahkan parameter published-min dan published-max ke URL permintaan. Untuk mendapatkan semua entri blog yang dibuat antara tanggal 16 Maret 2008 hingga 24 Maret 2008, kirim permintaan HTTP ke URL feed blog:

GET http://www.blogger.com/feeds/blogID/posts/default?published-min=2008-03-16T00:00:00&published-max=2008-03-24T23:59:59

Saat Anda mengirim permintaan GET tersebut, Blogger akan menampilkan kode status HTTP 200 OK dan feed yang berisi postingan blog apa pun yang dibuat dalam rentang tanggal yang Anda tentukan.

Parameter updated-min dan updated-max juga dapat digunakan untuk mendapatkan semua entri blog yang diupdate dalam rentang tertentu. Namun, perhatikan bahwa parameter ini diabaikan kecuali jika parameter orderby juga ditetapkan ke updated.

Blogger Data API mendukung parameter kueri berikut:

alt
Jenis feed yang akan ditampilkan, seperti atom (default) atau rss.
/category
Menentukan kategori (juga dikenal sebagai label) untuk memfilter hasil feed. Misalnya, http://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie menampilkan entri dengan label Fritz dan Laurie.
hasil maks
Jumlah maksimum entri yang akan ditampilkan.
praorder
Urutan yang menampilkan entri, seperti lastmodified (default), starttime, atau updated.
dipublikasikan-min, dipublikasikan-maks
Batas pada tanggal publikasi entri.
indeks awal
Indeks berbasis 1 dari hasil pertama yang akan diambil (untuk paging).
diperbarui-menit, diperbarui-maks
Batas pada tanggal update entri. Parameter kueri ini diabaikan kecuali jika parameter orderby disetel ke updated.

Untuk informasi selengkapnya tentang parameter kueri, lihat Panduan Referensi Blogger Data API dan Panduan Referensi Google Data API.

Memperbarui postingan

Untuk memperbarui postingan blog yang sudah ada, pertama-tama, ambil entri yang ingin Anda perbarui, lalu Anda ubah, lalu kirim permintaan PUT, dengan entri yang diperbarui dalam isi pesan, ke URL edit postingan. Pastikan nilai <id> pada entri yang Anda PUT sama persis dengan <id> entri yang ada.

URL yang diedit akan disorot dalam entri berikut:

<entry>
  <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
  <published>2006-11-08T18:10:00.000-08:00</published>
  <updated>2006-11-08T18:10:14.954-08:00</updated>
  <title type='text'>Quite disagreeable</title>
  <content type='html'>&lt;p&gt;I met Mr. Bingley's friend Mr. Darcy
    this evening. I found him quite disagreeable.&lt;/p&gt;</content>
  <link rel='alternate' type='text/html'
    href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
  </link>
  <link rel='self' type='application/atom+xml'
    href='http://blogName.blogspot.com/feeds/posts/default/postID'>
  </link>
  <link rel='edit' type='application/atom+xml'
    href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
  </link>
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Bingley" />
  <category scheme="http://www.blogger.com/atom/ns#" term="Mr. Darcy" />
  <author>
    <name>Elizabeth Bennet</name>
    <email>noreply@blogger.com</email>
    <uri>http://www.blogger.com/profile/profileID</uri>
  </author>
</entry>

PENTING: Untuk memastikan kompatibilitas di masa mendatang, pastikan saat Anda PUT entri yang diperbarui, Anda mempertahankan semua XML yang ada saat mengambil entri dari Blogger. Jika tidak, saat kami menerapkan hal baru dan menyertakan elemen <new-awesome-feature> di feed tersebut, klien Anda tidak akan mengembalikannya dan pengguna akan melewatkannya. Library klien Google Data API menangani hal ini dengan benar, sehingga jika Anda menggunakan salah satu library yang sudah siap.

Catatan: Mengubah data penulis yang terkait dengan postingan saat ini tidak didukung.

Tips Pemecahan Masalah: Beberapa firewall memblokir pesan PUT HTTP. Untuk mengatasi hal ini, Anda dapat menyertakan header X-HTTP-Method-Override: PUT dalam permintaan POST. Untuk mengetahui detailnya, lihat dokumen Dasar-dasar protokol Google Data API.

Menghapus postingan

Untuk menghapus postingan, kirim permintaan DELETE ke URL edit postingan. Ini adalah URL yang sama dengan yang digunakan untuk memperbarui postingan.

Tips Pemecahan Masalah: Beberapa firewall memblokir pesan DELETE HTTP. Untuk mengatasi hal ini, Anda dapat menyertakan header X-HTTP-Method-Override: DELETE dalam permintaan POST. Untuk mengetahui detailnya, lihat dokumen Dasar-dasar protokol Google Data API.

Komentar

Blogger Data API memungkinkan Anda membuat, mengambil, dan menghapus komentar. Memperbarui komentar tidak didukung (juga tidak tersedia di antarmuka web).

Membuat komentar

Untuk memposting komentar, buat elemen <entry> Atom seperti berikut:

  <entry xmlns='http://www.w3.org/2005/Atom'>
    <title type="text">This is my first comment</title>
    <content type="html">This is my first comment</content>
  </entry>

Untuk memublikasikan komentar ini, tempatkan elemen <entry> Atom Anda dalam isi permintaan POST baru, menggunakan jenis konten application/atom+xml. Kemudian, kirim permintaan POST ke URL Blogger yang sesuai:

POST http://www.blogger.com/feeds/blogID/postID/comments/default

Catatan: Saat ini, Anda hanya dapat memposting komentar ke blog milik pengguna yang diautentikasi.

Catatan: Menyetel penulis kustom untuk komentar saat ini tidak didukung. Semua komentar baru akan muncul seolah-olah komentar tersebut dibuat oleh pengguna yang saat ini sudah diautentikasi.

Mengambil komentar

Anda dapat mengambil komentar untuk postingan tertentu dengan mengirimkan GET ke URL feed komentar postingan ini:

GET http://www.blogger.com/feeds/blogID/postID/comments/default

Atau, Anda bisa mendapatkan komentar dari semua postingan menggunakan URL feed komentar blog:

GET http://www.blogger.com/feeds/blogID/comments/default

Permintaan ini menampilkan feed komentar yang terlihat seperti ini:

<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">
  <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
  <updated>2007-04-04T21:56:29.803-07:00</updated>
  <title type="text">My Blog : Time to relax</title>
  <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html"/>
  <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
  <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
  <author>
    <name>Blog Author name</name>
  </author>
  <generator version="7.00" uri="http://www2.blogger.com">Blogger</generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
    <published>2007-04-04T21:56:00.000-07:00</published>
    <updated>2007-04-04T21:56:29.803-07:00</updated>
    <title type="text">This is my first comment</title>
    <content type="html">This is my first comment</content>
    <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html#commentID"/>
    <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default/commentID"/>
    <link rel="edit" type="application/atom+xml" href="http://www.blogger.com/feeds/blogID/postID/comments/default/commentID"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     source="http://www.blogger.com/feeds/posts/default/blogID"
                     type="text/html"/>
    <author>
      <name>Blog Author name</name>
      <email>blog_author@gmail.com</email>
      <uri>http://www.blogger.com/profile/userID</uri>
    </author>
    <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0' 
         href='http://blogName.blogspot.com/2007/04/first-post.html' 
         ref='tag:blogger.com,1999:blog-blogID.post-postID' 
         source='http://blogName.blogspot.com/feeds/posts/default/postID'
         type='text/html' />
  </entry>
</feed>

Menghapus komentar

Untuk menghapus komentar, kirim permintaan DELETE ke URL edit komentar. URL ini disorot dalam feed komentar di atas.

Format ekspor

Blogger memungkinkan pengguna mengekspor dan mengimpor blog mereka menggunakan file ekspor Blogger. File ekspor ini berisi semua postingan dan komentar untuk satu blog. Format file ekspor adalah format Atom yang sama persis yang dijelaskan di bagian untuk mengambil postingan dan komentar. File ekspor ini akan berisi konten dari feed postingan dan konten dari feed komentar yang digabungkan menjadi satu dokumen.

Untuk mengekspor atau mengimpor data blog menggunakan format ekspor, Anda dapat mengunjungi halaman Setelan untuk blog tersebut. Untuk mengambil file ekspor untuk blog menggunakan Data API, gunakan URL berikut:

GET http://www.blogger.com/feeds/blogID/archive

Untuk mengimpor file ekspor, buat permintaan POST ke URL berikut dengan isi file ekspor sebagai data permintaan dan application/atom+xml sebagai jenis konten:

POST http://www.blogger.com/feeds/blogID/archive/full

Tak satu pun dari URL untuk di atas yang mendukung parameter kueri. Kedua permintaan tersebut juga harus berisi informasi autentikasi dan hanya administrator blog yang dapat mengimpor/mengekspor blog menggunakan URL feed ini.

Catatan: Jika Anda membuat file ekspor Blogger sendiri, saat ini ada satu batasan terkait pengurutan entri postingan dan komentar. File ekspor Blogger akan mencantumkan semua postingan terlebih dahulu, lalu semua komentar. Menempatkan entri postingan dan komentar diizinkan selama entri komentar dibuat setelah postingan diberi komentar.

Untuk informasi lebih lanjut tentang cara Blogger menggunakan format Atom di file ekspor, lihat Panduan referensi protokol.

Kembali ke atas