المشاركات: بحث
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يبحث هذا المعامل عن مشاركة تتطابق مع عبارات طلب البحث المحدّدة.
جرِّب الخدمة الآن أو اطّلِع على مثال.
سيكون التفويض مطلوبًا إذا كانت المدونة التي يتم البحث عنها خاصة.
الطلب
طلب 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
]
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
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());
}
}
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eSearches blog posts matching specified query terms within a given blog.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization for private blogs and allows customization of search results through optional parameters like \u003ccode\u003efetchBodies\u003c/code\u003e and \u003ccode\u003eorderBy\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of posts with metadata, including title, URL, and content (if requested), alongside pagination information.\u003c/p\u003e\n"],["\u003cp\u003eProvides code examples for utilizing this functionality with the Java client library.\u003c/p\u003e\n"],["\u003cp\u003eOffers an interactive API explorer to test the method with live data.\u003c/p\u003e\n"]]],[],null,["# Posts: search\n\nSearches for a post that matches the given query terms.\n[Try it now](#try-it) or [see an example](#examples).\n\n[Authorization](/blogger/docs/3.0/using#auth) will be required if the blog being searched is private.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/blogger/v3/blogs/blogId/posts/search\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Required parameters** |||\n| `blogId` | `string` | The ID of the blog to search in. |\n| `q` | `string` | Query terms to search for. |\n| **Optional parameters** |||\n| `fetchBodies` | `boolean` | Whether the body content of posts is included. To minimize traffic, set this parameter to false when the post's body content is not required. (Default: `true`) |\n| `orderBy` | `string` | The sort order applied to the search results. \u003cbr /\u003e \u003cbr /\u003e Acceptable values are: - \"`published`\": Order by the date the post was published - \"`updated`\": Order by the date the post was last updated |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"kind\": \"blogger#postList\",\n \"nextPageToken\": string,\n \"items\": [\n posts Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-----------------|----------|---------------------------------------------------------|-------|\n| `kind` | `string` | The kind of this entity. Always `blogger#postList` | |\n| `nextPageToken` | `string` | Pagination token to fetch the next page, if one exists. | |\n| `items[]` | `list` | The list of Posts for this Blog. | |\n\nExamples\n--------\n\n**Note:** The code examples available for this method do not represent all supported programming languages (see the [client libraries page](/blogger/docs/3.0/libraries) for a list of supported languages). \n\n### Java\n\nUses the [Java client library](http://code.google.com/p/google-api-java-client/) \n\n```java\n// The BlogId for the http://buzz.blogger.com/ blog.\nString BUZZ_BLOG_ID = \"2399953\";\n\n// Configure the Java API Client for Installed Native App\nHttpTransport HTTP_TRANSPORT = new NetHttpTransport();\nJsonFactory JSON_FACTORY = new JacksonFactory();\n\n// Configure the Installed App OAuth2 flow.\nCredential credential = OAuth2Native.authorize(HTTP_TRANSPORT,\n\tJSON_FACTORY, new LocalServerReceiver(),\n\tArrays.asList(BloggerScopes.BLOGGER));\n\n// Construct the Blogger API access facade object.\nBlogger blogger = Blogger.builder(HTTP_TRANSPORT, JSON_FACTORY)\n\t.setApplicationName(\"Blogger-PostsSearch-Snippet/1.0\")\n\t.setHttpRequestInitializer(credential).build();\n\n// The request action.\nSearch postsSearchAction = blogger.posts().search(BUZZ_BLOG_ID);\npostsSearchAction.setQ(\"threaded comments\");\n\n// Restrict the result content to just the data we need.\npostsSearchAction.setFields(\"items(content,published,title,url)\");\n\n// This step sends the request to the server.\nPostList posts = postsSearchAction.execute();\n\n// Now we can navigate the response.\nif (posts.getItems() != null && !posts.getItems().isEmpty()) {\n\tfor (Post post : posts.getItems()) {\n\t\tSystem.out.println(\"Title: \" + post.getTitle());\n\t\tSystem.out.println(\"Published: \" + post.getPublished());\n\t\tSystem.out.println(\"URL: \" + post.getUrl());\n\t\tSystem.out.println(\"Content: \" + post.getContent());\n\t}\n}\n```\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]