Hướng dẫn dành cho nhà phát triển: Java

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 các ví dụ về các hoạt động tương tác cơ bản với API dữ liệu bằng thư viện ứng dụng Java. Nếu bạn muốn hiểu thêm về giao thức cơ bản mà thư viện sử dụng, hãy xem phần Giao thức trong hướng dẫn này dành cho nhà phát triển.

Nội dung

  1. Đối tượng người xem
  2. Bắt đầu
    1. Tạo tài khoản Blogger
    2. Chạy mã mẫu
  3. Xác thực với dịch vụ Blogger
    1. Xác thực OAuth
    2. Xác thực proxy AuthSub
    3. Xác thực tên người dùng/mật khẩu ClientLogin
  4. Truy xuất danh sách blog
  5. Tạo bài đăng
    1. Xuất bản bài đăng trên blog
    2. Tạo bài đăng nháp trên blog
  6. Truy xuất bài đăng
    1. Truy xuất tất cả bài đăng trên blog
    2. Truy xuất bài đăng bằng tham số truy vấn
  7. Cập nhật bài đăng
  8. Xóa bài đăng
  9. Nhận xét
    1. Tạo nhận xét
    2. Truy xuất bình luận
    3. Xóa bình luận

Đố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 Java có thể tương tác với Blogger.

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.

Để biết thông tin tham khảo về các lớp và phương thức do thư viện ứng dụng cung cấp, hãy xem tài liệu tham khảo về API thư viện ứng dụng Java. Để biết thông tin chung về tệp đối chiếu bằng API Dữ liệu, hãy xem Hướng dẫn tham khảo về giao thức.

Bắt đầu

Để được trợ giúp thiết lập thư viện ứng dụng, hãy xem Hướng dẫn bắt đầu sử dụng.

Thư viện ứng dụng Java yêu cầu Java 1.5. Sau khi tải thư viện ứng dụng xuống, bạn sẽ tìm thấy các lớp cần thiết để bắt đầu trong tệp java/lib/gdataclient-1.0.jar.

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.

Chạy mã mẫu

Một ứng dụng mẫu đang hoạt động đầy đủ, chứa tất cả mã mẫu hiển thị trong tài liệu này, có sẵn trong bản phân phối thư viện ứng dụng Java, trong thư mục gdata/java/sample/blogger/BloggerClient.java. Hướng dẫn tạo và thực thi được đưa vào cùng một thư mục trong tệp README.txt.

Ứng dụng mẫu thực hiện một số thao tác trên blog được cung cấp để minh hoạ việc sử dụng API Dữ liệu Blogger.

Để biên dịch các ví dụ trong tài liệu này thành mã của riêng bạn, bạn cần có các câu lệnh import sau:

import com.google.gdata.client.*;
import com.google.gdata.data.*;
import com.google.gdata.util.*;
import java.io.IOException;
import java.net.URL;

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ư. Tính năng này có thể xác thực bằng 1 trong 3 cách sau: Xác thực OAuth, 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 đã có đối tượng GoogleService đã xác thực.

Xác thực OAuth

Để xem tài liệu về việc xác thực OAuth bằng thư viện Java GData, vui lòng xem bài viết về OAuth trong Thư viện ứng dụng giao thức dữ liệu của Google.

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ọ. Thư viện ứng dụng Java cung cấp một hàm để tạo URL của trang Google. Mã dưới đây truy xuất URL của trang AuthSubRequest:

String next = "http://www.example.com/welcome.html";
String scope = "http://www.blogger.com/feeds/";
boolean secure = false;
boolean session = true;
String authSubLogin = AuthSubUtil.getRequestUrl(next, scope, secure, session);

Phương thức getRequestUrl nhận các thông số sau (tương ứng với các thông số truy vấn mà trình xử lý AuthSubRequest sử dụng):

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.

