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.
Tài liệu này cung cấp tài liệu tham khảo chi tiết về giao thức thô (XML và HTTP) cho API Dữ liệu Blogger.
Tài liệu này không chứa thông tin về thư viện ứng dụng bằng ngôn ngữ lập trình. Để biết thông tin tham khảo về thư viện ứng dụng, hãy xem các đường liên kết trong phần nội dung dành riêng cho ngôn ngữ lập trình của hướng dẫn dành cho 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 các ứng dụng máy khách có thể tương tác với Blogger.
Tài liệu này là tài liệu tham khảo; tài liệu này giả định rằng bạn hiểu các khái niệm có trong hướng dẫn dành cho nhà phát triển và các ý tưởng chung đằng sau giao thức API dữ liệu của Google.
Các loại nguồn cấp dữ liệu Blogger
Blogger cung cấp hai bản trình bày về nội dung blog trong nguồn cấp dữ liệu: nguồn cấp dữ liệu đầy đủ và nguồn cấp dữ liệu tóm tắt. Nguồn cấp dữ liệu đầy đủ chứa các bài đăng đầy đủ trên blog, còn nguồn cấp dữ liệu tóm tắt chỉ chứa một đoạn trích ngắn của mỗi bài đăng.
Chủ sở hữu blog có thể chỉ định bằng cách sử dụng các tùy chọn cài đặt GUI, cho dù blog đó cung cấp nguồn cấp dữ liệu đầy đủ hay nguồn cấp dữ liệu tóm tắt cho các cộng tác viên và trang web tổng hợp.
Khi gửi yêu cầu chưa được xác thực cho nguồn cấp dữ liệu, ứng dụng khách của bạn sẽ nhận được một loại nguồn cấp dữ liệu mà chủ sở hữu blog đã chỉ định.
Tuy nhiên, khi ứng dụng khách gửi yêu cầu đã được xác thực, ứng dụng đó sẽ luôn nhận được nguồn cấp dữ liệu đầy đủ, bất kể chủ sở hữu blog đã chỉ định điều gì.
Tài liệu tham khảo về tham số truy vấn của Blogger
API Dữ liệu của Blogger hỗ trợ hầu hết mọi thông số truy vấn API Dữ liệu của Google chuẩn.
Blogger không hỗ trợ các tham số q (tìm kiếm văn bản) và author.
Các thông số truy vấn updated-min và updated-max
sẽ bị bỏ qua trừ khi thông số orderby được đặt thành
updated. Ví dụ: URL sau truy xuất tất cả bài đăng trên blog đã được cập nhật từ ngày 16 tháng 3 năm 2008 đến ngày 24 tháng 3 năm 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
Tài liệu tham khảo về phần tử Blogger
API Dữ liệu của Blogger chỉ sử dụng các phần tử Atom chuẩn; để biết thêm thông tin, hãy xem quy cách định dạng phân phối Atom 1.0 và Giao thức xuất bản Atom.
Phần còn lại của mục này cung cấp một số lưu ý cụ thể về cách sử dụng một số phần tử chuẩn của Blogger.
Các mục nháp
Một mục blog nháp được đánh dấu bằng phần tử mở rộng <app:draft>
được xác định trong tài liệu Giao thức xuất bản của Atom. Sau đây là ví dụ về một mục nhập nháp:
<entry xmlns:app='http://purl.org/atom/app#'> ... <app:control> <app:draft>yes</app:draft> </app:control> </entry>
Nếu bạn không chỉ định phần tử <draft> nào, thì mục đó không phải là bản nháp.
Ngày xuất bản và ngày cập nhật
Dấu thời gian cung cấp trong phần tử <published> tiêu chuẩn của Atom
tương ứng với "đăng ngày" mà người dùng có thể thiết lập trong
GUI của Blogger.
Khi ứng dụng của bạn tạo một mục nhập mới, nếu khách hàng không chỉ định giá trị cho <published>, thì Blogger sẽ đặt ngày đăng bài viết thành giờ của máy chủ hiện tại. Khi khách hàng chỉnh sửa một mục nhập nhưng không chỉ định giá trị <published>, Blogger sẽ giữ nguyên ngày đăng bài viết.
Tuy nhiên, nếu khách hàng của bạn chỉ định một giá trị cho phần tử <published> khi tạo hoặc chỉnh sửa một mục nhập, thì Blogger sẽ đặt ngày đăng của mục nhập thành giá trị được chỉ định. Điều này có thể hữu ích cho các tác vụ như nhập mục nhập cũ từ hệ thống viết blog khác (trong khi vẫn giữ nguyên ngày tạo ban đầu).
Blogger sử dụng phần tử tiêu chuẩn Atom <updated> để cho biết thời điểm mục nhập được thay đổi lần gần đây nhất. Máy khách của bạn không thể kiểm soát giá trị <updated>; Blogger luôn đặt ngày cập nhật lần gần đây nhất vào thời gian hiện tại của máy chủ bất cứ khi nào khách hàng đăng hoặc chỉnh sửa mục nhập.
Bạn có thể sử dụng các tham số truy vấn tiêu chuẩn của Google Data API published-min,
published-max, updated-min và
updated-max để yêu cầu mục nhập dựa trên giá trị
<published> hoặc <updated> của các mục đó. Tuy nhiên, để lưu ý về việc truy vấn vào các ngày cập nhật, hãy xem Tài liệu tham khảo về tham số truy vấn Blogger.
Liên kết nhận xét với bài đăng
Định dạng xuất của Blogger chứa cả bài đăng và mục nhập nhận xét trong một tài liệu nguồn cấp dữ liệu Atom.
Để phân biệt hai loại mục này, Blogger sử dụng phần tử
<atom:category>. Phần tử này sẽ có thông số term phản ánh liệu mục nhập là dành cho bài đăng hay nhận xét.
Ngoài ra, việc liên kết mục nhập nhận xét với mục nhập bài đăng đó sẽ
đạt được thông qua việc sử dụng Phần mở rộng về chuỗi luồng Atom. Trong ví dụ bên dưới, phần tử <thr:in-reply-to> trong mục nhận xét sẽ trỏ đến bài đăng bằng cách sử dụng giá trị nhận dạng mục đăng trong tham số ref. Nó cũng liên kết đến URL HTML của bài đăng thông qua thông số
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>