פוסטים: רשימה

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

אם הפוסטים פורסמו בבלוג פרטי, יש צורך בהרשאה. אם הפוסטים נמצאים בבלוג ציבורי, אפשר לקרוא לשיטה הזו ללא הרשאה.

שליחת בקשה

בקשת HTTP

GET https://www.googleapis.com/blogger/v3/blogs/blogId/posts

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים נדרשים
blogId string מזהה הבלוג שממנו יש לאחזר פוסטים.
פרמטרים אופציונליים
endDate datetime תאריך הפוסט האחרון לאחזור, date-time בפורמט RFC 3339.
fetchBodies boolean אם התוכן של הפוסטים כלול (ברירת המחדל: כן). צריך להגדיר את הערך הזה כ-false כשגופי הפוסטים אינם נדרשים, כדי למזער את התנועה. (ברירת מחדל: true)
fetchImages boolean מצוין אם מטא-נתונים של כתובות URL של תמונות כוללים כל פוסט.
labels string רשימת תוויות לחיפוש שמופרדות באמצעות פסיקים.
maxResults unsigned integer מספר הפוסטים המקסימלי שיש לאחזר.
orderBy string סדר המיון הוחל על התוצאות.

הערכים הקבילים הם:
  • "published": מיון לפי התאריך שבו הפוסט פורסם
  • "updated": הסדר לפי התאריך שבו הפוסט עודכן לאחרונה
sortOption string UNAVAILABLE NOW

מיון המיון הוחל על התוצאות.

הערכים הקבילים הם:
  • "descending": מיון פוסטים בסדר יורד בזמן (ברירת מחדל)
  • "ascending": מיון פוסטים בסדר עולה בזמן
pageToken string אסימון המשך אם הבקשה מופיעה בדף.
startDate datetime התאריך המוקדם ביותר לאחזור, date-time בפורמט RFC 3339.
status string

הערכים הקבילים הם:
  • "draft": טיוטות של פוסטים
  • "live": פוסטים שפורסמו
  • "scheduled": פוסטים שאמורים להתפרסם בעתיד.
view string

הערכים הקבילים הם:
  • "ADMIN": פרטים ברמת אדמין
  • "AUTHOR": פרטים ברמת המחבר
  • "READER": פרטים ברמת הקורא

גוף הבקשה

אין להזין גוף בקשה בשיטה זו.

תשובה

אם התגובה מוצלחת, שיטה זו תחזיר גוף תגובה בעל המבנה הבא:

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  "items": [
    posts Resource
  ]
}
שם הנכס ערך תיאור הערות
kind string סוג הישות הזו. תמיד blogger#postList.
nextPageToken string אסימון עימוד לאחזור הדף הבא, אם קיים.
items[] list רשימת הפוסטים של הבלוג הזה.

דוגמאות

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

Java

שימוש בספריית הלקוחות של Java

// The BlogId for the Blogger Buzz 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-PostsList-Snippet/1.0")
	.setHttpRequestInitializer(credential).build();

// The request action.
List postsListAction = blogger.posts().list(BUZZ_BLOG_ID);

// Restrict the result content to just the data we need.
postsListAction.setFields("items(author/displayName,content,published,title,url),nextPageToken");

// This step sends the request to the server.
PostList posts = postsListAction.execute();

// Now we can navigate the response.
int postCount = 0;
int pageCount = 0;
while (posts.getItems() != null && !posts.getItems().isEmpty()) {
	for (Post post : posts.getItems()) {
		System.out.println("Post #"+ ++postCount);
		System.out.println("\tTitle: "+post.getTitle());
		System.out.println("\tAuthor: "+post.getAuthor().getDisplayName());
		System.out.println("\tPublished: "+post.getPublished());
		System.out.println("\tURL: "+post.getUrl());
		System.out.println("\tContent: "+post.getContent());
	}

	// Pagination logic
	String pageToken = posts.getNextPageToken();
	if (pageToken == null || ++pageCount >= 5) {
		break;
	}
	System.out.println("-- Next page of posts");
	postsListAction.setPageToken(pageToken);
	posts = postsListAction.execute();
}

רוצה לנסות?

כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, צריך להשתמש ב-APIs Explorer בהמשך.