Ví dụ ở trên cho thấy một lệnh gọi không yêu cầu mã thông báo bảo mật (giá trị của secure là false). URL yêu cầu thu được 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, kể từ khi session = true được chỉ định, mã thông báo này có thể được trao đổi lấy mã thông báo phiên AuthSub bằng cách gọi dịch vụ AuthSubSessionToken như sau, trong đó urlFromAuthSub là URL mà AuthSub đã thêm mã thông báo vào:

String token = AuthSubUtil.getTokenFromReply(urlFromAuthSub);
String sessionToken = AuthSubUtil.exchangeForSessionToken(token, null);

Nghĩa là, bạn chuyển mã thông báo dùng một lần vào phương thức exchangeForSessionToken, cùng với null (đối với chế độ chưa đăng ký) hoặc khoá riêng tư (đối với chế độ đã đăng ký) và giao diện AuthSub sẽ trả về mã thông báo phiên. Để biết thêm thông tin về các ứng dụng và khoá riêng tư đã đăng ký, hãy xem mục "Yêu cầu ký" trong tài liệu về AuthSub.

Sau đó, ứng dụng có thể sử dụng mã thông báo phiên trong các lần tương tác tiếp theo với Blogger. Để yêu cầu thư viện ứng dụng Java tự động gửi mã thông báo phiên với mỗi yêu cầu, hãy gọi phương thức setAuthSubToken đối tượng GoogleService:

GoogleService.setAuthSubToken(sessionToken, null);

Sau đó, thư viện ứng dụng tự động gửi mã thông báo cùng với mỗi yêu cầu.

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). Bạn chỉ cần gọi phương thức setUserCredentials trên đối tượng GoogleService và tất cả các lượt tương tác tiếp theo với Blogger sẽ được xác thực:

GoogleService myService = new GoogleService("blogger", "exampleCo-exampleApp-1");
myService.setUserCredentials("user@example.com", "secretPassword");

Trong đoạn mã trên, chúng ta chuyển hai tham số vào hàm khởi tạo GoogleService. Thông số đầu tiên là tên của dịch vụ mà chúng ta muốn tương tác. Thông số thứ hai là tên của ứng dụng ở dạng companyName-applicationName-versionID.

Để 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;"

Mã mẫu sau đây sử dụng một đối tượng GoogleService đã xác thực để truy xuất siêu dữ liệu, sau đó in tiêu đề của từng blog.

public static void printUserBlogs(GoogleService myService)
    throws ServiceException, IOException {

  // Request the feed
  final URL feedUrl = new URL("http://www.blogger.com/feeds/default/blogs");
  Feed resultFeed = myService.getFeed(feedUrl, Feed.class);

  // Print the results
  System.out.println(resultFeed.getTitle().getPlainText());
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
  }
}

Hãy lưu ý URL được phương thức getFeed sử dụng. Đây là URL metafeed mặc định; URL này trả về danh sách các blog cho người dùng hiện đang được xác thực. Để truy cập vào nguồn cấp dữ liệu cho một người dùng khác, bạn có thể đặt mã nhận dạng của người dùng đó vào vị trí default trong URL nguồn cấp dữ liệu. Mã nhận dạng của người dùng là chuỗi chữ số ở cuối URL hồ sơ của người dùng.

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.

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.

Đăng bài trên blog

Bạn có thể sử dụng thư viện ứng dụng Java để xuất bản các mục nhập mới của blog.

Trước tiên, hãy tạo một đối tượng Entry để đại diện cho bài đăng trên blog. Sau đó, bạn có thể đặt tiêu đề, nội dung và các thuộc tính khác của bài đăng trên blog. Cuối cùng, hãy sử dụng đối tượng GoogleService để chèn bài đăng. Sau đây là ví dụ về cách xuất bản một bài đăng mới trên blog:

public static Entry createPost(
    GoogleService myService, String blogID, String title,
    String content, String userName)
    throws ServiceException, IOException {
  // Create the entry to insert
  Entry myEntry = new Entry();
  myEntry.setTitle(new PlainTextConstruct(title));
  myEntry.setContent(new PlainTextConstruct(content));

  // Ask the service to insert the new entry
  URL postUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  return myService.insert(postUrl, myEntry);
}

