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

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

אם הבלוג שאתם מחפשים הוא פרטי, תידרש הרשאה.

בקשה

בקשת 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

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