פוסטים: חיפוש

מחפש פוסט שתואם למונחי השאילתה שצוינו. רוצים לנסות? או לראות דוגמה?

אם הבלוג שאתם מחפשים הוא פרטי, תצטרכו להיכנס לחשבון.

בקשה

בקשת 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	רשימת הפוסטים בבלוג הזה.

דוגמאות

הערה: דוגמאות הקוד שזמינות ל-method לא מייצגות את כל שפות התכנות שיש בהן תמיכה. (לרשימת השפות הנתמכות בדף של ספריות הלקוח)

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 שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.