Phương thức insert lấy URL bài đăng của dịch vụ làm tham số. Sau đó, phương thức này sẽ trả về mục nhập do Blogger lưu trữ. Mục nhập được trả về chính là mục bạn đã gửi, nhưng cũng chứa nhiều thành phần khác do Blogger thêm vào, chẳng hạn như mã bài đăng.

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 bạn cần đặt thuộc tính draft của đối tượng Entry. Bạn có thể tạo một bài đăng trên blog giống như bài đăng ở trên bằng cách thêm dòng được làm nổi bật.

public static Entry createPost(GoogleService myService, String blogId,
    String title, String content, String userName,
    Boolean isDraft)
    throws ServiceException, IOException {
  // Create the entry to insert
  Entry myEntry = new Entry();
  myEntry.setTitle(new PlainTextConstruct(title));
  myEntry.setContent(new PlainTextConstruct(content));
  myEntry.setDraft(isDraft);

  // Ask the service to insert the new entry
  URL postUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  return myService.insert(postUrl, myEntry);
}

Bạn có thể chuyển bài đăng nháp hiện có trên blog thành một bài đăng đã xuất bản bằng cách truy xuất bài đăng nháp, đặt thuộc tính bản nháp thành false, sau đó cập nhật bài đăng đó. Chúng tôi sẽ đề cập đến việc truy xuất và cập nhật bài đăng trong hai phần tiếp theo.

Đ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 gọi phương thức setUserCredentials hoặc xác thực AuthSub trước khi truy xuất các bài đăng trên 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 cùng một phương thức getFeed dùng để truy xuất nguồn cấp dữ liệu blog của blog, nhưng lần này hãy gửi URL của nguồn cấp dữ liệu bài đăng trên blog:

public static void printAllPosts(
    GoogleService myService, String blogId)
    throws ServiceException, IOException {
  // Request the feed
  URL feedUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  Feed resultFeed = myService.getFeed(feedUrl, Feed.class);

  // Print the results
  System.out.println(resultFeed.getTitle().getPlainText());
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
  }
  System.out.println();
}

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ể. Để thực hiện việc này, bạn tạo một đối tượng Query và chuyển đối tượng đó đến phương thức GoogleService.getQuery.

Ví dụ: để gửi một truy vấn phạm vi ngày, hãy sử dụng phương thức setPublishedMin và setPublishedMax của đối tượng Query. Đoạn mã sau đây in tiêu đề của từng bài đăng trên blog được xuất bản giữa thời gian bắt đầu và thời gian kết thúc nhất định:

public static void printDateRangeQueryResults(
    GoogleService myService, String blogId,
    DateTime startTime, DateTime endTime)
    throws ServiceException, IOException {
  // Create query and submit a request
  URL feedUrl = new URL("http://www.blogger.com/feeds/" + blogID + "/posts/default");
  Query myQuery = new Query(feedUrl);
  myQuery.setPublishedMin(startTime);
  myQuery.setPublishedMax(endTime);
  Feed resultFeed = myService.query(myQuery, Feed.class);

  // Print the results
  System.out.println(resultFeed.getTitle().getPlainText() +
      " posts between " + startTime + " and " + endTime);
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" + entry.getTitle().getPlainText());
    System.out.println("\t" + entry.getUpdated().toStringRfc822());
  }
  System.out.println();
}

Lưu ý rằng đối tượng Query được xây dựng bằng cách sử dụng cùng một URL nguồn cấp dữ liệu bài đăng dùng để truy xuất bài đăng.

API Dữ liệu của Blogger hỗ trợ các phương thức Query sau:

