PostUserInfos: רשימה

נדרשת הרשאה

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

בקשה

בקשת HTTP

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

פרמטרים

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

הערכים הקבילים הם:
  • "published": סידור לפי תאריך הפרסום של הפוסט
  • "updated": הזמנה לפי התאריך שבו הפוסט עודכן לאחרונה
pageToken string אסימון ההמשך, המשמש לדפדוף בין קבוצות גדולות של תוצאות. כדי לקבל את דף התוצאות הבא, צריך להגדיר את הפרמטר הזה לערך של "nextPageToken" מהתגובה הקודמת.
startDate datetime תאריך הפרסום המוקדם ביותר לאחזור, תאריך ושעה בפורמט RFC 3339.
status string

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

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

אישור

הבקשה הזו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/blogger
https://www.googleapis.com/auth/blogger.readonly

גוף הבקשה

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

תשובה

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

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

רוצה לנסות?

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