المشاركات: بحث

يبحث عن مشاركة تطابق عبارات طلب البحث المحددة. جرِّب الآن أو شاهد مثالاً.

يكون التفويض مطلوبًا إذا كانت المدونة التي يتم البحث فيها خاصة.

طلب

طلب 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	قائمة مشاركات هذه المدونة

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

لغة 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());
	}
}

جرِّب هذه الميزة الآن.

استخدم مستكشف واجهات برمجة التطبيقات أدناه لاستدعاء هذه الطريقة في البيانات المباشرة والاطلاع على الاستجابة.