Yayınlar: arama

Belirtilen sorgu terimleriyle eşleşen bir yayını arar. Hemen deneyin veya örneğe göz atın.

Aranan blog özel ise yetkilendirme gerekir.

İstek

HTTP isteği

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

Parametreler

Parametre adı Değer Açıklama
Gerekli parametreler
blogId string Arama yapılacak blogun kimliği.
q string Aranacak sorgu terimleri.
İsteğe bağlı parametreler
fetchBodies boolean Yayınların gövde içeriğinin dahil edilip edilmediği Trafiği en aza indirmek için bu parametreyi, gönderinin gövde içeriği gerekli olmadığında false olarak ayarlayın. (Varsayılan: true)
orderBy string Arama sonuçlarına uygulanan sıralama düzeni.

Kabul edilen değerler şunlardır:
  • "published": Gönderinin yayınlandığı tarihe göre sıralama
  • "updated": Gönderinin son güncellenme tarihine göre sıralama

İstek metni

Bu yöntemle istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
Mülk adı Değer Açıklama Notlar
kind string Bu öğenin türü. Her zaman blogger#postList
nextPageToken string Varsa sonraki sayfayı getirmek için kullanılan sayfalama jetonu.
items[] list Bu blogdaki yayınların listesi.

Örnekler

Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).

Java

Java istemci kitaplığını kullanır.

// 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());
	}
}

Deneyin.

Bu yöntemi canlı verilerde çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.