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

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

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

בקשה

בקשת 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 התאריך המוקדם ביותר של הפוסט שאותו רוצים לאחזר, בפורמט RFC 3339.date-time
status string

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

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

גוף הבקשה

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

תשובה

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

{
  "kind": "blogger#postList",
  "nextPageToken": string,
  &quo}t;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 = "23999
53"
; // Configure the Java API Client for Installed
Native AppHttpTransport HTTP_TRANSPORT = new NetHttpTr
ansport();JsonFactory JSON_FACTORY = new Jackson
Factory();
// Configure the Installed App OA
uth2 flow.Credential credential = OAuth2Native.authorize(HTTP_
TRANSPORT, JSON_FACTORY, new LocalServerR
eceiver(), Arrays.asList(BloggerScopes.
BLOGGER));
// Construct the Blogger API access faca
de object.Blogger blogger = Blogger.builder(HTTP_TRANSPORT, JSO
N_FACTORY) .setApplicationName("Blogger-PostsLis
t-Snippet/1.0") .setHttpRequestInitializer(
credential).build();
//
The request action.List postsListAction = blogger.posts()
.list(BUZZ_BLOG_ID);
// Restrict the result content to ju
st the data we need.postsListAction.setFields("items(author/displayName,content,published,ti
tle,url),nextPageToken");
// This step se
nds the request to the server.PostList post
s = postsListAction.execute();
// Now
we can navigate t
he response.int po
stCount = 0;int pageCount = 0;wh&&ile (posts.getItems() != null {
!posts.getItems().isEmpty()) for ({
Post post : posts.getItems()) System.out.p
rintln("Post #"+ ++postCount); System.o
ut.println("\tTitle: "+post.getTitle()); System.out.printl
n("\tAuthor: "+post.getAuthor().getDisplayName()
); System.out.println("\tPublished: &quo
t;+post.getPublished()); System.out.println("\tU
R}
L: "+post.getUrl
()); System.out.println("\tContent: &qu
ot;+post.getContent());
// Paginatio>n log{
ic Strin
g}
pageToken = posts.getNextPageToken(); if (pa
geToken == null || ++pageCount = 5) bre
ak; System.out.println("-- Ne
}xt page of posts"); postsListAction.setPageToken(pageToken); posts = postsListAction.execute();

רוצה לנסות?

אפשר להשתמש בכלי APIs Explorer שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.