Quan trọng: Đây là phiên bản cũ của trang này. Đối với phiên bản mới nhất, hãy sử dụng các đường liên kết trong thanh điều hướng bên trái.
API Dữ liệu Blogger cho phép các ứng dụng khách xem và cập nhật nội dung trên Blogger dưới dạng nguồn cấp dữ liệu API Dữ liệu của Google.
Ứng dụng khách của bạn có thể sử dụng API Dữ liệu Blogger để tạo bài đăng mới trên blog, chỉnh sửa hoặc xoá bài đăng hiện có trên blog và truy vấn các bài đăng trên blog phù hợp với tiêu chí cụ thể.
Ngoài việc cung cấp một số thông tin cơ bản về khả năng của API dữ liệu Blogger, tài liệu này còn cung cấp ví dụ về các hoạt động tương tác cơ bản với API dữ liệu bằng XML và HTTP thô. Sau khi đọc tài liệu này, bạn có thể tìm hiểu thêm về cách tương tác với API bằng thư viện ứng dụng của chúng tôi bằng cách đọc các phần dành riêng cho ngôn ngữ lập trình trong hướng dẫn dành cho nhà phát triển này.
Nội dung
Đối tượng
Tài liệu này dành cho những lập trình viên muốn viết các ứng dụng máy khách có thể tương tác với Blogger bằng XML và HTTP.
Tài liệu này giả định rằng bạn hiểu được các ý tưởng chung đằng sau giao thức API dữ liệu của Google.
Nếu bạn đang sử dụng hệ thống UNIX và muốn thử các ví dụ trong tài liệu này mà không viết mã, bạn có thể thấy các tiện ích dòng lệnh UNIX curl hoặc wget hữu ích; để biết thêm thông tin, hãy xem trang thủ công cho các tiện ích đó.
Để biết thông tin tham khảo về API Dữ liệu của Blogger, hãy xem Hướng dẫn tham chiếu giao thức.
Bắt đầu
Tạo tài khoản Blogger
Bạn nên đăng ký tài khoản Blogger để tham gia thử nghiệm. Blogger sử dụng Tài khoản Google, do đó, nếu bạn đã có Tài khoản Google, thì bạn đã sẵn sàng.
Xác thực với dịch vụ Blogger
Bạn có thể truy cập vào cả nguồn cấp dữ liệu công khai và riêng tư bằng cách sử dụng Blogger Data API. Nguồn cấp dữ liệu công khai không yêu cầu xác thực nhưng chỉ có thể đọc. Nếu muốn sửa đổi blog, khách hàng của bạn cần xác thực trước khi yêu cầu nguồn cấp dữ liệu riêng tư. Có thể xác thực bằng một trong hai cách: xác thực proxy AuthSub hoặc xác thực tên người dùng/mật khẩu ClientLogin.
Để biết thêm thông tin về việc xác thực bằng API dữ liệu của Google nói chung, hãy xem tài liệu xác thực.
Hầu hết mẫu trong các phần tiếp theo của tài liệu này giả định rằng bạn cung cấp phương thức xác thực phù hợp.
Xác thực proxy AuthSub
Xác thực proxy AuthSub được sử dụng trong các ứng dụng web cần xác thực người dùng với Tài khoản Google. Toán tử trang web và mã ứng dụng khách không có quyền truy cập vào tên người dùng và mật khẩu cho người dùng Blogger; thay vào đó, ứng dụng lấy các mã thông báo AuthSub đặc biệt cho phép ứng dụng hành động thay mặt cho một người dùng cụ thể. Để biết thêm thông tin chi tiết, hãy xem tài liệu về AuthSub.
Khi người dùng truy cập vào ứng dụng của bạn lần đầu tiên, họ chưa được xác thực. Trong trường hợp này, bạn cần hiển thị một số thông tin và một đường liên kết đưa người dùng đến trang Google để xác thực yêu cầu truy cập vào blog của họ.
Các tham số truy vấn sau được bao gồm trong URL AuthSubRequest:
- tiếp theo
- URL của trang mà Google sẽ chuyển hướng người dùng đến sau khi xác thực.
- xác định phạm vi của thứ nguyên.
- Cho biết ứng dụng đang yêu cầu mã thông báo để truy cập vào nguồn cấp dữ liệu Blogger. Chuỗi phạm vi sẽ sử dụng là
http://www.blogger.com/feeds/(tất nhiên là mã hoá URL). - bảo mật
- Cho biết ứng dụng có yêu cầu mã thông báo bảo mật hay không.
- phiên hoạt động
- Cho biết liệu mã thông báo được trả về có thể đổi được mã thông báo đa dụng (phiên hoạt động) hay không.
URL AuthSubRequest có thể có dạng như sau:
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
Người dùng đi theo đường liên kết đến trang web của Google và xác thực với Tài khoản Google của họ.
Sau khi người dùng xác thực, hệ thống AuthSub chuyển hướng họ đến URL mà bạn đã chỉ định trong tham số truy vấn next của URL AuthSubRequest. Hệ thống AuthSub sẽ thêm một mã thông báo xác thực vào URL đó, làm giá trị của tham số truy vấn token. Ví dụ:
http://www.example.com/welcome.html?token=yourAuthToken
Giá trị mã thông báo này là mã thông báo AuthSub dùng một lần. Trong ví dụ này,
do session=1 được chỉ định, có thể đổi mã thông báo này thành
mã xác thực phiên AuthSub bằng cách gọi dịch vụ AuthSubSessionToken bằng mã thông báo sử dụng một lần trong tiêu đề Uỷ quyền như sau:
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
Phản hồi dịch vụ AuthSubSessionToken bao gồm một tiêu đề Token
chứa mã thông báo phiên và một tiêu đề Expiration
cho biết mã thông báo sẽ tồn tại trong bao lâu.
Sau đó, ứng dụng của bạn có thể sử dụng giá trị mã thông báo trong tiêu đề
Authorization của các hoạt động tương tác tiếp theo với Blogger.
Sau đây là ví dụ về một yêu cầu HTTP chứa mã thông báo không an toàn mà bạn có thể gửi tới 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
Xác thực tên người dùng/mật khẩu ClientLogin
Sử dụng chế độ xác thực ClientLogin nếu ứng dụng của bạn là ứng dụng khách độc lập, người dùng đơn lẻ và được cài đặt" (chẳng hạn như ứng dụng dành cho máy tính). Để yêu cầu mã thông báo xác thực bằng cơ chế ClientLogin, hãy gửi yêu cầu POST đến URL sau:
https://www.google.com/accounts/ClientLogin
Phần thân POST phải chứa một tập hợp các tham số truy vấn giống như
các thông số được chuyển qua biểu mẫu HTML, sử dụng loại nội dung
application/x-www-form-urlencoded. Các thông số này
là:
- Địa chỉ email của người dùng.
- Mật khẩu
- Mật khẩu của người dùng.
- dịch vụ
- Tên dịch vụ Blogger là
blogger. (Đối với các tên dịch vụ khác, hãy xem danh sách tên dịch vụ.) - Loại tài khoản
- Bạn phải luôn đặt giá trị này thành
GOOGLEkhi sử dụng API Blogger. Nếu bạn không đặt thông số này, người dùng cũng có tài khoản G Suite sẽ không thể truy cập. - nguồn
- Xác định ứng dụng của bạn. Nên có dạng companyName-applicationName-versionID. Các ví dụ sử dụng tên
exampleCo-exampleApp-1.
Để biết thêm thông tin về các tham số, hãy xem tài liệu Xác thực ứng dụng đã cài đặt.
Nếu yêu cầu xác thực không thành công, thì máy chủ sẽ trả về mã trạng thái HTTP 403 Forbidden.
Nếu thành công, máy chủ sẽ trả về một mã trạng thái 200 OK HTTP, kèm theo ba mã gồm chữ và số dài trong phần nội dung phản hồi: SID, LSID và Auth. Giá trị uỷ quyền là mã thông báo uỷ quyền mà bạn sẽ gửi cho Blogger
kèm theo từng yêu cầu tiếp theo của mình. Vì vậy, hãy giữ một bản sao của giá trị đó. Bạn có thể bỏ qua các giá trị SID và LSID.
Vì tất cả các yêu cầu nguồn cấp dữ liệu riêng tư đều yêu cầu xác thực, nên bạn phải đặt tiêu đề Ủy quyền trong tất cả các lần tương tác tiếp theo với Blogger, bằng cách sử dụng định dạng sau:
Authorization: GoogleLogin auth=yourAuthToken
Trong đó yourAuthToken là chuỗi Xác thực được trả về theo yêu cầu ClientLogin.
Để biết thêm thông tin về xác thực ClientLogin, bao gồm cả các yêu cầu và phản hồi mẫu, hãy xem tài liệu Xác thực ứng dụng đã cài đặt.
Lưu ý: Sử dụng cùng một mã thông báo cho tất cả các yêu cầu trong một phiên nhất định; không thu thập mã thông báo mới cho từng yêu cầu trên Blogger.
Lưu ý: Như đã mô tả trong tài liệu ClientLogin, yêu cầu xác thực có thể không thành công và yêu cầu xác thực CAPTCHA. Nếu bạn muốn Google đưa ra và xử lý hình ảnh xác thực CAPTCHA, hãy
chuyển người dùng đến
https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger
(thay vì đến URL xử lý hình ảnh xác thực (CAPTCHA) đã cung cấp trong tài liệu
ClientLogin.
Truy xuất danh sách blog
API Dữ liệu của Blogger cung cấp nguồn cấp dữ liệu liệt kê các blog cho một người dùng cụ thể; nguồn cấp dữ liệu đó được gọi là "metafeed;"
Gửi một HTTP GET đến URL sau để truy xuất danh sách blog:
http://www.blogger.com/feeds/userID/blogs
Lưu ý: Bạn cũng có thể thay thế default cho mã nhận dạng người dùng để yêu cầu Blogger trả về danh sách các blog cho người dùng có thông tin đăng nhập đi kèm với yêu cầu.
Mục nhập trong nguồn cấp dữ liệu có thể có dạng như sau:
<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>
Để biết thông tin về ý nghĩa của từng phần tử đó, hãy xem tài liệu Tài liệu tham khảo giao thức API dữ liệu của Google hoặc quy cách Atom 1.0.
Nếu yêu cầu của bạn không thành công vì lý do nào đó, Blogger có thể trả về một mã trạng thái khác. Bạn cũng có thể xem thêm thông tin về mã trạng thái HTTP trong tài liệu Tài liệu tham khảo về giao thức API dữ liệu của Google.
Tạo bài đăng
API Dữ liệu của Blogger cho phép bạn tạo và xuất bản các mục nhập mới trên blog, cũng như việc tạo các mục nhập bản nháp.
Đăng bài trên blog
Sau khi xác thực, bạn có thể xuất bản các mục nhập mới trên blog.
Trước tiên, hãy tạo một phần biểu thị XML của bài đăng để xuất bản. XML này cần phải ở dạng một phần tử <entry> Atom, có thể có dạng như sau:
<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>
Lưu ý: Tính năng đặt tác giả tùy chỉnh cho bài đăng hiện không được hỗ trợ. Tất cả bài đăng mới sẽ xuất hiện như thể chúng được tạo bởi người dùng hiện đã xác thực.
Để xuất bản mục này, hãy gửi mục nhập đó tới URL của bài đăng trên blog như sau. Đầu tiên, hãy đặt phần tử Atom <entry> vào phần nội dung của yêu cầu POST mới, sử dụng loại nội dung application/atom+xml. Sau đó, hãy tìm URL của bài đăng trên blog trong nguồn cấp dữ liệu bằng cách tìm phần tử <link> nơi thuộc tính rel kết thúc bằng #post. URL của bài đăng trên blog được cung cấp dưới dạng thuộc tính href của phần tử này, ở định dạng sau:
http://www.blogger.com/feeds/blogID/posts/default
Lưu ý: URL này giống với URL trong thẻ <link rel="service.post"> xuất hiện trong phần <head> của phiên bản blog có thể đọc được.
Blogger tạo một bài đăng trên blog bằng mục bạn đã gửi, sau đó trả về một mã trạng thái HTTP 201 CREATED, cùng với một bản sao của bài đăng mới ở dạng phần tử <entry>. Mục nhập được trả về giống với mục bạn đã gửi, nhưng cũng chứa nhiều phần tử do Blogger thêm vào, chẳng hạn như phần tử <id>.
Nếu yêu cầu của bạn không thành công vì lý do nào đó, Blogger có thể trả về một mã trạng thái khác. Để biết thông tin về mã trạng thái, hãy xem tài liệu tham khảo về giao thức API Dữ liệu của Google.
Tạo bài đăng nháp trên blog
Các bài đăng nháp được tạo giống như các bài đăng công khai, nhưng thêm phần tử <app:control> vào mục nhập cho biết bài đăng chưa được xuất bản.
Phần tử <app:control> này phải chứa một phần tử <app:draft> duy nhất làm phần tử con:
<app:control xmlns:app='http://purl.org/atom/app#'> <app:draft>yes</app:draft> </app:control>
Dữ liệu có trong phần tử <app:draft> phải là chuỗi yes để bài đăng được nhận dạng là bản nháp.
Bạn có thể chuyển bài đăng nháp hiện có trên blog thành bài đăng đã xuất bản bằng cách truy xuất bài đăng nháp, đặt dữ liệu phần tử <app:draft> thành chuỗi no, sau đó cập nhật bài đăng. Việc truy xuất và cập nhật bài đăng sẽ được đề cập trong 2 phần tiếp theo.
Lưu ý: Để biết thêm thông tin về Giao thức xuất bản của Atom, bao gồm cả vùng chứa tên <app:control> và <app:draft>, hãy xem RFC 5023.
Đang truy xuất bài đăng
Các phần sau đây mô tả cách truy xuất danh sách các bài đăng trên blog, có và không có tham số truy vấn.
Bạn có thể truy vấn nguồn cấp dữ liệu công khai trên Blogger mà không cần xác thực. Do đó, bạn không cần đặt thông số Uỷ quyền khi truy xuất các bài đăng trên blog từ blog công khai.
Truy xuất tất cả bài đăng trên blog
Để truy xuất bài đăng của người dùng, hãy gửi yêu cầu HTTP GET đến URL của nguồn cấp dữ liệu trong blog. Sau đó, Blogger sẽ trả về một nguồn cấp dữ liệu chứa các mục nhập thích hợp
trên blog. Ví dụ: để nhận danh sách các bài đăng trên blog cho liz@gmail.com, hãy gửi yêu cầu HTTP sau đây tới Blogger (tất nhiên với giá trị thích hợp thay cho blogID):
GET http://www.blogger.com/feeds/blogID/posts/default
Sau đó, Blogger sẽ trả về mã trạng thái HTTP 200 OK và nguồn cấp dữ liệu Atom 1.0 tiêu chuẩn chứa các bài đăng trên blog.
Sau đây là ví dụ về nguồn cấp dữ liệu cho một blog chỉ có một bài đăng. Xin lưu ý rằng chúng tôi đã chỉnh sửa chút ít để ví dụ này dễ đọc hơn một chút. Cụ thể, một nguồn cấp dữ liệu Blogger thực sự có chứa mã và URL thực.
<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'><p>I met Mr. Bingley's friend Mr. Darcy
this evening. I found him quite disagreeable.</p></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>
Truy xuất bài đăng bằng cách sử dụng tham số truy vấn
API Dữ liệu của Blogger cho phép bạn yêu cầu một tập hợp các mục nhập phù hợp với các tiêu chí đã chỉ định, chẳng hạn như yêu cầu các bài đăng trên blog đã được phát hành hoặc cập nhật trong một phạm vi ngày cụ thể.
Ví dụ: để gửi một truy vấn phạm vi ngày, hãy thêm các tham số published-min và published-max vào URL yêu cầu. Để nhận tất cả các mục blog được tạo trong khoảng thời gian từ ngày 16 tháng 3 năm 2008 đến ngày 24 tháng 3 năm 2008, hãy gửi một yêu cầu HTTP đến URL của nguồn cấp dữ liệu blog:
GET http://www.blogger.com/feeds/blogID/posts/default?published-min=2008-03-16T00:00:00&published-max=2008-03-24T23:59:59
Khi bạn gửi yêu cầu GET đó, Blogger sẽ trả về mã trạng thái HTTP
200 OK và một nguồn cấp dữ liệu chứa mọi bài đăng trên blog đã được tạo trong phạm vi ngày bạn đã chỉ định.
Bạn cũng có thể dùng các tham số updated-min và updated-max để cập nhật tất cả mục nhập blog trong một phạm vi nhất định. Tuy nhiên, hãy lưu ý rằng
các thông số này sẽ bị bỏ qua trừ khi thông số orderby
cũng được đặt thành updated.
API Dữ liệu của Blogger hỗ trợ các thông số truy vấn sau:
- thay thế
- Loại nguồn cấp dữ liệu cần trả về, chẳng hạn như
atom(mặc định) hoặcrss. - /category
- Chỉ định danh mục (còn gọi là nhãn) để lọc kết quả trong nguồn cấp dữ liệu. Ví dụ:
http://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurietrả về các mục có cả nhãnFritzvàLaurie. - kết quả tối đa
- Số mục nhập tối đa cần trả về.
- sắp xếp
- Thứ tự trả về các mục, chẳng hạn như
lastmodified(mặc định),starttimehoặcupdated. - đã phát hành tối thiểu, đã xuất bản tối đa
- Giới hạn ngày xuất bản.
- chỉ mục bắt đầu
- Chỉ mục dựa trên 1 của kết quả đầu tiên được truy xuất (để phân trang).
- cập nhật tối thiểu, cập nhật tối đa
- Giới hạn về ngày cập nhật mục nhập. Các tham số truy vấn này bị bỏ qua trừ khi tham số
orderbyđược đặt thànhupdated.
Để biết thêm thông tin về các tham số truy vấn, hãy xem Hướng dẫn tham khảo API dữ liệu của Blogger và Hướng dẫn tham khảo API dữ liệu của Google.
Đang cập nhật bài đăng
Để cập nhật bài đăng hiện có trên blog, trước tiên, bạn truy xuất mục nhập mà bạn muốn cập nhật, sau đó sửa đổi bài đăng đó rồi gửi yêu cầu PUT với mục nhập đã cập nhật trong nội dung bài viết đến URL chỉnh sửa của bài đăng đó. Hãy đảm bảo rằng
giá trị <id> trong mục mà bạn PUT khớp chính xác với
<id> của mục nhập hiện có.
URL chỉnh sửa được làm nổi bật trong mục sau:
<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'><p>I met Mr. Bingley's friend Mr. Darcy
this evening. I found him quite disagreeable.</p></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>
LƯU Ý QUAN TRỌNG:: Để đảm bảo khả năng tương thích chuyển tiếp, hãy đảm bảo rằng khi bạn PUT nhập một mục cập nhật, bạn sẽ giữ nguyên tất cả XML hiện diện khi bạn truy xuất mục đó từ Blogger. Nếu không,
khi chúng tôi triển khai nội dung mới và đưa các phần tử <new-awesome-feature>
vào nguồn cấp dữ liệu, ứng dụng của bạn sẽ không trả về các phần tử đó và người dùng của bạn sẽ bỏ lỡ. Tất cả thư viện ứng dụng API của Google Data đều xử lý đúng cách, vì vậy nếu bạn đang sử dụng một trong những thư viện mà bạn chưa thiết lập.
Lưu ý: Tính năng sửa đổi dữ liệu tác giả liên kết với các bài đăng hiện không được hỗ trợ.
Mẹo khắc phục sự cố: Một số tường lửa chặn thông báo HTTP
PUT. Để giải quyết vấn đề này, bạn có thể đưa tiêu đề X-HTTP-Method-Override: PUT vào yêu cầu POST.
Để biết thông tin chi tiết, hãy xem tài liệu Thông tin cơ bản về giao thức API Dữ liệu của Google.
Đang xóa bài đăng
Để xóa một bài đăng, hãy gửi yêu cầu DELETE đến URL chỉnh sửa của bài đăng đó.
Đây cũng là URL dùng để cập nhật bài đăng.
Mẹo khắc phục sự cố: Một số tường lửa chặn thông báo HTTP
DELETE. Để khắc phục điều này, bạn có thể đưa tiêu đề X-HTTP-Method-Override: DELETE vào yêu cầu POST. Để biết thông tin chi tiết, hãy xem tài liệu Thông tin cơ bản về giao thức API Dữ liệu của Google.
Bình luận
API Dữ liệu của Blogger cho phép tạo, truy xuất và xóa bình luận. Tính năng cập nhật nhận xét không được hỗ trợ (cũng không có trong giao diện web).
Tạo nhận xét
Để đăng nhận xét, hãy tạo phần tử <entry> Atom như sau:
<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>
Để đăng bình luận này, hãy đặt phần tử Atom <entry> vào phần nội dung của yêu cầu POST mới, sử dụng loại nội dung application/atom+xml. Sau đó, gửi yêu cầu POST
đến URL phù hợp trên Blogger:
POST http://www.blogger.com/feeds/blogID/postID/comments/default
Lưu ý: Hiện tại, bạn chỉ có thể đăng bình luận lên blog mà người dùng đã xác thực sở hữu.
Lưu ý: Chúng tôi hiện không hỗ trợ việc cài đặt tác giả tùy chỉnh cho nhận xét. Tất cả nhận xét mới sẽ xuất hiện như thể chúng được tạo bởi người dùng hiện đã xác thực.
Truy xuất nhận xét
Bạn có thể truy xuất các nhận xét đối với một bài đăng cụ thể bằng cách gửi GET đến URL của nguồn cấp dữ liệu về nhận xét cho bài đăng này:
GET http://www.blogger.com/feeds/blogID/postID/comments/default
Hoặc bạn có thể nhận bình luận từ tất cả bài đăng bằng cách sử dụng URL nguồn cấp dữ liệu bình luận trên blog:
GET http://www.blogger.com/feeds/blogID/comments/default
Các yêu cầu này trả về một nguồn cấp dữ liệu bình luận giống như sau:
<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>
Đang xoá nhận xét
Để xóa một nhận xét, hãy gửi yêu cầu DELETE đến URL chỉnh sửa của nhận xét đó. URL này được làm nổi bật trong nguồn cấp dữ liệu bình luận ở trên.
Định dạng xuất
Blogger cho phép người dùng xuất và nhập blog của họ bằng cách sử dụng tệp xuất trên Blogger. Tệp xuất này chứa tất cả bài đăng và nhận xét cho một blog. Định dạng của tệp xuất có định dạng giống hệt Atom được mô tả trong các phần về cách truy xuất bài đăng và nhận xét. Tệp xuất này sẽ chứa nội dung của nguồn cấp dữ liệu bài đăng và nội dung của nguồn cấp dữ liệu nhận xét được kết hợp thành một tài liệu.
Để xuất hoặc nhập dữ liệu blog bằng định dạng xuất, bạn có thể truy cập vào trang Cài đặt cho blog. Để truy xuất tệp xuất cho blog bằng Data API, hãy sử dụng URL sau:
GET http://www.blogger.com/feeds/blogID/archive
Để nhập tệp xuất, hãy tạo yêu cầu POST đến
URL sau đây có nội dung của tệp xuất làm dữ liệu yêu cầu và
application/atom+xml làm loại nội dung:
POST http://www.blogger.com/feeds/blogID/archive/full
Không có URL nào cho các tham số truy vấn hỗ trợ ở trên. Cả hai yêu cầu cũng phải chứa thông tin xác thực và chỉ có quản trị viên blog mới có thể nhập/xuất blog bằng cách sử dụng các URL nguồn cấp dữ liệu này.
Lưu ý: Nếu bạn đang tạo tệp xuất riêng của mình trên Blogger, hiện có một quy định hạn chế về thứ tự của các bài đăng và bình luận. Tệp xuất bằng Blogger sẽ liệt kê tất cả bài đăng trước tiên, sau đó là tất cả nhận xét. Được phép xen kẽ các bài đăng và bài đăng bình luận miễn là mục bình luận xuất hiện sau bài đăng.
Để biết thêm thông tin về cách Blogger sử dụng định dạng Atom trong tệp xuất, hãy xem Hướng dẫn tham khảo về giao thức.