Posty: wyszukiwanie

Wyszukuje posta, który pasuje do podanych haseł. Wypróbuj lub zobacz przykład.

Jeśli przeszukiwany blog jest prywatny, będzie wymagana autoryzacja.

Żądanie

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis
Parametry wymagane
blogId string Identyfikator bloga na potrzeby wyszukiwania.
q string Zapytania dotyczące wyszukiwanych haseł.
Parametry opcjonalne
fetchBodies boolean Określa, czy dołączana jest treść postów. Aby zminimalizować ruch, ustaw ten parametr na wartość „false”, jeśli treść posta nie jest wymagana. (Domyślnie: true)
orderBy string Kolejność sortowania wyników wyszukiwania.

Akceptowane wartości to:
  • „published”: sortowanie według daty opublikowania posta
  • „updated”: sortowanie według daty ostatniej aktualizacji posta

Treść żądania

Nie podawaj treści żądania przy użyciu tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Nazwa usługi Wartość Opis Uwagi
kind string Rodzaj tego elementu. Zawsze blogger#postList
nextPageToken string Token podziału na strony pozwalający pobrać następną stronę, jeśli taka istnieje.
items[] list Lista postów dla tego bloga.

Przykłady

Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.

Java

korzysta z biblioteki klienta 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());
	}
}

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.