אחזור רשימה של פוסטים. רוצים לנסות? או לראות דוגמה
נדרשת הרשאה אם הפוסטים נמצאים בבלוג פרטי. אם הפוסטים נמצאים בבלוג שהוא ציבורי, אפשר לקרוא למתודה הזו בלי הרשאה.
בקשה
בקשת 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 |
סדר המיון שחל על התוצאות.
הערכים הקבילים הם:
|
sortOption |
string |
UNAVAILABLE NOW
כיוון המיון שמוחל על התוצאות. הערכים הקבילים הם:
|
pageToken |
string |
אסימון המשך אם הבקשה מחולקת לדפים. |
startDate |
datetime |
התאריך המוקדם ביותר של הפוסט שאותו רוצים לאחזר, בפורמט RFC 3339.date-time
|
status |
string |
הערכים הקבילים הם:
|
view |
string |
הערכים הקבילים הם:
|
גוף הבקשה
אין לספק גוף בקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה גוף תגובה עם המבנה הבא:
{
"kind": "blogger#postList",
"nextPageToken": string,
"items": [
posts Resource
]
}| שם הנכס | ערך | תיאור | הערות |
|---|---|---|---|
kind |
string |
סוג הישות. תמיד blogger#postList. |
|
nextPageToken |
string |
אסימון עימוד לאחזור הדף הבא, אם קיים כזה. | |
items[] |
list |
רשימת הפוסטים בבלוג הזה. |
דוגמאות
הערה: דוגמאות הקוד שזמינות ל-method לא מייצגות את כל שפות התכנות שיש בהן תמיכה. (לרשימת השפות הנתמכות בדף של ספריות הלקוח)
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 שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.