addCategoryFilter
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/Laurie trả về các mục có cả nhãn Fritz và Laurie.
setMaxResults
Đặt số mục nhập tối đa để trả về.
setPublishMin, đã phát hành tối đa
Đặt giới hạn về ngày xuất bản bài viết.
setStartIndex
Đặt chỉ mục dựa trên 1 của kết quả đầu tiên được truy xuất (để phân trang).
setUpdatedMin, setUpdatedMax
Đặt ranh giới vào các 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ành updated.

Lưu ý: Hiện không có phương thức setter nào cho tham số truy vấn orderby. Tuy nhiên, bạn vẫn có thể sử dụng phương thức Query.addCustomParameter() nếu cần thiết lập.

Để 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 một bài đăng hiện có trên blog, trước tiên, bạn truy xuất mục mà bạn muốn cập nhật, sau đó sửa đổi bài đăng đó rồi gửi đến Blogger bằng phương thức update. Đoạn mã sau đây sẽ sửa đổi tiêu đề của một mục trên blog, giả sử bạn đã truy xuất mục đó từ máy chủ.

public static Entry updatePostTitle(
    GoogleService myService, Entry entryToUpdate, String newTitle)
    throws ServiceException, IOException {
  entryToUpdate.setTitle(new PlainTextConstruct(newTitle));
  URL editUrl = new URL(entryToUpdate.getEditLink().getHref());
  return myService.update(editUrl, entryToUpdate);
}

Mã trên trả về một Entry chứa toàn bộ bài đăng mới cập nhật. Để cập nhật các thuộc tính khác, bạn chỉ cần đặt các thuộc tính đó trong đối tượng Entry trước khi gọi update.

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ợ.

Đang xóa bài đăng

Để xoá bài đăng, hãy truyền URL chỉnh sửa của bài đăng đến phương thức delete trên đối tượng GoogleService, có dạng như sau:

public static void deletePost(
    GoogleService myService, String editLinkHref)
    throws ServiceException, IOException {
  URL deleteUrl = new URL(editLinkHref);
  myService.delete(deleteUrl);
}

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 bình luận, hãy tạo một đối tượng Entry và chèn đối tượng đó như sau:

public static Entry createComment(
    GoogleService myService, String blogID, String postId,
    String commentText)
    throws ServiceException, IOException {
  // Build the comment feed URI
  String commentsFeedUri = "http://www.blogger.com/feeds/" + blogID + "/" + postId + "/comments/default";
  URL feedUrl = new URL(commentsFeedUri);

  // Create a new entry for the comment and submit it to the GoogleService
  Entry myEntry = new Entry();
  myEntry.setContent(new PlainTextConstruct(commentText));
  return myService.insert(feedUrl, myEntry);
}

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 nhận xét cho bài đăng cụ thể từ URL của nguồn cấp dữ liệu bình luận về bài đăng đó:

public static void printAllComments(
    GoogleService myService, String blogID, String postId)
    throws ServiceException, IOException {
  // Build comment feed URI and request comments on the specified post
  String commentsFeedUri = "http://www.blogger.com/feeds/" + blogID + "/" + postId + "/comments/default";
  URL feedUrl = new URL(commentsFeedUri);
  Feed resultFeed = myService.getFeed(feedUrl, Feed.class);

  // Display the results
  System.out.println(resultFeed.getTitle().getPlainText());
  for (int i = 0; i < resultFeed.getEntries().size(); i++) {
    Entry entry = resultFeed.getEntries().get(i);
    System.out.println("\t" +
        ((TextContent) entry.getContent()).getContent().getPlainText());
    System.out.println("\t" + entry.getUpdated().toStringRfc822());
  }
  System.out.println();
}

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:

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

Đang xoá nhận xét

Để xoá một nhận xét, hãy chuyển URL chỉnh sửa của nhận xét đó vào phương thức delete trên đối tượng GoogleService như sau:

public static void deleteComment(GoogleService myService, String editLinkHref)
    throws ServiceException, IOException {
  URL deleteUrl = new URL(editLinkHref);
  myService.delete(deleteUrl);
}

Quay lại đầu trang