PostUserInfos: רשימה

נדרשת הרשאה

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

שליחת בקשה

בקשת HTTP

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

פרמטרים

שם הפרמטר ערך תיאור
פרמטרים נדרשים
blogId string מזהה הבלוג שממנו יש לאחזר פוסטים.
userId string המזהה של המשתמש שיש לאחזר את פרטיו לכל משתמש. את המילה 'self' (ללא סימני מירכאות) או את מזהה הפרופיל של המשתמש.
פרמטרים אופציונליים
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
  ]
}
שם הנכס ערך תיאור הערות
kind string סוג הישות הזו. תמיד blogger#postList
nextPageToken string אסימון עימוד לאחזור הדף הבא, אם קיים.
items[] list רשימת הפוסטים עם פרטי המשתמש של הפוסט, בבלוג הזה.

רוצה לנסות?

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