מחפשת פוסט שתואם למונחי השאילתה הנתונה. אפשר לנסות עכשיו או לראות דוגמה.
אתם צריכים לקבל הרשאה אם הבלוג שאתם מחפשים הוא פרטי.
שליחת בקשה
בקשת 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
שימוש בספריית הלקוחות של 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());
}
}
רוצה לנסות?
כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, צריך להשתמש ב-APIs Explorer בהמשך.