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

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

يجب الحصول على إذن إذا كانت المدوّنة التي يتم البحث فيها خاصة.

طلب

طلب 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());
}
}

جرِّبها الآن.

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