Bài đăng: danh sách

Truy xuất danh sách bài đăng. Thử ngay hoặc xem ví dụ.

Cần phải uỷ quyền nếu bài đăng nằm trên một blog riêng tư. Nếu các bài đăng nằm trên một blog công khai, thì phương thức này có thể được gọi mà không cần được uỷ quyền.

Yêu cầu

Yêu cầu HTTP

GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts

Tham số

Tên thông số Giá trị Nội dung mô tả
Tham số bắt buộc
blogId string Mã của blog để tìm nạp bài đăng.
Tham số không bắt buộc
endDate datetime Ngày đăng gần đây nhất cần tìm nạp, date-time có định dạng RFC 3339.
fetchBodies boolean Liệu có đưa nội dung nội dung của bài đăng vào hay không (mặc định: true). Bạn nên đặt giá trị này thành false khi không bắt buộc phải có nội dung bài đăng để giảm thiểu lưu lượng truy cập. (Mặc định: true)
fetchImages boolean Liệu có bao gồm siêu dữ liệu URL hình ảnh cho mỗi bài đăng hay không.
labels string Danh sách nhãn được phân tách bằng dấu phẩy cần tìm kiếm.
maxResults unsigned integer Số lượng bài đăng tối đa cần tìm nạp.
orderBy string Thứ tự sắp xếp áp dụng cho các kết quả.

Các giá trị được chấp nhận là:
  • "published": Sắp xếp theo ngày xuất bản bài đăng
  • "updated": Sắp xếp theo ngày cập nhật bài đăng gần đây nhất
sortOption string UNAVAILABLE NOW

Hướng sắp xếp áp dụng cho kết quả.

Các giá trị được chấp nhận là:
  • "descending": Sắp xếp bài đăng theo thứ tự thời gian giảm dần (mặc định)
  • "ascending": Sắp xếp bài đăng theo thứ tự tăng dần theo thời gian
pageToken string Mã thông báo tiếp tục nếu yêu cầu được phân trang.
startDate datetime Ngày đăng sớm nhất cần tìm nạp, date-time có định dạng RFC 3339.
status string

Các giá trị được chấp nhận là:
  • "draft": Bài đăng nháp
  • "live": Bài đăng đã xuất bản
  • "scheduled": Bài đăng được lên lịch xuất bản trong tương lai.
view string

Các giá trị được chấp nhận là:
  • "ADMIN": Thông tin chi tiết về cấp quản trị viên
  • "AUTHOR": Thông tin chi tiết về cấp tác giả
  • "READER": Thông tin chi tiết về cấp độ độc giả

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
kind string Loại thực thể này. Luôn là blogger#postList.
nextPageToken string Mã thông báo phân trang để tìm nạp trang tiếp theo (nếu có).
items[] list Danh sách bài đăng của blog này.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Dùng thư viện ứng dụng Java

// The BlogId for the Blogger Buzz blog
String BUZZ_BLOG_ID = "2399953";

// Configure the Java API Client for Installed Native App
HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
JsonFactory JSON_FACTORY = new JacksonFactory();

// Configure the Installed App OAuth2 flow.
Credential credential = OAuth2Native.authorize(HTTP_TRANSPORT,
	JSON_FACTORY, new LocalServerReceiver(),
	Arrays.asList(BloggerScopes.BLOGGER));

// Construct the Blogger API access facade object.
Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)
	.setApplicationName("Blogger-PostsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);

// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");

// This step sends the request to the server.
PostList posts = postsListAction.execute();

// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
	for (Post post : posts.getItems()) {
		System.out.println("Post #"+ ++postCount);
		System.out.println("\tTitle: "+post.getTitle());
		System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
		System.out.println("\tPublished: "+post.getPublished());
		System.out.println("\tURL: "+post.getUrl());
		System.out.println("\tContent: "+post.getContent());
	}

	// Pagination logic
	String pageToken = posts.getNextPageToken();
	if (pageToken == null || ++pageCount >= 5) {
		break;
	}
	System.out.println("-- Next page of posts");
	postsListAction.setPageToken(pageToken);
	posts = postsListAction.execute();
}

Hãy dùng thử!

Hãy sử dụng APIs Explorer (Trình khám phá API) bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.