Nhận xét: danh sách

Truy xuất danh sách bình luận cho một bài đăng. Thử ngay hoặc xem ví dụ.

Bạn cần uỷ quyền nếu nhận xét nằm trên một blog riêng tư. Nếu nhận xét 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/postId/comments

Tham số

Tên thông số Giá trị Nội dung mô tả
Tham số bắt buộc
blogId string Mã nhận dạng của blog để tìm nạp bình luận.
postId string Mã của bài đăng cần tìm nạp bình luận.
Tham số không bắt buộc
endDate datetime Ngày nhận xét mới nhất cần tìm nạp, là ngày giờ có định dạng RFC 3339.
fetchBodies boolean Việc có bao gồm nội dung nội dung của nhận xét hay không.
maxResults unsigned integer Số lượng nhận xét tối đa được đưa vào kết quả.
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 nhận xét sớm nhất cần tìm nạp, ngày-giờ có định dạng RFC 3339.
status string

Các giá trị được chấp nhận là:
  • "emptied": Những bình luận đã bị xoá nội dung
  • "live": Những bình luận hiển thị công khai
  • "pending": Nhận xét đang chờ quản trị viên phê duyệt
  • "spam": Những bình luận bị quản trị viên đánh dấu là vi phạm
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 quản trị viên

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#commentList",
  "nextPageToken": string,
  "prevPageToken": string,
  "items": [
    comments Resource
  ]
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
kind string Loại mục này. Luôn là blogger#commentList.
nextPageToken string Mã thông báo phân trang để tìm nạp trang tiếp theo (nếu có).
prevPageToken string Mã thông báo phân trang để tìm nạp trang trước (nếu có).
items[] list Danh sách các tài nguyên bình luận cho bài đăng được chỉ định.

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 http://buzz.blogger.com/ blog.
String BUZZ_BLOG_ID = "2399953";

// The PostId for a buzz post with comments.
String BUZZ_POST_ID = "5310628572012276714";

// 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-CommentsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List commentsListAction = blogger.comments().list(BUZZ_BLOG_ID, BUZZ_POST_ID);

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

// This step sends the request to the server.
CommentList comments = commentsListAction.execute();

// Now we can navigate the response.
while(comments.getItems() != null && !comments.getItems().isEmpty()){
	for(Comment comment : comments.getItems()) {
		System.out.println(comment.getAuthor().getDisplayName()+": "+comment.getContent());
	}

	// Pagination logic
	String pageToken = comments.getNextPageToken();
	if(pageToken == null) {
		break;
	}
	System.out.println("-- Next page of comments");
	commentsListAction.setPageToken(pageToken);
	comments = commentsListAction.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.