Lưu ý quan trọng: Chúng tôi sẽ ngừng hỗ trợ Google Data API phiên bản 2.0 kể từ ngày 30 tháng 9 năm 2024. Để đảm bảo chức năng không bị gián đoạn, hãy cập nhật các ứng dụng chạy Google Data API phiên bản 2.0 lên phiên bản API mới nhất. Để dùng 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. Lưu ý: mặc dù một số yêu cầu GET (chẳng hạn như bài đăng trên trang thông tin) sẽ tiếp tục được hỗ trợ dưới dạng URL nguồn cấp dữ liệu, nhưng vẫn có những điểm khác biệt nhỏ trong cách hoạt động của những yêu cầu này. Để biết thông tin chi tiết, hãy tham khảo tài liệu trên trang Trợ giúp Blogger.
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 Blogger Data API.
Tài liệu này không chứa thông tin về thư viện ứng dụng của 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 theo ngôn ngữ lập trình cụ thể trong hướng dẫn của nhà phát triển.
Nội dung
Đối tượng người xem
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 khách có thể tương tác với Blogger.
Đây là tài liệu tham khảo; giả định rằng bạn hiểu các khái niệm được trình bày trong hướng dẫn dành cho nhà phát triển và ý tưởng chung của giao thức Google Data API.
Các loại nguồn cấp dữ liệu Blogger
Blogger cung cấp hai cách trình bày 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 toàn bộ bài đăng trên blog, trong khi 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 chế độ cài đặt GUI để xem 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 trình tổng hợp và trình tổng hợp.
Khi ứng dụng khách của bạn gửi một yêu cầu chưa được xác thực cho một nguồn cấp dữ liệu, ứng dụng đó sẽ nhận được bất kỳ loại nguồn cấp dữ liệu nào mà chủ sở hữu blog đã chỉ định.
Tuy nhiên, khi gửi một yêu cầu đã xác thực, ứng dụng khách của bạn sẽ luôn nhận được nguồn cấp dữ liệu đầy đủ, bất kể chủ sở hữu blog đã chỉ định gì.
Tài liệu tham khảo về tham số truy vấn của Blogger
Blogger Data API hỗ trợ hầu hết các tham số truy vấn API dữ liệu của Google tiêu chuẩn.
Blogger không hỗ trợ tham số author.
Tham số truy vấn updated-min và updated-max sẽ bị bỏ qua trừ phi tham số orderby được đặt thành updated. Ví dụ: URL sau đây truy xuất tất cả các bài đăng trên blog đã 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ề các thành phần của Blogger
Blogger Data API chỉ sử dụng các thành phần Atom tiêu 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 phần này cung cấp một số lưu ý cụ thể về việc Blogger sử dụng một số phần tử chuẩn.
Mục nhập nháp
Một mục blog nháp được đánh dấu bằng phần tử tiện ích <app:draft>
được xác định trong tài liệu Atom Publishing Protocol (Giao thức xuất bản của Atom). Dưới đây là ví dụ về một mục nháp:
<entry xmlns:app='http://www.w3.org/2007/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 nhập 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ử Atom <published> tiêu chuẩn tương ứng với "ngày đăng" mà người dùng có thể đặt trong GUI (Giao diện người dùng đồ hoạ) của Blogger.
Khi ứng dụng của bạn tạo một mục nhập mới, nếu ứng dụng khách không chỉ định giá trị
cho <published>, thì Blogger sẽ đặt ngày đăng của mục nhập đó
theo giờ máy chủ hiện tại. Khi khách hàng của bạn chỉnh sửa một mục nhập nhưng không chỉ định giá trị <published>, Blogger sẽ để nguyên ngày đăng mục nhập đó.
Tuy nhiên, nếu ứng dụng khách 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ị đã chỉ định. Điều này có thể hữu ích cho những tác vụ như nhập các mục nhập cũ từ mộ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ử Atom <updated> tiêu chuẩn để cho biết thời điểm thay đổi mục gần đây nhất. Khách hàng của bạn không thể kiểm soát giá trị <updated>; Blogger luôn đặt ngày cập nhật gần đây nhất của mục nhập thành thời gian máy chủ hiện tại bất cứ khi nào khách hàng của bạn đăng hoặc chỉnh sửa một mục nhập.
Bạn có thể sử dụng các tham số truy vấn published-min, published-max, updated-min và updated-max chuẩn của Google Data API để yêu cầu các mục nhập dựa trên giá trị <published> hoặc <updated> của chúng. Tuy nhiên, để biết lưu ý về việc truy vấn vào ngày cập nhật, hãy xem Tài liệu tham khảo về tham số truy vấn của Blogger.
Liên kết bình luận 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 giữa hai loại mục nhập này, Blogger sẽ sử dụng phần tử <atom:category>. Phần tử này sẽ có tham số term cho biết mục nhập là dành cho bài đăng hay nhận xét.
Hơn nữa, việc liên kết mục nhận xét với mục bài đăng chứa mục đó sẽ được thực hiện thông qua Tiện ích chuỗi Atom. Trong ví dụ bên dưới, phần tử <thr:in-reply-to> trong mục bình luận sẽ trỏ đến bài đăng bằng cách sử dụng giá trị nhận dạng của bài đăng trong tham số ref. Tệp này cũng liên kết đến URL HTML của bài đăng thông qua tham số 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>
Tài liệu tham khảo về giản đồ nguồn cấp dữ liệu của Blogger
- Nguồn cấp dữ liệu danh sách blog
- Nguồn cấp dữ liệu bài đăng trên blog
- Nguồn cấp dữ liệu bình luận trên blog
- Nguồn cấp dữ liệu bình luận về bài đăng trên blog