پست ها: جستجو

پستی را جستجو می کند که با عبارات پرس و جوی داده شده مطابقت داشته باشد. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

اگر وبلاگ مورد جستجو خصوصی باشد، مجوز لازم است.

درخواست کنید

درخواست HTTP

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

پارامترها

نام پارامتر	ارزش	توضیحات
پارامترهای مورد نیاز
blogId	string	شناسه وبلاگ برای جستجو
q	string	عبارات را برای جستجو جستجو کنید.
پارامترهای اختیاری
fetchBodies	boolean	آیا محتوای بدنه پست‌ها گنجانده شده است. برای به حداقل رساندن ترافیک، زمانی که محتوای متنی پست مورد نیاز نیست، این پارامتر را روی false تنظیم کنید. (پیش‌فرض: true )
orderBy	string	ترتیب مرتب سازی برای نتایج جستجو اعمال شد. مقادیر قابل قبول عبارتند از: " published ": ترتیب بر اساس تاریخ انتشار پست " updated ": بر اساس تاریخ آخرین به روز رسانی پست سفارش دهید

درخواست بدن

با این روش بدنه درخواستی ارائه نکنید.

پاسخ

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}

نام ملک	ارزش	توضیحات	یادداشت ها
kind	string	نوع این موجودیت. همیشه blogger#postList
nextPageToken	string	نشانه صفحه‌بندی برای واکشی صفحه بعدی، در صورت وجود.
items[]	list	لیست پست های این وبلاگ

نمونه ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه کلاینت جاوا استفاده می کند

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

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.