Bài đăng: tìm kiếm

Số lượt tìm kiếm bài đăng khớp với các cụm từ tìm kiếm đã cho. Thử ngay hoặc xem ví dụ.

Yêu cầu cấp quyền sẽ cần thiết nếu blog đượ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

Các tham số

Tên thông số Giá trị Mô tả
Các thông số bắt buộc
blogId string Mã của blog cần tìm kiếm.
q string Cụm từ tìm kiếm để tìm.
Tham số không bắt buộc
fetchBodies boolean Liệu nội dung nội dung của bài đăng có được đưa vào 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 nội dung nội dung của bài đăng không bắt buộc. (Mặc định: true)
orderBy string Thứ tự sắp xếp áp dụng cho các kết quả tìm kiếm.

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

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 với 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 của thực thể này. Luôn luôn blogger#postList
nextPageToken string Mã phân trang để tìm nạp trang tiếp theo (nếu có).
items[] list Danh sách các bài đăng dành cho 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

Sử dụng thư viện ứng dụng 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 dùng API Explorer 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.