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

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

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

בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים נדרשים
blogId string מזהה הבלוג שממנו רוצים לאחזר את הפוסטים.
פרמטרים אופציונליים
endDate datetime תאריך הפוסט האחרון לאחזור, date-time בפורמט RFC 3339.
fetchBodies boolean האם התוכן של הפוסטים נכלל בתוכן (ברירת המחדל: true). יש להגדיר את הערך כ-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 שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.