Menelusuri postingan yang cocok dengan istilah kueri yang diberikan. Coba sekarang atau lihat contohnya.
Otorisasi akan diperlukan jika blog yang ditelusuri bersifat pribadi.
Permintaan
Permintaan HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter yang diperlukan | ||
blogId |
string |
ID blog yang akan ditelusuri. |
q |
string |
Istilah kueri yang akan ditelusuri. |
Parameter opsional | ||
fetchBodies |
boolean |
Apakah konten isi postingan disertakan. Untuk meminimalkan traffic, tetapkan parameter ini ke false jika konten isi postingan tidak diperlukan.
(Default: true )
|
orderBy |
string |
Tata urutan yang diterapkan ke hasil penelusuran.
Nilai yang dapat diterima:
|
Isi permintaan
Jangan berikan isi permintaan dengan metode ini.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{ "kind": "blogger#postList", "nextPageToken": string, "items": [ posts Resource ] }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
kind |
string |
Jenis entity ini. Selalu blogger#postList |
|
nextPageToken |
string |
Token penomoran halaman untuk mengambil halaman berikutnya, jika ada. | |
items[] |
list |
Daftar Postingan untuk Blog ini. |
Contoh
Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).
Java
Menggunakan library klien 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());
}
}
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.