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

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

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

الطلب

طلب HTTP

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

المعلمات

اسم المعلَمة القيمة الوصف
المَعلمات المطلوبة
blogId string رقم تعريف المدونة المطلوب البحث فيها.
q string عبارات طلب البحث المطلوب البحث عنها
المَعلمات الاختيارية
fetchBodies boolean ما إذا تم تضمين محتوى النص الأساسي للمشاركات. ولتقليل عدد الزيارات، يمكنك ضبط هذه المعلمة على "خطأ" عندما لا يكون محتوى نص المنشور مطلوبًا. (القيمة التلقائية: true)
orderBy string تمثّل هذه السمة نظام الترتيب المطبَّق على نتائج البحث.

في ما يلي القيم المقبولة:
  • "published": الترتيب حسب تاريخ نشر المشاركة
  • "updated": الترتيب حسب تاريخ آخر تعديل للمشاركة

نص الطلب

لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.

الإجابة

في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
اسم الموقع القيمة الوصف Notes
kind string نوع هذا الكيان. دائمًا blogger#postList
nextPageToken string الرمز المميّز للتقسيم على صفحات لجلب الصفحة التالية، إن توفّر.
items[] list قائمة المشاركات لهذه المدونة.

أمثلة

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

Java

لاستخدام مكتبة برامج 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());
}
}

تجربة

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