Tìm kiếm một bài đăng khớp với các cụm từ tìm kiếm đã cho. Thử ngay hoặc xem ví dụ.
Bạn sẽ cần uỷ quyền nếu blog đang được tìm kiếm ở chế độ riêng tư.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search
Tham số
Tên thông số | Giá trị | Mô tả |
---|---|---|
Tham số bắt buộc | ||
blogId |
string |
Mã của blog cần tìm kiếm. |
q |
string |
Cụm từ truy vấn để tìm kiếm. |
Tham số không bắt buộc | ||
fetchBodies |
boolean |
Liệu có bao gồm nội dung của bài đăng hay không. Để giảm thiểu lưu lượng truy cập, hãy đặt thông số này thành false khi không bắt buộc phải có nội dung của bài đăng.
(Mặc định: true )
|
orderBy |
string |
Thứ tự sắp xếp được áp dụng cho các kết quả tìm kiếm.
Các giá trị được chấp nhận là:
|
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ị | 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
// The BlogId for the http://buzz.blogger.com/ 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-PostsSearch-Snippet/1.0")
.setHttpRequestInitializer(credential).build();
// The request action.
Search postsSearchAction = blogger.posts().search(BUZZ_BLOG_ID);
postsSearchAction.setQ("threaded comments");
// Restrict the result content to just the data we need.
postsSearchAction.setFields("items(content,published,title,url)");
// This step sends the request to the server.
PostList posts = postsSearchAction.execute();
// Now we can navigate the response.
if (posts.getItems() != null && !posts.getItems().isEmpty()) {
for (Post post : posts.getItems()) {
System.out.println("Title: " + post.getTitle());
System.out.println("Published: " + post.getPublished());
System.out.println("URL: " + post.getUrl());
System.out.println("Content: " + post.getContent());
}
}
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.