يبحث عن مشاركة تطابق عبارات طلب البحث المحدّدة. جرِّب الميزة الآن أو اطّلِع على مثال.
يجب الحصول على إذن إذا كانت المدوّنة التي يتم البحث فيها خاصة.
طلب
طلب HTTP
GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search
المعلمات
| اسم المعلَمة | القيمة | الوصف |
|---|---|---|
| المَعلمات المطلوبة | ||
blogId |
string |
معرّف المدونة المطلوب البحث فيها |
q |
string |
عبارات طلب البحث التي تريد البحث عنها |
| المَعلمات الاختيارية | ||
fetchBodies |
boolean |
تُستخدَم لتحديد ما إذا كان سيتم تضمين محتوى المشاركات. لتقليل عدد الزيارات، اضبط هذه المَعلمة على "false" عندما لا يكون محتوى نص المشاركة مطلوبًا.
(القيمة التلقائية: true)
|
orderBy |
string |
ترتيب الفرز المطبَّق على نتائج البحث
القيم المقبولة هي:
|
نص الطلب
لا تقدّم نص طلب مع هذه الطريقة.
الردّ
في حال نجاح العملية، يعرض هذا الإجراء نص استجابة بالبنية التالية:
{
"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());
}
}
جرِّبها الآن.
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب البيانات من خلال هذه الطريقة والاطّلاع على الردّ.