Lưu ý 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 Google Data.
Ứng dụng khách của bạn có thể sử dụng API Dữ liệu Blogger để tạo bài đăng trên blog mới, chỉnh sửa hoặc xoá bài đăng trên blog hiện có và truy vấn các bài đăng trên blog khớ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ề những khả năng của Blogger Data API. Tài liệu này đưa ra ví dụ về các hoạt động tương tác cơ bản với Data API XML và HTTP thô. Sau khi đọc tài liệu này, có thể bạn muốn tìm hiểu thêm về tương tác với API bằng ứng dụng khách của chúng tôi thư viện bằng cách đọc phần dành riêng cho ngôn ngữ lập trình của tài liệu này hướng dẫn của nhà phát triển.
Nội dung
Đối tượng
Tài liệu này dành cho các lập trình viên muốn viết ứng dụng 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 rõ các ý tưởng chung đằng sau API Dữ liệu của Google giao thức.
Nếu bạn đang sử dụng hệ thống UNIX và muốn thử các ví dụ trong
mà không cần viết bất kỳ mã nào, bạn có thể tìm 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
các trang hướng dẫn sử dụng cho những tiện ích đó.
Để biết thông tin tham khảo về Blogger Data API, hãy xem Hướng dẫn tham khảo về giao thức.
Bắt đầu
Tạo tài khoản Blogger
Bạn nên đăng ký Tài khoản Blogger để thử nghiệm. Blogger sử dụng Tài khoản Google, vì vậy, nếu bạn đã có Tài khoản Google, thì bạn đã sẵn sàng.
Xác thực đến 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 Blogger Data API. Nguồn cấp dữ liệu công khai không yêu cầu xác thực nào nhưng sẽ ở chế độ chỉ đọc. Nếu bạn muốn sửa đổi blog, thì 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ư. API này có thể xác thực bằng một trong hai phương pháp: 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ề xác thực với Google Data API nói chung, hãy xem hộp thoại xác thực .
Hầu hết các mẫu trong các phần tiếp theo của tài liệu này đều giả định bạn cung cấp xác thực thích hợp.
Xác thực proxy AuthSub
Xác thực proxy AuthSub được sử dụng bởi các ứng dụng web cần xác thực người dùng với Tài khoản Google. Đơn vị điều hành trang web và khách hàng không có quyền truy cập vào tên người dùng và mật khẩu của người dùng Blogger; thay vào đó, ứng dụng nhận đượ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 AuthSub.
Khi người dùng truy cập vào ứng dụng của bạn lần đầu tiên, họ vẫn chưa đã 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à đường liên kết dẫn người dùng đến một trang của 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 đây có trong URL AuthSubRequest:
- tiếp theo
- URL của trang mà Google nên chuyển hướng người dùng đến sau khi xác thực.
- phạm vi
- Cho biết ứng dụng đang yêu cầu mã thông báo để truy cập nguồn cấp dữ liệu của Blogger. Chuỗi phạm vi cần sử dụng là
http://www.blogger.com/feeds/(dĩ nhiên là được mã hoá URL). - bảo mật
- Cho biết liệu ứng dụng khách có đang yêu cầu mã thông báo bảo mật hay không.
- phiên
- Cho biết liệu có thể đổi mã thông báo được trả về lấy mã thông báo đa mục đích (phiên) 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 truy cập đường liên kết đến trang web của Google và xác thực với thông tin Tài khoản.
Sau khi người dùng xác thực, hệ thống AuthSub sẽ chuyển hướng họ đến URL
mà bạn đã chỉ định trong tham số truy vấn next của AuthSubRequest
URL. Hệ thống AuthSub sẽ thêm một mã thông báo xác thực vào URL đó, dưới dạng
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 đại diện cho một mã thông báo AuthSub dùng một lần. Trong ví dụ này,
vì bạn đã chỉ định session=1, nên bạn có thể đổi mã thông báo này lấy
Mã thông báo phiên AuthSub bằng cách gọi AuthSubSessionToken
có mã thông báo 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 của dịch vụ AuthSubSessionToken bao gồm một tiêu đề Token
có chứa mã thông báo phiên và tiêu đề Expiration
cho biết mã thông báo sẽ có hiệu lực trong bao lâu.
Sau đó, ứng dụng của bạn có thể sử dụng giá trị mã thông báo phiên trong
Authorization tiêu đề của các lượt tương tác tiếp theo với Blogger.
Dưới đâ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 đến 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 phương thức xác thực ClientLogin nếu ứng dụng của bạn là một người dùng độc lập
"đã cài đặt" ứng dụng khách (chẳng hạn như ứng dụng dành cho máy tính). Để yêu cầu một
mã xác thực bằng cơ chế ClientLogin, hãy gửi POST
đến URL sau:
https://www.google.com/accounts/ClientLogin
Phần nội dung POST phải chứa một tập hợp các tham số truy vấn trông giống như các tham số được truyền qua một 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.
- Passwd
- Mật khẩu của người dùng.
- dịch vụ
- Tên dịch vụ Blogger là
blogger. (Đối với dịch vụ khác hãy xem danh sách tên dịch vụ.) - accountType
- 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, những người dùng cũng có tài khoản G Suite sẽ không truy cập được. - source
- Xác định ứng dụng khách của bạn. Phải ở dạng companyName-applicationName-versionID. Các ví dụ này sử dụng tên
exampleCo-exampleApp-1.
Để biết thêm thông tin về các thông số, hãy xem phần Xác thực cho Tài liệu về Ứng dụng đã cài đặt.
Nếu yêu cầu xác thực không thành công, máy chủ sẽ trả về mã trạng thái HTTP 403 Forbidden.
Nếu thành công thì máy chủ sẽ trả về trạng thái HTTP 200 OK
cùng với ba mã dài gồm chữ và số trong nội dung phản hồi: SID, LSID,
và Xác thực. Giá trị xác thực là mã thông báo uỷ quyền mà bạn sẽ gửi tới Blogger
với mỗi yêu cầu tiếp theo của bạn, vì vậy hãy giữ 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 đối với nguồn cấp dữ liệu riêng tư đều cần phải xác thực, nên bạn phải đặt tiêu đề Uỷ quyền trong tất cả các 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ề
Yêu cầu ClientLogin.
Để biết thêm thông tin về xác thực ClientLogin, bao gồm cả mẫu các yêu cầu và phản hồi, hãy xem phần Xác thực để cài đặt Tài liệu về ứng dụng.
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 phiên cụ thể; không lấy mã thông báo mới cho mỗi yêu cầu Blogger.
Lưu ý: Như được mô tả trong phần ClientLogin
tài liệu của bạn, yêu cầu xác thực có thể không thành công và yêu cầu CAPTCHA
thử thách. Nếu bạn muốn Google phát hành và xử lý thử thách CAPTCHA, hãy
chuyển người dùng đến
https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger
(thay vì URL xử lý CAPTCHA được cung cấp trong ClientLogin
tài liệu).
Truy xuất danh sách blog
Blogger Data API cung cấp một nguồn cấp dữ liệu liệt kê các blog cho một user; nguồn cấp dữ liệu đó được gọi là "metafeed".
Gửi GET HTTP đến URL sau để truy xuất danh sách
các 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. Thao tác này sẽ yêu cầu Blogger trả về danh sách blog cho người dùng có thông tin xác thực đi kèm với yêu cầu.
Một mục nhập trong metafeed 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 tham khảo về giao thức API dữ liệu hoặc Atom Quy cách 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ả lại trạng thái khác . Thông tin khác về mã trạng thái HTTP cũng có trong Dữ liệu của Google Tài liệu tham khảo về giao thức API.
Tạo bài đăng
Blogger Data API cho phép bạn tạo và xuất bản các mục mới trên blog, cũng như tạo bản nháp của các mục.
Xuất bản bài đăng trên blog
Sau khi xác thực, bạn có thể xuất bản các mục mới trên blog.
Trước tiên, hãy tạo một bản trình bày XML về bài đăng mà bạn muốn xuất bản. XML này cần
ở dạng phần tử Atom <entry>, có thể trô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 ý: Chúng tôi hiện chưa hỗ trợ tính năng đặt tác giả tuỳ chỉnh cho bài đăng. Tất cả bài đăng mới sẽ xuất hiện như thể chúng do người dùng hiện đã xác thực tạo.
Để xuất bản, hãy gửi mục nhập này tới URL của bài đăng trên blog như sau. Đầu tiên,
đặt phần tử Atom <entry> vào phần nội dung của phần tử mới
Yêu cầu POST, sử dụng nội dung application/atom+xml
loại. Sau đó, tìm URL bài đăng của blog trong metafeed bằng cách định vị
Phần tử <link>, trong đó thuộc tính rel kết thúc bằng
#post. URL của bài đăng trên blog này được gán tên là 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 bài đăng trên blog bằng mục nhập bạn đã gửi, sau đó trả về một HTTP
201 CREATED mã trạng thái, cùng với bản sao của bài đăng mới trong
của một phần tử <entry>. Mục nhập được trả về giống nhau
đường liên kết bạn đã gửi nhưng cũng chứa nhiều thành phần khác nhau 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ề các mã trạng thái, hãy xem bài viết Dữ liệu của Google Tài liệu tham khảo về giao thức API.
Đang tạo một bài đăng nháp trên blog
Bài đăng nháp được tạo giống như bài đăng công khai, nhưng có thêm phần tử <app:control> vào mục nhập cho biết rằng 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ử duy nhất
Phần tử <app:draft> 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 công nhận là bài đăng nháp.
Bạn có thể chuyển một 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 của 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 hai phần tiếp theo.
Lưu ý: Để biết thêm thông tin về Atom
Giao thức xuất bản, bao gồm <app:control> và
<app:draft> không gian tên, hãy xem tiêu chuẩn RFC 5023.
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, với 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 của Blogger mà không cần xác thực. Do đó, bạn không cần đặt tham số Uỷ quyền khi truy xuất 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 GET HTTP đến URL nguồn cấp dữ liệu của blog. Sau đó, Blogger sẽ trả về một nguồn cấp dữ liệu chứa các mục nhập blog thích hợp. Ví dụ: để nhận danh sách bài đăng trên blog của liz@gmail.com, hãy gửi yêu cầu HTTP sau đây đến Blogger (tất nhiên là 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à một 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. Lưu ý chúng tôi đã chỉnh sửa ví dụ này một chút để làm cho ví dụ dễ đọc hơn con người. Cụ thể, nguồn cấp dữ liệu thực trên Blogger chứa mã nhận dạng và URL thực tế.
<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 tham số truy vấn
API Dữ liệu Blogger cho phép bạn yêu cầu một tập hợp các mục phù hợp với tiêu chí đã chỉ định, chẳng hạn như yêu cầu bài đăng trên blog được xuất bản hoặc cập nhật trong một phạm vi ngày nhất định.
Ví dụ: để gửi một truy vấn theo phạm vi ngày, hãy thêm thuộc tính published-min
và published-max tham số vào URL yêu cầu. Để nhận tất cả các mục nhập blog được tạo 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 nguồn cấp dữ liệu của 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ột HTTP
Mã trạng thái 200 OK và nguồn cấp dữ liệu chứa bất kỳ bài đăng nào trên blog
tạo trong phạm vi ngày mà bạn đã chỉ định.
Các tham số updated-min và updated-max cũng có thể
được dùng để cập nhật tất cả các mục trên blog trong một phạm vi nhất định. Tuy nhiên, xin lưu ý rằng các thông số này sẽ bị bỏ qua trừ phi thông số orderby cũng được đặt thành updated.
Blogger Data API hỗ trợ các tham số truy vấn sau đây:
- alt
- 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ả nguồn cấp dữ liệu. Ví dụ:
http://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurietrả về các mục nhập có cả nhãnFritzvàLaurie. - max-results
- Số mục tối đa cần trả về.
- theo thứ tự
- Thứ tự trả về các mục nhập, chẳng hạn như
lastmodified(mặc định),starttimehoặcupdated. - phút xuất bản, tối đa được xuất bản
- Giới hạn về ngày xuất bản bài dự thi.
- start-index
- Chỉ mục dựa trên 1 của kết quả đầu tiên cần truy xuất (để phân trang).
- tối thiểu cập nhật, 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 sẽ bị bỏ qua trừ khi tham số
orderbyđược đặt thànhupdated.
Để biết thêm thông tin về tham số truy vấn, hãy xem Tài liệu tham khảo về API dữ liệu của Blogger Hướng dẫn và Google Hướng dẫn tham khảo về API dữ liệu.
Đang cập nhật bài đăng
Để cập nhật một bài đăng hiện có trên blog, trước tiên, hãy truy xuất mục nhập bạn muốn
cập nhật, sau đó bạn sửa đổi, rồi gửi yêu cầu PUT kèm theo
mục nhập đã cập nhật trong nội dung thư, vào URL chỉnh sửa của bài đăng. Hãy đảm bảo rằng giá trị <id> trong mục nhập 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 nhập 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 PUT một mục đã cập nhật, bạn sẽ giữ lại tất cả XML có sẵn khi truy xuất mục đó từ Blogger. Nếu không,
khi chúng ta triển khai nội dung mới và đưa <new-awesome-feature> vào
trong nguồn cấp dữ liệu, khách hàng của bạn sẽ không trả lại các phần tử đó và người dùng của bạn sẽ bỏ lỡ
bị loại. Tất cả thư viện ứng dụng API Dữ liệu của Google đều xử lý vấn đề này một cách chính xác, vì vậy, nếu đang sử dụng một trong các thư viện này, bạn đã sẵn sàng.
Lưu ý: Sửa đổi dữ liệu tác giả liên kết với 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ể thêm 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 Kiến thức cơ bản về giao thức API Dữ liệu của Google.
Xoá bài đăng
Để xoá 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 HTTP
DELETE tin nhắn. Để giải quyết vấn đề này, bạn có thể thêm
Tiêu đề X-HTTP-Method-Override: DELETE trong POST
yêu cầu. Để biết chi tiết, hãy xem Google Data API
tài liệu cơ bản về giao thức.
Bình luận
Blogger Data API cho phép tạo, truy xuất và xoá bình luận. Tính năng cập nhật nhận xét không được hỗ trợ (hoặc tính năng này cũng không có trên web giao diện).
Đang tạo nhận xét
Để đăng bình luận, hãy tạo một phần tử Atom <entry> 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>
Để xuất bản nhận xét này, hãy đặt phần tử <entry> của Atom 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 gửi yêu cầu POST đến URL Blogger thích hợp:
POST http://www.blogger.com/feeds/blogID/postID/comments/default
Lưu ý: Hiện tại, bạn chỉ có thể đăng nhận xét lên một blog do người dùng đã xác thực sở hữu.
Lưu ý: Việc đặt tác giả tuỳ chỉnh cho bình luận mới là hiện không được hỗ trợ. Tất cả các nhận xét mới sẽ hiển thị như thể chúng được tạo bởi người dùng hiện được xác thực.
Truy xuất nhận xét
Bạn có thể truy xuất nhận xét cho một bài đăng cụ thể bằng cách gửi
GET vào URL nguồn cấp dữ liệu bình luận của bài đăng này:
GET http://www.blogger.com/feeds/blogID/postID/comments/default
Hoặc bạn có thể nhận nhận xét từ tất cả các bài đăng bằng cách sử dụng nguồn cấp dữ liệu nhận xét của blog URL:
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 có dạ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á bình luận
Để xoá một bình luận, hãy gửi yêu cầu DELETE đến phần chỉnh sửa của bình luận đó
URL. 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 bằng tính năng xuất trên Blogger tệp. Tệp xuất này chứa tất cả bài đăng và bình luận của một blog. Chiến lược phát hành đĩa đơn cho tệp xuất giống hệt như định dạng Atom được mô tả trong 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 bình luận đượ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 Trang Cài đặt cho blog. Để truy xuất tệp xuất cho một blog bằng API dữ liệu, 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 một yêu cầu POST cho phương thức
URL tiếp theo với nội dung của tệp xuất dưới dạng 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 ở trên hỗ trợ tham số truy vấn. Cả hai yêu cầu phải cũng chứa thông tin xác thực và chỉ quản trị viên blog sẽ có thể nhập/xuất blog bằng nguồn cấp dữ liệu này URL.
Lưu ý: Nếu bạn đang tạo tệp xuất của riêng mình trên Blogger, thì hiện có một hạn chế về thứ tự của các mục nhập bài đăng và nhận xét. Tệp xuất trên Blogger sẽ liệt kê tất cả bài đăng trước, sau đó là tất cả bình luận. Cho phép các mục nhập bài đăng và nhận xét xen kẽ miễn là mục nhập nhận xét xuất hiện sau bài đăng có nội dung nhận xét.
Để 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.