Truy xuất danh sách bài đăng. Thử ngay hoặc xem ví dụ.
Bạn 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ì bạn có thể gọi phương thức này mà không cần uỷ quyền.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts
Thông số
| Tên thông số | Giá trị | Mô tả |
|---|---|---|
| Tham số bắt buộc | ||
blogId |
string |
Mã nhận dạng của blog cần tìm nạp bài đăng. |
| Tham số không bắt buộc | ||
endDate |
datetime |
Ngày đăng bài mới nhất để tìm nạp, một date-time có định dạng RFC 3339.
|
fetchBodies |
boolean |
Có bao gồm nội dung bài đăng 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 |
Có bao gồm siêu dữ liệu URL hình ảnh cho từng bài đăng hay không. |
labels |
string |
Danh sách nhãn được phân tách bằng dấu phẩy để 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 được áp dụng cho kết quả.
Các giá trị được chấp nhận là:
|
sortOption |
string |
UNAVAILABLE NOW
Hướng sắp xếp được áp dụng cho kết quả. Các giá trị được chấp nhận là:
|
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 để tìm nạp, date-time có định dạng RFC 3339.
|
status |
string |
Các giá trị được chấp nhận là:
|
view |
string |
Các giá trị được chấp nhận là:
|
Nội dung yêu cầu
Khô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ề một phần nội dung phản hồi có cấu trúc sau:
{
"kind": "blogger#postList",
"nextPageToken": string,
"items": [
posts Resource
]
}| Tên tài sản | Giá trị | Mô tả | Ghi chú |
|---|---|---|---|
kind |
string |
Loại thực thể này. Luôn 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 hiện có 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ề thư viện ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).
Java
Sử 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 Trình khám phá API bên dưới để gọi phương thức này trên dữ liệu thực và xem phản hồi.